Skip to content

Commit d78e83c

Browse files
committed
Binaries for version 1.2
Former-commit-id: 076163eabc35cb16a4b21e27a56435c8d3aa745a [formerly a793bbd3c87488ce32f9e73782ce18e7e2d4af0a] Former-commit-id: af78ff1e5f9dbb38afd48090c915c4cee238a247
1 parent bfc303d commit d78e83c

10 files changed

+49
-28
lines changed

snapshot/README.md

Lines changed: 32 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,48 @@
11
serial-port-json-server
22
=======================
3+
Version 1.2
34

4-
A serial port JSON websocket & web server that runs in your system tray on
5-
Windows, Mac, or Linux that lets you communicate with your serial port from a
6-
web application. This enables web apps to be written that can communicate with
7-
your local serial device such as an Arduino, CNC controller, or any device that
8-
communicates over the serial port.
5+
A serial port JSON websocket & web server that runs from the command line on
6+
Windows, Mac, Linux, Raspberry Pi, or Beagle Bone that lets you communicate with your serial
7+
port from a web application. This enables web apps to be written that can
8+
communicate with your local serial device such as an Arduino, CNC controller, or
9+
any device that communicates over the serial port.
910

1011
The app is written in Go. It has an embedded web server and websocket server.
1112
The server runs on the standard port of localhost:8989. You can connect to
12-
it locally with your browser to interact.
13+
it locally with your browser to interact by visiting http://localhost:8989.
14+
The websocket is technically running at ws://localhost/ws.
15+
16+
Supported commands are:
17+
list
18+
open [portName] [baud]
19+
close [portName]
20+
send [portName] [cmd]
1321

1422
The app is one executable with everything you need and is available ready-to-go
1523
for every major platform.
1624

1725
If you are a web developer and want to write a web application that connects
18-
to somebody's local serial port server, then you simply need to create a new DNS entry
19-
under your domain called something like serialjson.mydomain.com and map it to
20-
127.0.0.1 to solve for the cross-domain Ajax policy. Then simply create a websocket
21-
connection to serialjson.mydomain.com and you will be directly interacting with
22-
that user's serial port.
26+
to somebody's local or remote serial port server, then you simply need to create a
27+
websocket connection to the localhost or remote host and you will be directly
28+
interacting with that user's serial port.
2329

2430
For example, if you wanted to create a Gcode Sender web app to enable people to send
2531
3D print or milling commands from your site, this would be a perfect use case. Or if
2632
you've created an oscilloscope web app that connects to an Arduino, it would be another
2733
great use case. Finally you can write web apps that interact with a user's local hardware.
34+
35+
Thanks go to gary.burd.info for the websocket example in Go. Thanks also go to
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.

snapshot/downloads.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,21 +7,21 @@ serial-port-json-server downloads (version snapshot)
77

88
### Linux
99

10-
* [serial-port-json-server\_linux\_386.tar.gz](\serial-port-json-server_linux_386.tar.gz)
11-
* [serial-port-json-server\_linux\_amd64.tar.gz](\serial-port-json-server_linux_amd64.tar.gz)
12-
* [serial-port-json-server\_linux\_arm.tar.gz](\serial-port-json-server_linux_arm.tar.gz)
13-
* [serial-port-json-server\_snapshot\_amd64.deb](\serial-port-json-server_snapshot_amd64.deb)
14-
* [serial-port-json-server\_snapshot\_armhf.deb](\serial-port-json-server_snapshot_armhf.deb)
15-
* [serial-port-json-server\_snapshot\_i386.deb](\serial-port-json-server_snapshot_i386.deb)
10+
* [serial-port-json-server\_linux\_386.tar.gz](serial-port-json-server_linux_386.tar.gz)
11+
* [serial-port-json-server\_linux\_amd64.tar.gz](serial-port-json-server_linux_amd64.tar.gz)
12+
* [serial-port-json-server\_linux\_arm.tar.gz](serial-port-json-server_linux_arm.tar.gz)
13+
* [serial-port-json-server\_snapshot\_amd64.deb](serial-port-json-server_snapshot_amd64.deb)
14+
* [serial-port-json-server\_snapshot\_armhf.deb](serial-port-json-server_snapshot_armhf.deb)
15+
* [serial-port-json-server\_snapshot\_i386.deb](serial-port-json-server_snapshot_i386.deb)
1616

1717
### MS Windows
1818

19-
* [serial-port-json-server\_windows\_386.zip](\serial-port-json-server_windows_386.zip)
20-
* [serial-port-json-server\_windows\_amd64.zip](\serial-port-json-server_windows_amd64.zip)
19+
* [serial-port-json-server\_windows\_386.zip](serial-port-json-server_windows_386.zip)
20+
* [serial-port-json-server\_windows\_amd64.zip](serial-port-json-server_windows_amd64.zip)
2121

2222
### Other files
2323

24-
* [README.md](\README.md)
24+
* [README.md](README.md)
2525

2626

2727

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
a270abdd3cf3b9d287a1ce8236ec2e4b702d919c
1+
f8dcf27fd578d0ab30396ed840caf1f540dded92
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
d8c63019312073cab2f251deb1ed5bef1d5c3e50
1+
f92a284d6c60ef3d5c5a0462d40fdc693f24e083
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
f4c4f3910f9852b5a532cb3976268fdb0da6b49a
1+
c2fe8cf83b0d466a98a367cabae5f222c9c3ce9b
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
7e2ab6dcc4523595ae75bb9a97c910c88b9702ee
1+
a9cfe798e73f82686c3891d9de2facfc496a4571
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
d7bc80190ae619c86cecffd5893aa496357ecd66
1+
9b4d1a03079b8611374083e8c6542c25a8a41656
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
b30a85b0073b665d43f44261f9d2f33389836412
1+
720fd61af4cf5e4c22544808943d8bbd74829ad8
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
c4892959fe971b371825ebdcec811253fbf4362d
1+
661656517df980f66b2424b7af3bef12946ed7d5
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
8f5b888ef331072393dbb86d10ebc3bd8a4e1ff1
1+
23301d38da83d437c013d3ce2063fa9f7cbeb7d5

0 commit comments

Comments
 (0)