Input/Output. The purpose of writing internal codes for Senselock ELis to deliver functional service to the software running on the computer so as to protect the software. The communication between them is achieved via ―communication buffer‖, which is a special memory area in the hardware of SenseLock EL. The data, sent from the computer to Senselock ELor from Senselock ELto the computer, will all be saved in the communication buffer. Two macros are defined in ses_v3.h of Senselock ELto receive the data from the communication buffer. One is pbInBuff, which is a byte type pointer pointing to the communication buffer; the other is bInLen, which is a single byte integer, indicating the length of data sent over from the computer. Due to the limit of internal resources of SenseLock EL, the communication buffer shall not exceed 250 bytes in size. In other words, the data sent from the computer to Senselock ELor from Senselock ELto the computer each time shall not exceed 250 bytes6. To transmit data larger than 250 bytes requires that the data should be partitioned and transmitted several times. For the implementation method, please refer to ―Memory Sharing‖ in this chapter. When it is necessary to transport data from Senselock ELto the computer, the system function _set_response() shall be used. It will copy the data automatically to the communication buffer where they can be received by the computer. It shall be noted that only the last call to _set_response() is effective and the previous setting will be overwritten. The sample as given below illustrates how data are transported between the computer and SenseLock EL. #include “ses_v3.h” #include “string.h” unsigned char output[256]; unsigned char input[256]; void main() { int input_len = bInLen; int output_len = 0; memcpy(input, pbInBuff, input_len); /* Operate input data here… */ /* If we get some output data… */ _set_response((unsigned char)output_len, output); _exit(); } In this sample, the C function memcpy(), which is defined in string.h is used. The communication buffer itself is also a part of the memory, so you can either copy the contents of it to somewhere else or operate it directly. 6In the current version, when data are transported from Senselock ELto the computer, the value can be as big as 252, but there is no guarantee of this value for the subsequent versions.
Input/Output. 2). _set_response Set the data to be transmitted back to PC by Senselock ELEXF. BYTE _set_response( BYTE bLen, BYTE* pbBuff); Parameters: bLen [in] Length of returned data. pbBuff [in] Buffer address. Return Values: Return SES_SUCCESS if succeed or corresponding error code otherwise.
Input/Output. Choices are Files and Manual Entry. Files Input and Output buttons are used to specify the respective files. Each will open a file dialog box. Input requires an existing file, Output will allow new file creation or overwriting an existing one. The file names will be displayed next to each button. File formats are described in Section III. Manual Entry When selected, the From System area will display input areas for Geodetic or Grid coordinates; the To System area will display output fields based on the conversion type. Geodetic coordinates are entered in X.XX format. For example, 42°18’24.56253” is entered as 42.182456253 Longitude is entered as a positive value. Grid coordinates may be entered with or without commas.
