Skip to content

Commit b9ba556

Browse files
committed
Update README.md
1 parent aba4b80 commit b9ba556

1 file changed

Lines changed: 42 additions & 1 deletion

File tree

README.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,43 @@
11
# SerialMonitor
2-
Small serial port monitor / terminal. It enables monitoring communication with possibility to send repeat automatically.
2+
Program is simple piece of software designed for monitoring data on serial port. Time between received data messages is displayed (in miliseconds). In addition to the printing on the screen it allows write everything (or just communication) to a specified file.
3+
4+
![](https://github.com/docbender/SerialMonitor/blob/master/img/SM1.png)
5+
6+
Program has also feature that allows answer to sender for specific message. This could be used for simple simulation of some device. To use this feature it is necessary to prepare file with pairs ask/answer. In file first(odd) line represent ask and second(even) line answer. File can contain several pairs ask/answer which can be separated by empty lines (not necessary). File example:
7+
8+
0x01 0xD0 0x00 0xD1 - ask
9+
0x01 0xE2 0x00 0xE3 - answer
10+
11+
0x75 0x55 0x55
12+
0x45 0x44 0x44
13+
14+
0x11 0x54 0x55
15+
0x25 0x26 0x56
16+
17+
Data in file can be written in hex format (0x leading) or ASCII format. Selected format must be used through whole file.
18+
19+
##Usage
20+
Program as commandline program support some parameters. First one (most important) PortName that represent port to open (ex. COM3). When program is started without parameters port COM1 with default parameters is used.
21+
22+
**serialmonitor PortName [switch parameter]**
23+
24+
Switches:
25+
* -baudrate {baud rate}: set port baud rate. Default 9600kbps.
26+
* -parity {used parity}: set used port parity. Default none. Available parameters odd, even, mark and space.
27+
* -databits {used databits}: set data bits count. Default 8 data bits.
28+
* -stopbits {used stopbits}: set stop bits count. Default 1 stop bit. Available parameters 0, 1, 1.5 and 2.
29+
* -repeatfile {file name}: enable repeat mode with protocol specified in file
30+
* -logfile {file name}: set file name for log into that file
31+
* -logincomingonly: log into file would be only incoming data
32+
* -showascii: communication would be show in ASCII format (otherwise HEX is used)
33+
34+
Example:
35+
36+
serialmonitor COM1
37+
serialmonitor COM1 -baudrate 57600 -parity odd -databits 7 -stopbits 1.5
38+
serialmonitor COM83 -baudrate 19200 -repeatfile protocol.txt
39+
40+
In program commands can be typed:
41+
* exit or ^C: program exit
42+
* send {data to send}: send specified data (in HEX format if data start with 0x otherwise ASCII is send)
43+

0 commit comments

Comments
 (0)