Command set of Vxcomm.exe and Xserver (sends to 7188E/8000E)

Command

Explanations 

Command
(sends to 7188E/8000E)

Return
(sends to PC)

Version

• m: major version
• n: minor version
• rr: reversion number 

• C: COM port (1~8)
• BBBB: Baudrate

(1200, 2400, 4800, 9600, 19200, 57600, 115200)

• Success: OK
• Fault: Error 

• C: COM port (1~8)
• D: data bit

(7, 8 ==>Available for COM1~ COM2)
(5, 6, 7, 8 ==> Available for COM3 ~ COM8)
• P: parity

0, n ==> none parity
1, e ==> even parity
2, o ==> odd parity
3, m ==> mark parity (always 1)
4, s ==> space parity (always 0)
(0~2 ==> Available for COM1~COM2)
(0~4 ==> Available for COM3~COM8)
• S: stop bit

(1 ==> Available for COM1 ~ COM2)
(1, 2 ==> Available for COM3 ~ COM8)

• Success: OK
• Fault: Error

• CC status bit.(00~31)
• Provides Max 32 for Client
• Any Client call this function must use different status bit. When status bit be inquired by Client, it would be reset. It means first inquired the value is 1,next inquired is 0.Until the system be reset again, the value 1 be shown.

• Success: OK
• Fault: Error

• C：COM port.(1-8).
• S：RTS status. 0：inactive,1：active.
• D：DTR status. If no argument is given, the DTR status will not be changed (preserve the status quo).

• Success: OK
• Fault: Error

• C: COM port (1~8)
• BBBB: Baudrate

(1200, 2400, 4800, 9600, 19200, 57600, 115200)

• Success: OK
• Fault: Error

• C: COM port (1~8)
• D: data bit

(7, 8 ==>Available for COM1~ COM2)
(5, 6, 7, 8 ==> Available for COM3 ~ COM8)
• P: parity

0, n ==> none parity
1, e ==> even parity
2, o ==> odd parity
3, m ==> mark parity (always 1)
4, s ==> space parity (always 0)
(0~2 ==> Available for COM1~COM2)
(0~4 ==> Available for COM3~COM8)

• S: stop bit

(1 ==> Available for COM1 ~ COM2)
(1, 2 ==> Available for COM3 ~ COM8)

• Success: OK
• Fault: Error

• iii/ppp/III/PPP: 3 digits number (000~255)

• Success: OK
• Fault: Error 

• p :COM PORT,1~8
• ttttt: 0~99999, unit ms.


If set as 'a', 'A' or -1 the ttttt is decided by system.

If trigger level >1(Refer to command 32), the ttttt is (trigger level -1+3)=time of (trigger level +2 bytes) +1ms.

If trigger level ==1,the ttttt is time of 1byte +1ms(Min value is 2ms).

• Success: pttttt
• Fault: Error

• Success:
• Fault: Error

• iii/ppp/III/PPP: 3 digits number (000~255)

• Success: OK..Reconnect.
• Fault: Error

• Success: Gateway IP address: XXX.XXX.XXX.XXX (XXX:0~255)

• mmm/MMM:3 digits number(000~255)

• Success: OK.. Reconnect.
• Fault: Error

• Success: IP Mask address: XXX.XXX.XXX.XXX (XXX:0~255)

• C: COM port (1~8)

• Success: Baud Rate, Data, Parity, Stop EX:9600,N,8,1

• pppp:4 Hex numbers, Input address of DI. EX:0300 means input address 0x300

• Success: Show value of DI

Fault: Error

• pppp:4 Hex numbers, Output Address of DO. EX:03f8 means output address 0x3f8
• dd:2 Hex numbers. Output value

• Success: OK
• Fault: Error

• return value for the user to decide

• c=1:Enable 5DigitLed
• c=0:Disable 5DigitLed

• Success: OK
• Fault: Error

• xx:xx:xx:xx:xx:xx,xx: Hexadecimal value

• m: major version
• n: minor version
• rr: reversion number

• return value for the user to decide

• m=0:Feedback does not add command NO.
• m=1:Feedback add command NO.

