Merge pull request #453 from Stefal/dev

Merge Dev 2.6.3 to master

.gitignore

@@ -9,4 +9,5 @@ settings.conf
 test.sh
 test.conf
 *.FCStd1
-/venv*/*
+**/venv*/*
+**/build/

README.md

@@ -9,7 +9,7 @@ Frontend's main features are:
 
 + View the satellites signal levels
 + View the base location on a map
-+ Detect and configure the Gnss receiver (Ublox F9P or Septentrio Mosaic-X5)
++ Detect and configure the Gnss receiver (Ublox F9P, Septentrio Mosaic-X5, Unicore UM980 / UM982)
 + Start/stop various services (Sending data to a Ntrip caster, internal Ntrip caster, Rtcm server, Sending Rtcm stream on a radio link, Log raw data to files)
 + Edit the services settings
 + Convert raw data to Rinex
@@ -43,7 +43,7 @@ If you use a Raspberry Pi, thanks to [jancelin](https://github.com/jancelin), yo
   sudo ./install.sh --all release
   ```
 
-+ Go grab a coffee, it's gonna take a while. The script will install the needed software, and if you use a Usb-connected U-Blox ZED-F9P receiver, it'll be detected and set to work as a base station. If you don't use a F9P, you will have to configure your receiver manually (see step 7 in manual installation), and choose the correct port from the settings page.
++ Go grab a coffee, it's gonna take a while. The script will install the needed software, and if you use a supported receiver (U-Blox ZED-F9P, Septentrio Mosaic-X5, Unicore UM980/UM982), it'll be detected and set to work as a base station. If you don't use a supported recevier, you will have to configure your receiver manually (see step 7 in manual installation), and choose the correct port from the settings page.
 
 + Open a web browser to `http://ip_of_your_sbc` (the script will try to show you this ip address). Default password is `admin`. The settings page allows you to enter your own settings for the base coordinates, ntrip credentials and so on...
 
@@ -54,6 +54,12 @@ If you use a Raspberry Pi, thanks to [jancelin](https://github.com/jancelin), yo
    - [rtklibexplorer - PPP - for dual frequency receivers](https://rtklibexplorer.wordpress.com/2017/11/23/ppp-solutions-with-the-swiftnav-piksi-multi/)
    - [Centipede documentation (in french)](https://docs.centipede.fr/docs/base/positionnement.html)
 
++ To help you find your base ip address, you can use the simple `find_rtkase` gui tool. It is available for Gnu/Linux and Windows in [./tools/find_rtkbase/dist](./tools/find_rtkbase/dist/).
+
+   - Click on the "Find" button, wait, then click on the "Open" button. It will open the RTKBase GUI in your web browser.
+
+     <img src="./tools/find_rtkbase/find_rtkbase_screenshot.png" alt="screenshot of find_rtkbase tool" width="300" />
+
 ## Manual installation: 
 The `install.sh` script can be used without the `--all` option to split the installation process into several different steps:
 ```
@@ -87,8 +93,8 @@ The `install.sh` script can be used without the `--all` option to split the inst
                              Install all dependencies like git build-essential python3-pip ...
     
             -r | --rtklib
-                             Get RTKlib 2.4.3b34g from github and compile it.
-                             https://github.com/rtklibexplorer/RTKLIB/tree/b34g
+                             Get RTKlib 2.4.3b34j from github and compile it.
+                             https://github.com/rtklibexplorer/RTKLIB/tree/b34j
     
             -b | --rtkbase-release
                              Get last release of RTKBase:
@@ -111,7 +117,7 @@ The `install.sh` script can be used without the `--all` option to split the inst
                              from the gnss receiver.
     
             -e | --detect-gnss
-                             Detect your GNSS receiver. It works only with receiver like ZED-F9P.
+                             Detect your GNSS receiver.
     
             -n | --no-write-port
                              Doesn'\''t write the detected port inside settings.conf.
@@ -218,11 +224,15 @@ So, if you really want it, let's go for a manual installation with some explanat
       sudo systemctl enable gpsd
    ```
 
+1. Install the avahi service definition with `sudo ./install.sh --zeroconf`, or:
+   + Copy the `rtkbase_web.service` file from `rtkbase/tools/zeroconf/` directory to `/etc/avahi/services/`
+   + Replace `{port}` with the port number used by the web server (e.g. 80).  
+
 1. Connect your gnss receiver to raspberry pi/orange pi/.... with usb or uart, and check which com port it uses (ttyS1, ttyAMA0, something else...). If it's a U-Blox F9P receiver (usb or uart) or a Septentrio Mosaic-X5 (usb), you can use `sudo ./install.sh --detect-gnss`. Write down the result, you may need it later.
 
-1. If you didn't have already configure your gnss receiver, you must set it to output raw data:
+1. If you didn't have already configure your gnss receiver, you must set it to output raw or rtcm3 data:
 
-   If it's a U-Blox ZED-F9P (usb or uart), or a Septentrio Mosaic-X5 (usb) you can use 
+   If it's a U-Blox ZED-F9P (usb or uart), or a Septentrio Mosaic-X5 (usb), or a Unicore UM980/UM982 you can use 
    ```bash
    sudo ./install.sh --detect-gnss --configure-gnss
    ```