Changing parameters to the RF6x1 hand terminal from the host application

The host application can change parametrs of the hand terminal "on the fly" but some parameters requires reset before new values are valid.

Hand terminals 4-digit password

4-digit password prevents end users and third party host applications for accessing to advanced settings of the hand terminal.
Factory default password in the hand terminals are "1234". It's recommended to change it after receiving from Nordic ID.
Password can be set by editing and uploading password.pcg file to the hand terminal using RF6x1Configurator program.

Host application cannot change hand terminal parameters if 4-digit password is "0000".

PLServer method: "SetParameter" is used for changing parameters:

short SetParameter(long id, LPCTSTR pwd, LPCTSTR addr, LPCTSTR data)

id = commID of the hand terminal
pwd = 4-digit password of the hand terminal (string).
addr = Parameter name to change (string).
data = Value of parameter (string)

Parameter name (addr) Value (data)
SLEEP

Sleep timeout
Devices goes to sleep after 5-254 seconds, if no keypress.
Value 255 = Device is awake all the time.
Default for RF601 = 30 sec.
Default for RF651 = 254 sec.

RX_TIMEOUT
Reception time limit
 1-15 sec.
0 = 0.5 sec.
SEND_RETRY_CNT
Resending times
1 - 9
OLDWHAT
"WHAT" command behavior 0=New style 1 = Old style
CHAR_MAP
Code area 160-255 Character map
0 = default charset Original from RF6x0 device. Based on Latin-1 (West europe)
1 = ANSI Windows 1250 (East europe)
2 = ANSI Windows 1251 (Russian cyrillic)
3 = ANSI Windows 1252 (West europe)
4 = ANSI Windows 1257 (Baltic)
5 = Latin-10 (ISO-8859) South-Eastern Europe
6 = Koi8r (russian codepage)
7 = RF500 original
MID_TBL

Mid area (128-159) character map
0 = RF6x0 Default (same as in old RF6x0 devices)
1 = Control characters from ANSI WINDOWS 1250 codepage
2 = Control characters from ANSI WINDOWS 1251 codepage
3 = Control characters from ANSI WINDOWS 1252 codepage
4 = Control characters from ANSI WINDOWS 1257 codepage
5 = MENU SIGNS (always used when using built in menu)
6 = EXTRA SIGNS (useful characters)

DOT_COMMA
Printing DOT (.) or COMMA (,) when pressing dot key in the hand terminal
0 = DOT
1 = COMMA
EXTRAID
Extra ID
0-255
RESET
Resets hand terminal
HEADING
Heading text of the initial screen
Default text = "Nordic ID RF601" or "Nordic ID RF651 "
Max 20 characters
LASER_PARAM

Symbol SE955 laser scanner parameter change
Parameter # and values are specified in Symbol SE955 integration guide.
<Parameter#> : <Value>
Note: SE955 integration guide represent parameter values as a hex format.
SetParameter method acceptes only decimal values as strings like "123" not "0x7B"

Example: Disable CODE 128
SetParameter(id, "1234","LASER_PARAM","8:0");

Example: Enable CODE 93
SetParameter(id, "1234","LASER_PARAM","9:1");

Example: Set Interleave 2 of 5 to read any length
SetParameter(id, "1234","LASER_PARAM","22:0");
SetParameter(id, "1234","LASER_PARAM","23:0");

F1, F2, F3, F4, F5, F6, F7, F8, F9, F10

F-key texts
Default F-key texts = "F1+", "F2+", "F3+", "F4+", "F5+", "F6+", "F7+", "F8+", "F9+", "F10+"
'+' after text causes specified string to be sent to the host when user presses F-key.
If no '+', text will be printed to the active input field.
Max 15 characters
Example:
SetParameter(id, "1234","F1","Hello+"); //Sends "Hello" string to host after F1-key press SetParameter(id, "1234","F10","World"); //Prints"World" string to the active input field after F10-key press

   
SYSTEM
 System parameter (Do not use without knowing what to do)