From 1d9b2e0e156f9a58bd642b9f9e8b2a08e768f5ed Mon Sep 17 00:00:00 2001 From: Fritz Elfert Date: Wed, 20 Mar 2002 02:18:51 +0000 Subject: - rpcs: Implemented scratch RAM access. - Updated spec file (not complete) - Updated KDE translations - kioslave and property-dialog now translate correctly - ppsocket: Added a patch for FreeBSD - plpftp: Some experimental code for testing --- lib/rpcs.h | 98 +++++++++++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 85 insertions(+), 13 deletions(-) (limited to 'lib/rpcs.h') diff --git a/lib/rpcs.h b/lib/rpcs.h index 9c77656..2cb276a 100644 --- a/lib/rpcs.h +++ b/lib/rpcs.h @@ -350,22 +350,72 @@ public: * machines, returns always an error code E_PSI_NOT_SIBO. * * @param machineInfo The struct holding all information on return. - * @return Psion error code. 0 = Ok. + * + * @returns Psion error code. 0 = Ok. */ virtual Enum getMachineInfo(machineInfo &) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum closeHandle(int) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum regOpenIter(u_int32_t, char *, u_int16_t &) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum regReadIter(u_int16_t) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum regWrite(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum regRead(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum regDelete(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum setTime(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum configOpen(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum configRead(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum configWrite(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum queryOpen(void) { return rfsv::E_PSI_NOT_SIBO;} - virtual Enum queryRead(void) { return rfsv::E_PSI_NOT_SIBO;} + /** + * Release an rpcs handle. + * + * This function works with EPOC only. Using it with SIBO + * machines, returns always an error code E_PSI_NOT_SIBO. + * It releases a handle, obtained by a previous call to + * @ref rpcs::configOpen . + * + * @param handle The handle to close. + * + * @returns A psion error code. 0 = Ok. + */ + virtual Enum closeHandle(u_int32_t handle) + { return rfsv::E_PSI_NOT_SIBO; } + + virtual Enum regOpenIter(u_int32_t, char *, u_int16_t &) + { return rfsv::E_PSI_NOT_SIBO;} + virtual Enum regReadIter(u_int16_t) + { return rfsv::E_PSI_NOT_SIBO;} + virtual Enum regWrite(void) + { return rfsv::E_PSI_NOT_SIBO;} + virtual Enum regRead(void) + { return rfsv::E_PSI_NOT_SIBO;} + virtual Enum regDelete(void) + { return rfsv::E_PSI_NOT_SIBO;} + virtual Enum setTime(void) + { return rfsv::E_PSI_NOT_SIBO;} + + /** + * Read from Series 5 scratch RAM + * + * This function works with EPOC only. Using it with SIBO + * machines, returns always an error code E_PSI_NOT_SIBO. + * It reads raw data from the scatch RAM of the Series 5. + * + * @param size The amount of data to me read. + * @param data The content of the scratch RAM is returned here. + * + * @returns A psion error code. 0 = Ok. + */ + virtual Enum configRead(u_int32_t size, bufferStore &data) + { return rfsv::E_PSI_NOT_SIBO; } + + /** + * Write to Series 5 scratch RAM + * + * This function works with EPOC only. Using it with SIBO + * machines, returns always an error code E_PSI_NOT_SIBO. + * It writes raw data to the scatch RAM of the Series 5. + * + * @param data The data to be written to the scratch RAM. + * + * @returns A psion error code. 0 = Ok. + */ + virtual Enum configWrite(bufferStore data) + { return rfsv::E_PSI_NOT_SIBO;} + + virtual Enum queryOpen(void) + { return rfsv::E_PSI_NOT_SIBO;} + virtual Enum queryRead(void) + { return rfsv::E_PSI_NOT_SIBO;} protected: /** @@ -396,6 +446,7 @@ protected: GET_CMDLINE = 0x0a, FUSER = 0x0b, GET_MACHINE_INFO = 0x64, + CLOSE_HANDLE = 0x65, REG_OPEN_ITER = 0x66, REG_READ_ITER = 0x67, REG_WRITE = 0x68, @@ -416,6 +467,27 @@ protected: */ int mtCacheS5mx; + /** + * Prepare scratch RAM in Series 5 for read/write + * + * This function works with EPOC only. Using it with SIBO + * machines, returns always an error code E_PSI_NOT_SIBO. + * It prepares a scratch area on the EPOC machine for a following + * use from within @ref rpcs::configRead or @ref rpcs::configWrite . + * These functions call @ref rpcs::closeHandle on exit. The contents + * of the scratch area is stored in RAM of the Series 5, therefore it + * gets lost when the Series 5 is switched off. + * + * @param handle The handle to be used in @ref rpcs::configRead , + * @ref rpcs::configWrite and @ref rpcs::closeHandle is + * returned here. + * @param size The number of bytes you want to use. + * + * @returns A psion error code. 0 = Ok. + */ + virtual Enum configOpen(u_int16_t &handle, u_int32_t size) + { return rfsv::E_PSI_NOT_SIBO; } + /** * Sends a command to the remote side. * -- cgit v1.2.3