Xantech CRM-WIC, Reference Manual

Page: 25 / 99

25
Send String
The second diagnostic allows you to send a byte stream through the port specified at the top of the page.
The byte stream you wish to send must be a URL-encoded send string:
To send a URL-encoded string, follow these three rules for encoding:
1. Enter your byte values as a string of printable ASCII characters and hex values. Spaces and
returns, for example, are non-printable characters and MUST be converted to hex.
2. Any hex value in the send string must be preceded by a "%" symbol.
3. The URL-encoded string does NOT accept decimal values, so if you only know the decimal
value of a byte, you MUST either convert it to a printable ASCII characters or the hex
equivalents.
For example, the decimal byte stream "103 111 111 100 32 100 111 103" is equivalent to the hex byte
stream "67 6F 6F 64 20 64 6F 67". It is also equivalent to the ASCII string "
good dog
". However, to
send the string to the serial port, you must use a combination of printable ASCII characters and hex
values only. Therefore, you may send the string as "
good%20dog
" or "
good%20%64%6F%67
", but not
"
good dog
" (contains a space, which is a non-printable character) or "
good%32dog
" (where "32" is a
decimal value). (You do not need to use quotes in the Send String text box.)
For your convenience, if you forget URL-encoding rules 2 and 3 above, you may add hex or decimal
values using the hex and decimal fields just below the Send String text box. Adding a hex number to
your Send String with the tool simply places the "%" prefix in front of the value you enter, with no
conversions. Adding a decimal number first converts the decimal number to the hex equivalent and
correctly places the "%" prefix in front of it within the send string.
If the Send History log has been started, the send string should appear in that display once the "Send"
button is pressed.