• m='S': Inquire the timeout value of system (/ST)
• m='W': Inquire the timeout value of socket (/W)
• m='N': Inquire the Max number of socket
• m='M': Inquire the Work option:/M0 or /M1
• m='B': Enable/Disable the Broadcast mode B1:Enable Broadcast mode, B0: Disable Broadcast mode (Default:B0)
• m='E': Inquire the command echo mode, E1:Enable echo mode,E0: Disable echo mode (Default:E0)
• m='L': Inquire the 7-SEG LED status, L1: Enable LED to show, L0: Disable LED to show. (Default:L1)
• m='I': Inquire the NAME/IP/MASK/GATEWAY/MAC of 7188E

• Success: mxxx. m: 'S', 'W', 'N', 'M' xxx: value 
• Fault: Error

• m='SAVE': Set the system parameter will store in the EEPROM or not. If not set this parameter, the default value is SAVE=0.

Example: "26SAVE=1", "26SAVE=0"
• m='M': set the work option /M (n:0 n:1)
• m='B': Set the Broadcast mode. ("26B0") ("26B1")
• m="S": Set the system TIMEOUT /ST ("26S300000")
• m="W": Set the socket TIMEOUT /W ("26W86400000")
• m="E": Set the command echo mode
• m="I": Set IP, MASK, GATEWAY, or MAC (IP/GATEWAY/MASK/MAC must be uppercase)

• Success: m=n. m='SAVE', 'B', 'S' or 'M', n=setting value
• Fault: Error

[out]: M=1,B=0,S=300000

[out]: UDP=1

• C: COM port (1~8)
• M:1 Break enable,0 Break Disable

• Success: OK
• Fault: Error

• p: COM port(only support COM1/3/4/5)
• m, n: m Set the CTS mode，n Set the RTS mode。 

'0': DISABLE
'1': ENABLE. (RTS must control by user program.)
'2': ENABLE, auto control by hardware.
'3': ENABLE, auto control by software (LIBRARY).
for CTS, mode '1' and '3' are the same.
If the command does not add the mn arguments, the turn value is the settlement value of the first once.

• Success: return the value that has just been input back. 
• Fault: Error

• p: COM port (only support COM1/3/4/5)

• Success: CTSn=0 or CTSn=1 . n: COM port
• Fault: return "No_CTS n SIGNAL" n: COM port

• ssss: Any string. (The max length of string is 1460 bytes)

• Success: return the value same as string of input
• Fault:

• p: COM port , 3~8。
[LL],"1","4","8","14" choice one only from four items.
If the command does not add the LL arguments, the return is the settlement value of the first once.

• Success: return the value that has just been input back,Format30p[L[L]]
• Fault:

• p: COM port, 1~8
• nnnn: "0"~"1460"
The return value is the previous settings without adding any nnnn on the argument.

• Success: return the value that has just been input back,Format31pnnnn
• Fault: Error

• "33dir\n","33dir a\r" ---->dir a
• 33dir b\r" ---->dir b
• "33load a size\r" ----> ask for download file(1)
• "33+FILE DATA" -----> for download file。(2)

Items (1) and (2) run to update the files need the assistance by program.

• "33del a\r" -----> delete file in disk a
• "33del b\r"-----> delete file in disk b
>
• "33reset\r" -----> reset 7188e(by WDT)
• "33fileno a\r" ---->get file number & free space in disk a
• "33fileno b\r" ---->get file number & free space in disk b

• Success: return the value from 7188E
• Fault:

• Success: Format 7188el.lib Ver. n.nn[cc cc cccc], tcpipL.lib Ver. n.nn[cc cc cccc]
• Fault:

• p: port ('1'-'8')
• t: '1' clear tx output buffer
• r: '1' clear rx input buffer

• p: COM port, 1~8:COM1~COM8

• MSR status value

VXCOMM.EXE Version History

