Skip to content

Commit 5b7f962

Browse files
committed
Version 1.2
Former-commit-id: 4a558928d1700072dbc29638e8697bf1f9993db6 [formerly d8c4f09a99fda52307e81cb150b5964b816fcf37] Former-commit-id: 91c84c22ad39269be4b18592c1c385d3da80f479
1 parent 0ee828f commit 5b7f962

File tree

1 file changed

+21
-2
lines changed

1 file changed

+21
-2
lines changed

README.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
serial-port-json-server
22
=======================
3+
Version 1.2
34

45
A serial port JSON websocket & web server that runs from the command line on
5-
Windows, Mac, Linux, or Raspberry Pi that lets you communicate with your serial
6+
Windows, Mac, Linux, Raspberry Pi, or Beagle Bone that lets you communicate with your serial
67
port from a web application. This enables web apps to be written that can
78
communicate with your local serial device such as an Arduino, CNC controller, or
89
any device that communicates over the serial port.
@@ -12,6 +13,12 @@ The server runs on the standard port of localhost:8989. You can connect to
1213
it locally with your browser to interact by visiting http://localhost:8989.
1314
The websocket is technically running at ws://localhost/ws.
1415

16+
Supported commands are:
17+
list
18+
open [portName] [baud]
19+
close [portName]
20+
send [portName] [cmd]
21+
1522
The app is one executable with everything you need and is available ready-to-go
1623
for every major platform.
1724

@@ -26,4 +33,16 @@ you've created an oscilloscope web app that connects to an Arduino, it would be
2633
great use case. Finally you can write web apps that interact with a user's local hardware.
2734

2835
Thanks go to gary.burd.info for the websocket example in Go. Thanks also go to
29-
tarm/goserial for the serial port base implementation.
36+
tarm/goserial for the serial port base implementation.
37+
38+
Changes in 1.2
39+
- Added better error handling
40+
- Removed forcibly adding a newline to the serial data being sent to the port. This
41+
means apps must send in a newline if the serial port expects it.
42+
- Embedded the home.html file inside the binary so there is no longer a dependency
43+
on an external file.
44+
- TODO: Closing a port on Beagle Bone seems to hang. Only solution now is to kill
45+
the process and restart.
46+
- TODO: Mac implementation seems to have trouble on writing data after a while. Mac
47+
gray screen of death can appear. Mac version uses CGO, so it is in unsafe mode.
48+
May have to rework Mac serial port to use pure golang code.

0 commit comments

Comments
 (0)