How to Develop Serial Port for Terminals: Difference between revisions

Revision as of 02:04, 4 June 2022

Here is a demo about how to develop an app using Java API, please download SerialPortDemo

A serial port test tool Source APP, and APK

When using the Java API to open a serial port, you need to set the logic ID of a serial port as a parameter.

SerialPortDevice.ID_USB_SLAVE_SERIAL : works for USB serial port in slave mode.
SerialPortDevice.ID_USB_HOST_SERIAL : works for USB serial port in master mode.
SerialPortDevice.ID_SERIAL_EXT : works for internal fiscal/ other serial port module.
SerialPortDevice.ID_USB_CDC: works for USB Communication Device Class.

When using the C API to open a serial port, you need to set the device name of a serial port as a parameter.

Device Name:

Parameters

device name

The alias for serial port. Available values: DB9, GS0_01, WIZARHANDQ1, Q1_USB_SERIAL, USB_SERIAL, SERIAL_EXT, USB_SLAVE_SERIAL, USB_HOST_SERIAL

in W1/W1V2:
- DB9: works for DB9 port at the back side of the terminal.
- GS0_Q1: works for USB host port at the right side of terminal to connect with Q1 via USB cable in master mode.
in Q1 3g:
- WIZARHANDQ1: works for USB serial port in slave mode.
- Q1_USB_SERIAL or USB_SERIAL: works for USB serial port in master mode.
- SERIAL_EXT: works for internal fiscal/other serial port module.
in Q1 4g and Q2(K2, M2, M3, QD4/5), Q3 series and others:
- USB_SLAVE_SERIAL: works for USB serial port in slave mode. For example, terminal use USB OTG cable connect the PC directly.
- USB_HOST_SERIAL or USB_SERIAL: works for USB serial port in master mode. For example, terminal connect an USB2Serial convertor or use UU cable.
- SERIAL_EXT: works for internal fiscal/other serial port module.
- USB_CDC: works for USB Communication Device Class.

Please check follow pictures

Q4: use picture 2 and picture 3, the Usb to DB9 cable ; or picture 4 the UU cable

Cables

OTG to USB Host TypeA Female:

USB to Serial port cable, USB TypeA Male to DB9 Female:

USB to Serial port cable, USB TypeA Male to DB9 Male:

UU cable, 2 USB Serial port cable cross connected together:

@@ Line 47: / Line 47: @@
 [[File:Otg_usb_1.jpg|frameless|left|thumb|caption]]
+USB to Serial port cable, USB TypeA Male to DB9 Female:
 [[File:Usb_db9_1.jpg|frameless|left|thumb|caption]]
@@ Line 53: / Line 53: @@
+USB to Serial port cable, USB TypeA Male to DB9 Male:
 [[File:Usb_db9_2.jpg|frameless|left|thumb|caption]]
+UU cable, 2 USB Serial port cable cross connected together:
 [[File:UUCable.jpg|frameless|left|thumb|caption]]