1. Modify theXserver structure [04/11/23]
2. Fix DHCP function bug [05/04/13]
3. Fix Web configuration function bug which cannot use for Mozilla/Firefox brower.
4. Fix the H/W flow control bug which the RTS cannot work correctly.
5. Fix the command 28 bug which causes the COM1 send the invalid message [05/04/22]
6. Fix the command 26 bug.
7. Fix the command 292/296/297 bug which causes the system crash.
8. Fix the command 05 which cause the COM1 send the invalid message.[05/04/26]
9. Remove the debug message of UDP function.[05/05/23]
10. Simplify the source cod of the command 23 and reduce the 200 bytes program size. [05/05/04]
11. Change the Timer function from calling the *TimeTicks to STOPWATCH [05/06/20]
12. Change the Timer function in TCPIP LIB from calling *TimeTicks to GetTimeTicks()
13. The first 3 bytes of MAC address has changed to "00:0d:e0" compulsively.
14. Change the receiving method while the string has come in from TCP port 10000 [07/26]
15. Change the LED blink in the different echo mode. M0 is in the original mode (ON 0.5 sec, OFF 0.5 sec), and M1 is ON for 0.1 sec, OFF for 0.1 sec and then ON for 0.1 sec, OFF 0.7 sec.
16. Fix the "00quit" command bug which this command cannot run without receiving the CR character.
17. Fix the bug that the system crash by WDT while the Ethernet cable has be removed, and the LED on i7188E will blink for 5 times per second while the Ethernet cable has be removed
18. Modify the ping gateway function. The original default setting is enabled, alter the default setting to be disabled. While using this function, the command line option will be "/ping=nnn", and the variable "nnn" is the frequency of pinging. [2006/04/28]
19. Modify the configuration screen of web server[2006/04/28]
20. Add two new functions, which use command "/P23" to set the Telnet and use command "/HTTP" to set the web server. The default settings are both enabled. Using command "/P23=0" to disable the Telnet, and using command "/HTTP=0" to disable the web server. [2006/08/22]

• The Newest function

1. Add Web configuration function [04/09/16]
2. Add telnet function (TCP port 23) [04/10/14]

1. Allow to add command line options to 'Vcom.ini' and 7188E kernal(Vcom320) will load the command line options from 'VCom.ini'.

The priority:
Default < Value saved on EEPROM< vcom.ini< command line written on Autoexec.bat. [2004/7/5]

2. (A)Added "/SIpxxxx" and "/SOpxxxx" command to change the COM PORT IN/OUT buffer size. (default are 1024 bytes) [2004/7/5]

(B)Added "/SCpxxxx" command to change the TCP output buffer size which is used to receive the data from COM port. [2004/7/5]

3. Added "/COMp=nnn-n-P-n" command to set the baud rate and data format of COM port[2004/8/20]

1. Update to V3.2.00 [2004/03/24]
2. New functions [2004/03/24]

Add 3 functions below. The functions will be called once the client has connected to the Xserver first.
void Port9999Start(int skt)
void Port502Start(int skt)
void PortUserStart(int skt)

3. Poer9999/Port520 set to 0 in default condition, and they can be changed by the user.
4. Added a "/Y" command in the command line in order to set 8KE4/8KE8 module. [2004/04/19]
5. Added a "/Z" command in the command line in order to set ACK delay time. [2004/04/19]

