Changes between Version 31 and Version 32 of expansion/gw16143

Timestamp:

10/25/2024 05:00:02 PM (4 weeks ago)

Author:

Ryan Erbstoesser

Comment:

add information

expansion/gw16143

@@ -361 +361 @@
 View the Gateworks [wiki:gettingstarted SBC Quickstart Guide] to get a serial console connection to the Gateworks SBC. 
 
-Validate the GPS can be seen on the system and is picking up satellites:
+Validate the GPS can be seen on the system and is picking up satellites via the instructions below:
 
 Viewing standard (<15 meter accuracy) GNSS data using the GW16143 is simple on a Gateworks board using the cat command as shown in the example below:
@@ -391 +391 @@
 }}}
 
-Then, download dependencies by running ./setup.sh which can take a few minutes while all the required packages are downloaded and installed:
+Then, download dependencies by running ./setup.sh which can take a few minutes while all the required packages are downloaded and installed:(This creates the virtual environment)
 {{{
 ./setup.sh
@@ -398 +398 @@
 Then, configure settings.toml and .secrets.toml using your favorite text editor like vi.
 
-Then run ./start_gps.py
+Then Activate the virtual environment which has the dependencies via the command:
+{{{
+ source activate_venv.sh
+}}}
+
+Then run ./start_gps.py which by default uses 'cgps' to monitor data from the u-blox module
 {{{
 ./start_gps.py
 }}}
 
+!!! NOTE: setup.sh MASKS gpsd with the command "systemctl mask gpsd". !!! This is because the scripts provided use custom instances of gpsd + cgps, and pygnssutils uses /dev/ttyACM0. To reduce conflict the system daemon is disabled. You should re-enable it for your own programs.
+
 More information about !PointPerfect is shown on this page under the [#pointperfect PointPerfect section]
 
+A common evaluation usecase is: Running "cgps" in the foreground to monitor GPS data, along with PointPerfect GNSS corrections.
+
+To do this, you would edit the credentials in the secret settings file as per the PointPerfect site, set run_pygnssutils_in_foreground to false, and set the foreground process to "cgps". To use cgps with the script, you also must enable the gpsd bridge. The default settings will be OK in most instances.
+
+Another usecase may be configuring and viusalizing the GPS data in u-center. u-center is a Windows application, but it nevertheless can be both powerful in configuring and visualizing the GPS. To use u-center, you do NOT want to use our script, rather just use a one line command to send all /dev/ttyACM0 data over TCP.
+{{{
+$ socat TCP-LISTEN:12345,reuseaddr,fork /dev/ttyACM0,raw,echo=0
+}}}
+
+=== Troubleshooting
+
+
+If you're getting 0,0,-17 as a coordinate, make sure that your antenna is connected well. Ensure python is updated, the script used Python 3.10.12.
+
+=== Architecture 
+{{{
+                 GPS TESTING SCRIPT: start_gps.py
+                  What can it do out of the box?                       
+
+
+┌───────────────────────┐
+│                       │
+│  GPS Device GW16143   │
+│     /dev/ttyACM0      │ ──────┐                         ┌─────────────┐
+│                       │       ▼                         │             │
+│     Location Info     │    ┌─────────────────────┐      │   Logging   │
+│                       │    │                     │      │  Raw & KML  │        ┌───────────────────┐
+└───────────────────────┘    │                     │ ───► │ --> Google  │        │                   │
+                             │     PyGNSSUtils     │      │    Earth    │        │    GPSD / cgps    │
+                             │  Core data handler  │      └─────────────┘        │                   │
+┌───────────────────────┐    │                     │                             │    Visualizer     │
+│                       │    │                     │    ┌─────────────────┐      │ OPTIONAL standard │
+│     PointPerfect      │    └─────────────────────┘    │                 │ ───► │ Linux GNSS Client │
+│    < 2cm GNSS fix     │       ▲                       │      Socat      │      │                   │
+│                       ├───────┘               │       │                 │      └───────────────────┘
+│                       │                       └────►  │ VIRT0 --> VIRT1 │
+└───────────────────────┘                               │     Virtual     │      ┌───────────────────┐
+                                                        │   serial port   │      │                   │
+                                                        │                 │      │     u-center      │
+                                                        └─────────────────┘      │  u-blox gps tool  │
+                                                                                 │   Windows ONLY    │
+                                                                                 │  Configuration &  │
+                                                                                 │   Visualization   │
+                                                                                 │                   │
+                                                                                 └───────────────────┘
+
+}}}
+