Appendix A
Gang Writer Dynamic Link Library
34
Seiko Epson Corporation
S5U1C17001Y23 Multi-Programmer
System Manual (Rev. 1.1)
•
Return values
OK
ERROR_EXECUTING
ERROR_PARAMETER
ERROR_INSUFFICIENT_ICDSERIALNUMBUF
ERROR_INSUFFICIENT_IDNUMBUF
ERROR_INSUFFICIENT_FLSCOMMENTBUF
ERROR_INSUFFICIENT_USERCOMMENTBUF
•
Explanation
This function executes the following processes internally.
- Opens the USB port.
- Reads the firmware version.
Checks if it is a C17 firmware and the version is Ver. 2.2 or later.
- Acquires the serial number.
- Acquires the ID number.
- Closes the USB port.
* Comments for FLS
FLS comments (commands to be transferred to ICDmini) are stored in FlsComment separated by a delimiter
0x00. However, if the retrieved data is terminated with 0x00, DLL does not add 0x00.
ID number
Numeric characters up to 3 bytes from the beginning of comments (0x30 to 0x39) are regarded as an ID. If
there is another character other than numeric within 3 bytes from the head, the numeric characters preceding
that character are defined as the ID.
Examples:
(1) If the comment begins with “12ABC,” the ID is “12.”
(2) If the comment begins with “5 43,” the ID is “5” as the characters preceding the space are effective.
(3) If the comment begins with “ 123,” it is regarded as that this comment has no ID included, as there
is no character preceding a space.
Time Out
The comment may set the time-out value for erasing and programming of the flash memory. Note that an ID
number must be placed at the beginning.
Example: “123-T60”
The ID number is “123” and the time-out value is 60 seconds.
Others
Refer to readme_e.txt/readme_j.txt attached to the FLS for each S1C17 MCU model as there is
model-specific information described.
•
Precautions
When using this function, the necessary buffers must be allocated by the caller. Acquire the number of buffers
taking the precautions shown below into consideration.
- Calling this function with IcdSerialNumberList set to NULL, the necessary number of buffers can be
acquired.
- Note that the number of buffers is counted based on the type of the buffer, not the number of bytes of the
buffer.
- Note that the necessary number of buffers is not one per one ICDmini. That is, the necessary number of
buffers for FLS/user program comments and the necessary number of buffers for the serial number list are
the number of characters respectively described in one ICDmini.
- If no ICDmini is connected, nothing is written in each buffer. Then, the necessary number of buffers is 0.
Summary of Contents for S5U1C17000Y23
Page 4: ......
