simpleRTK3B setup

README.md

@@ -85,6 +85,72 @@ Not sold by Sparkfun, adafruit, or Digikey. Mouser part number:
 * 780-ASRTK3BMX5L125NH
 
 
+HOWTO set up the Septentrio simpleRTK3B USB.
+This was done using a Traverse Ten64 arm64 with Debian Bullseye (stable/11)
+as the server. Should be similar for Raspberry Pi or other Debian systems.
+
+
+Plug in the antenna to the simpleRTK3B.
+Plug the USB-C into the USB port on the server.
+Use the USB-C port labeled "GPS", which is the one on the same end as
+the antenna. This port will supply power to the device.
+When connected, it creates the following on the server via USB:
+
+* `/dev/ttyACM0` --- Serial port, `8N1` at `115200` baud.
+* `/dev/ttyACM1` --- Serial port, `8N1` at `115200` baud.
+* `/dev/sr0` --- Emulated CDROM, also accesible via symlink `/dev/cdrom`.
+* `/dev/sda` --- Hard drive.
+* `usb0` --- USB network interface.
+
+The CDROM drive just contains proprietary drivers.
+The hard drive is not readable from Debian, at least not initially.
+By default, the simpleRTK3B device won't send any data.
+So `/dev/ttyACM0` and ``/dev/ttyACM1` are available, but not
+streaming any GNSS data.
+
+To configure the simpleRTK3B device, the USB network interface
+needs to be set up, then the device can be configured via
+its web interface.
+
+For testing, set up a temporary network interface on the server
+using the USB network device. For example:
+
+```
+ifconfig usb0 192.168.3.2 netmask 255.255.255.0 up
+```
+
+Then ping the simpleRTK3B network from the server via the USB device:
+
+```
+ping -c1 192.168.3.1
+```
+
+If there is a web browser available on the server, it can then access
+this URL to configure the simpleRTK3B.
+
+* http://192.168.3.1
+
+If the server is headless, a tunnel can be created from workstation
+to the server, then the USB web server is available on the workstation
+via localhost. Create SSH tunnel, where `server` is the hostname
+or IP of the server:
+
+```
+ssh -N -L 127.0.0.1:8080:192.168.3.1:80 server
+```
+
+Then on the workstation, the simpleRTK3B Septentrio web
+configuration tool is available at:
+
+* http://127.0.0.1:8080
+
+If all is good on the device, it will have already found satellites.
+It needs to be configured to dump data that `galmon` will read.
+
+*Septentrio simpleRTK3B Web Interface*
+![septentrio-simpleRTK3B-www](pics/ss-sept-www.png)
+
+
 # Status
 Three ground stations running.