Serial and SSI Settings

SSI Host Parameters

Select SSI Host

Used to switch the device host interface to SSI Host. The default table also gives the recommended initial values for this interface:

• Baud rate: 9600

• Parity: None

• Parity checking: Disable

• Stop bit: 1

• Software handshake: ACK/NAK

• Host RTS line status: Low

• Decode data packet format: Send Raw Decode Data

• Host serial port response timeout: 2 sec

• Host character timeout: 200 ms

• Multipart option: Option 1

• Inter-message delay: 0 ms

• Decoding event: Disable

• Startup event: Disable

• Parameter event: Disable

Note

SSI interprets prefix and suffix values differently from other interfaces. It does not recognize key categories, only 3-digit decimal values; for example, the default value 7013 will be interpreted as CR.

Select SSI Host

Host RTS Line State

Used to set the idle state of the serial port host RTS line.

• Host RTS low level, default value

• Host RTS high level

* Host RTS Low

Host RTS High

Note

When the device works with standard serial software in decode-and-transmit mode, and the host-side hardware handshake line interferes with the SSI protocol, try switching to “Host RTS High”.

Host Serial Response Timeout

Used to set the maximum time for the device to wait for the host ACK/NAK; if it times out, the device will retransmit and report a transmission error after continuous failures.

• Low - 2 Seconds, default value

• Medium - 5 Seconds

• High - 7.5 Seconds

• Maximum - 9.9 Seconds

* 2 seconds

5 seconds

7.5 seconds

9.9 seconds

Other values can be set through the SSI command. It is recommended that both ends of the host and device be consistent.

Host Character Timeout

Used to set the maximum allowed interval between characters sent by the host; beyond this time, the device will discard the current received data and determine it as a communication error.

• Low - 200 ms, default value

• Medium - 500 ms

• High - 750 ms

• Maximum - 990 ms

\* 200 ms

500 ms

750 ms

990 ms

Other values can be set through the SSI command.

Software Handshaking

Used to control the ACK/NAK software handshake.

• Disable ACK/NAK

• Enable ACK/NAK, default value

Disable ACK/NAK

* Enable ACK/NAK

When enabled, the device will wait for the host to return ACK or NAK after sending packaged data; if no response is received within the “host serial port response timeout”, the device will resend at most two times.

Note

Hardware handshaking is always enabled and cannot be turned off. ACK/NAK does not apply to decoded data when sending it as raw ASCII.

Parameter Event

Used to control whether parameter-related events are reported.

• Enable Parameter Event

• Disable Parameter Event, default value

Enable parameter events

* Disable parameter events

Typical event codes include:

• 0x07: Parameter input error

• 0x08: Parameters saved

• 0x0A: Restore default value

• 0x0F: Need to enter a number

Startup Event

Used to control whether the device actively sends startup events to the host after it is powered on.

• Enable Boot Up Event

• Disable Boot Up Event, default value

Enable startup events

* Disable startup events

Corresponding event code: 0x03

decode event

Used to control whether to actively send events to the host after decoding is successful.

• Enable Decode Event

• Disable Decode Event, default value

Enable decoding events

* Disable decoding events

Corresponding event code: 0x01

Multipart Options

Used to control how ACK/NAK is handled during multi-packet transmission.

• Multipacket Option 1, default value ACK/NAK handshake for each packet

• Multipacket Option 2 sends data packets continuously without using ACK/NAK to control the rhythm; if the host cannot handle it, hardware handshake can be used to temporarily delay sending.

• Multipacket Option 3 Same as Option 2, but adds programmable inter-packet delay

\* Multipacket Option 1

Multipacket Option 2

Multipacket Option 3

Inter-message Delay

Used to set the waiting time between packages under Multipacket Option 3.

• Minimum - 0 ms, default value

• Low - 25 ms

• Medium - 50 ms

• High - 75 ms

• Maximum - 99 ms

\* 0 ms

25 ms

50 ms

75 ms

99 ms

Other values can be set through the SSI command.

SSI baud rate

Used to set the SSI communication rate, which must be consistent with the host.

• 9600, default value

• 19,200

• 38,400

• 57,600

• 115,200

• 230,400

• 460,800

• 921,600

\* 9600

19,200

38,400

57,600

230,400

460,800

921,600

SSI check digit

Parity check mode used to set the highest bit of a character.

• Odd

• Even

• None, default value

Odd Parity

Even Parity

* No Parity

SSI parity check

Used to control whether the device checks the parity of received characters.

• Do Not Check Parity, default value

• Check Parity

* Do not check check digit

Check check digit

SSI stop bit

Used to set the number of stop bits at the end of each character.

• 1 Stop Bit, default value

• 2 Stop Bits

* 1 stop bit

2 stop bits

SSI transaction and command encapsulation

SSI transaction

Used to archive the SSI transaction flow, command interaction sequence, and common status codes between the host and the device.

Currently confirmed communication rules include:

• SSI Data is transmitted between the host and the device in the form of data packets. The maximum size of a single packet is 257 bytes.

• Decoded data can be sent either as original ASCII or as DECODE_DATA package

• When ACK/NAK is enabled, all packaged messages must return CMD_ACK or CMD_NAK unless otherwise specified.

• Raw ASCII decoded data with WAKEUP without using ACK/NAK handshake

• If hardware handshaking is not used, WAKEUP should be sent before sending any communication to the sleeping device, otherwise the first byte may be lost.

Note

All communications use 8 data bits. If the baud rate, stop bit, parity bit or response timeout is modified through PARAM_SEND, ACK of the current transaction will still use the old parameters to return, and the new value will take effect from the next transaction.

RMD command/response encapsulated by SSI

Used to illustrate the encapsulation format of RSM / RMD commands and responses in the SSI protocol.