1. Added command 33 to upgrade files through port 10000 [2002/09/04]
2. Added the terminal character in the command line. [2002/09/09]
3. Fixed the mask bug [2002/9/12]
4. Added a variable to save system running time, and saves this variable to EEPROM [2002/9/13]
5. Added function to reset the system/socket timeout timer after the packet has finished being sent [2002/9/23]
6. Modified COM2 from Interrupt to DMA mode and used to receive data (MiniOS7 must be upgraded to e-020924.img or later) [2002/9/26]
7. Modified COM1 to DMA mode to receive data, and fixed the RTS control bug [2002/10/1]
8. Modified "09pA" command ，(Set as 'a' or 'A the timeout is set by system [2002/10/18]
9. Added a "/L0" command in the command line in order to disable/enable LED5. [2002/10/18]
10. Canceled the "/N" parameter in command line.[2002/10/29]
11. Modified the COM port for x512(7188E7).[2002/10/30]
12. Fixed the COMMAND 15 bug [2002/10/31]
13. Added support to allow command 34 to read the Vcomnnn.exe library version and date.
14. Added the "/pxxxx" command to change PORT10000.[07/23/2003]
15. The command port will be shown on the 7-LED after 7-LED 11111.

For example: Port10000=54332 --> "5.4.3.3.2."

16. Fixed the Vcom3009.lib bug which meant that "/st300" could not reset the 7188e. [08/14/2003]
17. Fixed the command 07 that allows the user to set the COM port parity to Mark and space [11/07/2003]
18. Supports 2 stop bits on COM2(7N2,7E2,7O2) [01/12/2004]

1. Added the PortUser function for X-server [02/18/2002]
2. If the number of Port9999,Port502,PortUSer is zero, the port will be closed [02/18/2002]

1. Port9999 and Port502 variable can changed to any port number by the user in the UserInit() function [01/18/2001]
2. Port10000 variable also can changed to any port number by the user in the UserInit() function[02/06/2002]

1. Modified the OpMode=0 procedure [12/19/2001]
2. Modified the UserLoop function. Call this function per loop [12/28/2001]

1. Added user command "25", "26".
2. Add TCP PORT 9999/502
3. Modified the COM7 error.

1. Modified from v2.6.14
2. Supports functions to 7188E5. [10/23/2001]

1. Modified from V2.6.12
2. Added user command "23".
3. The default value of system timeout is zero, it means no timeout. If no packets sent to system exceeding the timeout, the system reset by WatchDog.
4. When the time ticks of the system return to normal, the timing of the TCP ACK delay will set 0 ms.(phenomenon will take place.It will see one more ACK package off than before. but this did not affect the system.)
5. In the multi-client mode. The timeout was detected whether the data of COM port had received, but it was not detected by the terminal character(Ex:0x0D).
6. Add the checksum to the set value of COM port.When the read back value from the modules is wrong, the value of COM port was set as default(9600,N,8,1.)

• This version is for testing. It is the released version for 7188E1/2/X/A.

1. Updated from v2.6.12
2. Saves the COM port value, added a one byte checksum. When read the checksum was wrong, the value of COM port was set as default (9600,N,8,1)
3. Added a debug port (7188).
• Sends a command to break some or all sockets.
• Lists the messages from all connected sockets.
4. Make system crash easily. (Unstable version)

Command Line Options

VcomNNNN.exe [/Option] (NNNN denotes the Vxcomm.Lib version)

Options

Explanations

Notes

Recognizes 7188E1

Recognizes 7188E2

Recognizes 7188E3

v3.0.0 and above

Recognizes 7188E4

3.0.0 and above

3.0.0 and above

3.0.0 and above

• 'N'/'n': None Parity.
• 'E'/'e': Even Parity.
• 'O'/'o': Odd Parity.
• 'M'/'m': Mark Parity.
• 'S'/'s': Space Parity.

Notes: The options above are case sensitive.

VXCOMM.EXE 5DigitLED/Led

1. The 7188E will be shipped with Xserver or VxComm as default. To indicated this, the red LED on the 7188E will periodically flash ON for 0.5 second then OFF for 0.5 second.
2. 5DigitLed


The important information shown on the five 7-Seg Led can be divided as follows:

• 11111. shows IP address.

The IP-information format of 7188E series is as follows:
1. xxx
2. xxx
3. xxx
4. xxx


• After the IP address, the command port number (Port10000) will be shown.



• 22222. Shows the Baud rate of each COM port.

1. 1152 (115200 bps)
2. 96 (9600 bps)
3. 384 (38400 bps)
4. 192 (19200 bps)


• 33333. Shows the data format for COM port, including data bit, parity, and stop bit

1. 801
2. 801
3. 811
4. 701


• 44444. Shows the socket status and debug information
• 1.27.00: client-connected information of the 7188E '27' denotes that the free socket is 27 and no client connects to the 7188E/8000E



• 2.0419: Reset number.

The total reset number is 419. This value is saved to the 7188E/8000E EEPROM. This value will increase by 1 each time the 7188E is powered on or reset , etc.


• 3.0126: This is the total current packet value sent from the Ethernet to the 7188E.



• 4.0000 : A flag is used to detect whether a packet can be sent by the hardware. 0 means OK, 1 means the 7188E cannot send the packet.



• 5.0001 : This value denotes the 8019s chip reset number. This value is counted from the start of a 7188E reboot. Normal status is 1.