Skip to content

Commit af3cce3

Browse files
Update README
1 parent 9e5ccc1 commit af3cce3

File tree

2 files changed

+77
-29
lines changed

2 files changed

+77
-29
lines changed

README.md

Lines changed: 77 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,101 @@
1-
SparkFun <PRODUCT NAME>
1+
SparkFun GNSS Flex System
22
========================================
33

4-
[![SparkFun Part Name](URL for picture of part)](URL for product on Sparkfun.com)
4+
![SparkFun GNSS Flex System](./banner-repo.png)
55

6-
[*SparkFun Part Name (SKU)*](URL for product on Sparkfun.com)
6+
Our GNSS Flex system is designed to be modular with two board types:
77

8-
<Basic description of the part.>
8+
- *Plug-in Modules*
99

10-
Repository Contents
11-
-------------------
10+
Each SparkPNT GNSS Flex module features a different GNSS receiver. These boards breakout the various interfaces of a GNSS receiver to the standardized female headers of the GNSS Flex system. This allows users to easily repair and upgrade their system's GNSS receiver.
11+
12+
- *Carrier Boards*
13+
14+
These boards host GNSS Flex modules on the standardized male headers of the GNSS Flex system. Their designs usually have a specific intention; such as a breakout board, Raspberry Pi pHAT, SparkPNT product line, etc.
15+
16+
The entire ecosystem is centered around two 2x10-pin, 2mm pitch headers that mate the two types of boards. A standardized pin layout, keeps the ecosystem pin-compatible for upgrades and allows board to be easily swapped for repairs. Depending on the capabilities of the GNSS receiver, these pins will breakout the USB, UART (x4), I<sup>2</sup>C, and SD card interfaces along with any PPS or event signals of the GNSS receiver.
17+
18+
![Pin Layout for the GNSS Flex System](./docs/assets/img/hookup_guide/pinout.png)
19+
20+
> [!IMPORTANT]
21+
> Depending on the SparkPNT GNSS Flex module, these product will likely require an external antenna:
22+
>
23+
> - Be sure to check out the hookup guide for more information on the GNSS Flex module.
24+
> - Users can also find [GNSS Antennas](https://www.sparkfun.com/gnss/gnss-antennas.html) in our catalog.
25+
>
26+
> Users will have two options for connecting an external GNSS antenna to their GNSS receiver.
27+
>
28+
> - The GNSS Flex modules will usually come with a U.FL connector for external antenna.
29+
> - For a sturdier connection, a SMA connector on a *carrier board* can utilized. Users can simply jumper the U.FL connectors between the SparkPNT GNSS Flex module and the *carrier board* with a short U.FL cable.
1230
13-
* **/Documentation** - Data sheets, additional product information
14-
* **/Enclosure** - Enclosure files
15-
* **/Firmware** - Example code
16-
* **/Hardware** - Eagle design files (.brd, .sch)
17-
* **/Libraries** - Libraries for use with the <PRODUCT NAME>
18-
* **/Production** - Production panel files (.brd)
19-
* **/Software** - Related software for the <PRODUCT NAME>
2031

2132
Documentation
2233
--------------
23-
* **[Library](GitHub library URL)** - <LANGUAGE> library for the <PRODUCT NAME>.
24-
* **[Hookup Guide](Learn.SparkFun URL)** - Basic hookup guide for the <PRODUCT NAME>.
25-
* **[SparkFun Fritzing repo](https://github.com/sparkfun/Fritzing_Parts)** - Fritzing diagrams for SparkFun products.
26-
* **[SparkFun 3D Model repo](https://github.com/sparkfun/3D_Models)** - 3D models of SparkFun products.
27-
* **[SparkFun Graphical Datasheets](https://github.com/sparkfun/Graphical_Datasheets)** -Graphical Datasheets for various SparkFun products.
34+
- **[Hookup Guide (mkdocs)](http://docs.sparkfun.com/SparkFun_GNSS_Flex_System/)** - A hookup guide for the entire ecosystem of SparkFun GNSS Flex carrier boards and SparkPNT GNSS Flex modules, hosted by GitHub pages.<br>
35+
[![Built with Material for MkDocs](https://img.shields.io/badge/Material_for_MkDocs-526CFE?logo=MaterialForMkDocs&logoColor=white)](https://squidfunk.github.io/mkdocs-material/) [![GitHub Pages Deploy](https://github.com/sparkfun/SparkFun_GNSS_Flex_System/actions/workflows/build_documentation.yml/badge.svg)](https://github.com/sparkfun/SparkFun_GNSS_Flex_System/actions/workflows/build_documentation.yml)
36+
37+
*Need to download or print our hookup guide?*
38+
39+
- [Print *(Print to PDF)* from Single-Page View](http://docs.sparkfun.com/SparkFun_GNSS_Flex_System/print_view)
40+
2841

29-
Product Versions
42+
Repository Contents
43+
-------------------
44+
- **[/docs](/docs/)** - Online documentation files
45+
- [/assets](/docs/assets/) - Assets files
46+
- [/component_documentation](/docs/assets/component_documentation/) - Datasheets for GNSS Flex system's standards
47+
- [/img/hookup_guide](/docs/assets/img/hookup_guide/) - Images for hookup guide documentation
48+
- [/flex_boards](/flex_boards/)
49+
- /`<name>` - GNSS Flex board *(or associated GitHub submodule)*
50+
- /docs - Documentation files for the board
51+
- /assets - Assets files for the board
52+
- /3d_model - 3D models for the board
53+
- /board_files - Design files for the board
54+
- KiCad Design Files (.zip)
55+
- Schematic (.pdf)
56+
- Dimensions (.pdf)
57+
- /component_documentation - Datasheets for the board
58+
- /img/hookup_guide - Hookup guide images for the board
59+
- /Hardware - Hardware design files (.brd, .sch)
60+
- /Production - Production files
61+
62+
63+
Product Variants
3064
----------------
31-
* [Part SKU](part URL) - Basic part and short description here
32-
* [Retail part SKU](retail URL) - Retail packaging of standard description here
33-
* [Any other parts this repo covers](any other URLs) - Description of said parts
65+
66+
- GNSS Flex pHAT:
67+
- [GPS-28137](https://www.sparkfun.com/sparkfun-gnss-flex-phat.html)
68+
- Kits:
69+
- [GPS-28766](https://www.sparkfun.com/sparkfun-gnss-flex-phat-mosaic-x5.html) - GNSS Flex pHAT w/ the Septentrio mosaic-X5 GNSS Flex module
70+
- [GPS-28929](https://www.sparkfun.com/sparkfun-gnss-flex-phat-lg290p.html) - GNSS Flex pHAT w/ the Quectel LG290P GNSS Flex module
71+
- GNSS Modules:
72+
- [GPS-28138](https://www.sparkfun.com/sparkpnt-gnss-flex-module-mosaic-x5.html) - Septentrio mosaic-X5 GNSS Flex module
73+
- [GPS-28139](https://www.sparkfun.com/sparkpnt-gnss-flex-module-lg290p.html) - Quectel LG290P GNSS Flex module
74+
3475

3576
Version History
3677
---------------
37-
* [vExxFxxZxxHxxLxxSxx](URL for tag specific to this version) - Description
38-
* [vEyyFyyZyyHyyLyySyy](URL for tag specific to this version) - Description
78+
- [r2025-05](https://github.com/sparkfun/SparkFun_GNSS_Flex_System/releases/tag/r2025-05) - Initial Release
79+
80+
81+
> [!NOTE]
82+
>
83+
> The format of the release tag `r[year]-[month][iteration]`
84+
>
85+
> - **year:** `YYYY` Format
86+
> - **month:** `MM` Format
87+
> - **iteration:** Revisions for that month *(i.e. `none`, `a`, `b`, etc.)*
88+
3989

4090
License Information
4191
-------------------
4292

43-
This product is _**open source**_!
93+
This product is ***open source***!
4494

45-
Please review the LICENSE.md file for license information.
95+
Please review the [`LICENSE.md`](./LICENSE.md) file for license information.
4696

47-
If you have any questions or concerns on licensing, please contact technical support on our [SparkFun forums](https://forum.sparkfun.com/viewforum.php?f=152).
97+
If you have any questions or concerns about licensing, please contact technical support on our [SparkFun forums](https://forum.sparkfun.com/viewforum.php?f=152).
4898

4999
Distributed as-is; no warranty is given.
50100

51101
- Your friends at SparkFun.
52-
53-
_<COLLABORATION CREDIT>_

banner-repo.png

666 KB
Loading

0 commit comments

Comments
 (0)