Confirmed structural points:

• The command header uses SSI_MGMT_COMMAND (0x80)

• Host side Message Source is 4

• Device side Message Source is 0

• Supports variable-length commands up to 255 bytes

• The host does not support direct multi-packet delivery of RSM commands through SSI, and needs to be fragmented by itself according to the RSM protocol.

The in-page example shows how to read diagnostic information (attribute #10061) through the encapsulated RSM command.

SSI command list

Typical commands confirmed to be supported include:

• AIM_OFF (0xC4)

• AIM_ON (0xC5)

• BEEP (0xE6)

• CAPABILITIES_REQUEST (0xD3)

• CAPABILITIES_REPLY (0xD4)

• CMD_ACK (0xD0)

• CMD_NAK (0xD1)

• DECODE_DATA (0xF3)

• EVENT (0xF6)

• LED_OFF (0xE8)

• LED_ON (0xE7)

• PARAM_DEFAULTS (0xC8)

• PARAM_REQUEST (0xC7)

• PARAM_SEND (0xC6)

• REQUEST_ID (0xA3)

• REPLY_ID (0xA6)

• REQUEST_REVISION (0xA3)

• REPLY_REVISION (0xA4)

• SCAN_DISABLE (0xEA)

• SCAN_ENABLE (0xE9)

• SLEEP (0xEB)

• START_DECODE (0xE4)

• STOP_DECODE (0xE5)

• WAKEUP

event code table

The basic event codes that have been sorted out are as follows:

event type	Description	event code
Decode Event	Non-parametric decoding event	0x01
Boot Up Event	System power on	0x03
Parameter Event	Parameter input error	0x07
Parameter Event	Parameters saved	0x08
Parameter Event	Restore defaults	0x0A
Parameter Event	Need to enter a number	0x0F

Transmit buffer overflow

Used to describe the performance, risks, and handling recommendations when the transmission buffer overflows.

RS232 host type

RS232C host type

Used to list different RS232 host types and their default parameter sets.

The currently sorted host types include:

• Standard RS-232

• ICL Serial

• Wincor-Nixdorf Serial Mode A

• Wincor-Nixdorf Serial Mode B

• Olivetti ORS4500

• Omron

• OPOS/JPOS

• Fujitsu Serial

• CUTE

Note

Scanning Standard RS-232 will only enable the serial port driver and will not modify existing port settings; scanning other host types will also rewrite the corresponding serial port parameters.

Standard RS232C

Describes the default communication parameters for standard RS232 host mode. The currently confirmed default values are as follows:

Parameter	Default Value
Serial Host Types	Standard RS-232
Baud Rate	9600
Parity Type	None
Stop Bits	1
Data Bits	8-Bit
Check Receive Errors	Enable
Hardware Handshaking	None
Software Handshaking	None
Host Serial Response Time-out	2 Sec
RTS Line State	Low RTS
Beep on <BEL>	Disable
Intercharacter Delay	0 msec
Nixdorf Beep/LED Options	Normal Operation
Ignore Unknown Characters	Send Bar Code

Note

Terminal Specific RS232 and ICL RS232C in the original directory belong to the compatibility instructions of a specific terminal or host protocol. You should confirm the current host interface type and protocol requirements before use.

Serial communication parameters

RS232 baud rate

Used to illustrate serial port communication rate selection.

The currently confirmed values include:

• 9600, default value

• 19,200

• 38,400

• 57,600

• 115,200

• 230,400

• 460,800

• 921,600

* RS232 baud rate 9600

RS232 baud rate 19,200

RS232 baud rate 38,400

RS232 baud rate 57,600

RS232 baud rate 115,200

RS232 baud rate 230,400

RS232 baud rate 460,800

RS232 baud rate 921,600

RS232 check digit

Used to illustrate the selection method of parity check strategy.

• Odd

• Even

• None, default value

RS232 odd parity

RS232 even parity

* RS232 without parity

Check Parity is used to control whether the receiving end performs parity check, and is usually confirmed with RS232 check digit above.

RS232 stop bit

Used to describe how the number of stop bits is selected.

• 1 Stop Bit, default value

• 2 Stop Bits

* RS232 1 stop bit

RS232 2 stop bits

8 data bits

Used to illustrate the serial port data bit width configuration.

• 7-Bit

• 8-Bit, default value

RS232 7 data bits

* RS232 8-bit data bits

Note

Even Parity, DO NOT CHECK PARITY, HOST HIGH RTS and Host Low RTS in the original text are serial port compatibility instructions. The scannable setting code of the parity check has been merged into the “RS232 check digit”, and the RTS line status should be confirmed in combination with the “hardware handshake” and the host protocol requirements.

Receive error checking

Used to control whether received characters are checked for parity, framing errors, and overflow errors.

• Check For Received Errors, default value

• Do Not Check For Received Errors

* Check for receiving errors

Don’t check for receive errors

hardware handshake

Used to control the serial port RTS/CTS hardware handshake.

Currently confirmed options and behaviors include:

• None

• Standard RTS/CTS

• RTS/CTS Option 1

• RTS/CTS Option 2

• RTS/CTS Option 3

Note

If hardware handshake and software handshake are enabled at the same time, hardware handshake takes precedence. In Standard RTS/CTS mode, the device will rely on CTS and “host serial port response timeout” to control the sending timing; if the handshake fails, the current data will be lost and a sending error prompt will be triggered.

Other serial port related

original directory	Description
Fuzzy Processing	Used to organize special serial port parameters related to fuzzy matching, fault-tolerant reception or compatibility processing.
Codabar Upper or Lower Case Start Stop Characters Detection	Used to describe the serial port or host side’s detection compatibility strategy for the case of Codabar’s starting and ending characters.