You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Added a new section to the documentation detailing the firmware update process for the LG290P module, including references to the official manual and firmware sources. Included a warning about the synchronization step and instructions for using the QGNSS software's reboot button, along with a new image illustrating the reboot button.
@@ -178,10 +177,37 @@ The settings for the messages transmitted from the QConsole.
178
177
</figure>
179
178
180
179
181
-
### PyGPSClient
182
180
181
+
#### Firmware Update
182
+
In the event that users need to update the firmware on the LG290P module, please refer to the instructions in Quectel's [reference manual](./assets/component_documentation/quectel_lg290p03_firmware_upgrade_guide_v1-0.pdf). For the latest firmware, users should reach out to Quectel through their [forum page](https://forums.quectel.com/); otherwise, we have some of the firmware releases available in one of our [GitHub repositories](https://github.com/sparkfun/SparkFun_RTK_Postcard/tree/main/Firmware).
In the [reference manual](./assets/component_documentation/quectel_lg290p03_firmware_upgrade_guide_v1-0.pdf), **Step 9** instructs users to wait for a synchronization process. If users refer to an earlier section of the manual, this process requires the LG290P module to receive a `SYNC_WORD1` within 500ms of powering up. Therefore, users must restart the module during the synchronization step. In the QGNSS software *(+v2.1)*, this can be performed with the reboot button.
194
+
195
+
196
+
<figure markdown>
197
+
[{ width="400" }](./assets/img/hookup_guide/qgnss-reboot_button.png "Click to enlarge")
198
+
<figcaption markdown>Reboot button in the QGNSS software *(v2.1)*.</figcaption>
199
+
</figure>
200
+
201
+
202
+
!!! tip
203
+
For previous versions of the QGNSS software, prior to initializing the firmware upgrade process, users can send the `PQTMSRR` message to perform a system reset and reboot the GNSS receiver. We recommend having everything pre-configured to upgrade the firmware as the module usually initializes within 5s of sending the `PQTMSRR` message.
204
+
205
+
206
+
207
+
### PyGPSClient
183
208
As an alternative to QGNSS, for users with computers that run on MacOS or Linux (_including Raspberry Pi_), we recommend [PyGPSClient](https://github.com/semuconsulting/PyGPSClient) as an option for configuring the LG290P (_via proprietary NMEA sentences_), viewing standard and proprietary NMEA data from the receiver and connecting to an NTRIP caster.
184
209
210
+
185
211
??? info "Resources"
186
212
For additional information, users can refer to the following resources for the PyGPSClient software:
187
213
@@ -191,9 +217,11 @@ As an alternative to QGNSS, for users with computers that run on MacOS or Linux
There are a variety of [installation methods](https://github.com/semuconsulting/PyGPSClient?tab=readme-ov-file#installation) detailed in the GitHub repository's `README.md` file. However, we recommend utilizing the `pip` installation method.
196
223
224
+
197
225
!!! terminal "Installation Commands"
198
226
Depending on how Python is installed on the computer, one of the following commands should allow users to install the software.
199
227
@@ -206,10 +234,12 @@ There are a variety of [installation methods](https://github.com/semuconsulting/
206
234
pip install --upgrade pygpsclient
207
235
```
208
236
237
+
209
238
!!! info "System Requirements"
210
239
This installation method requires an internet connection. Additionally, users may need administrative privileges *(or root access `sudo`)* for some installations.
211
240
212
241
242
+
213
243
#### Connecting to the LG290P
214
244
Before users can connect to the Quad-band GNSS RTK breakout board, they will need to specify the settings of the UART port in PyGPSClient. Once configured, users can select the <kbd>:material-usb:</kbd> button and PyGPSClient will automatically attempt to connect to the GNSS module. If the UART port does not appear in the Serial Port list in the PyGPSClient UI, it can be added as a user-defined port e.g. `/dev/ttyAMA0`.
215
245
@@ -247,6 +277,7 @@ Specify the settings for the UART port in QGNSS.
247
277
</div>
248
278
249
279
280
+
250
281
### Terminal Emulator
251
282
Another viable option for connecting to the Quad-band GNSS RTK breakout board, is to utilize a [terminal emulation program](https://learn.sparkfun.com/tutorials/112). While reading the data sent from the LG290P is relatively trivial, users will need to be more selective when choosing an emulator to configure the LG290P module on the Quad-band GNSS RTK breakout board. This is due to the unique data structure of the proprietary messages that Quectel implements to configure the LG290P *(see the [**Configure the LG290P**](#configure-the-lg290p) section, above)*.
0 commit comments