Skip to content

Commit 710dfad

Browse files
chihosinchihosin
committed
docs: update MicroPython and FoBE programming guides
- Changed image format from JPG to WEBP for MicroPython documentation. - Enhanced instructions in the FoBE Quill nRF52840 and ESP32S3 programming guides for clarity. - Added new programming guide for FoBE Mesh Tracker C1. - Updated quickstart guide to reflect compatibility with FoBE Mesh Tracker C1. Signed-off-by: Chiho Sin <[email protected]>
1 parent 15db4e4 commit 710dfad

File tree

6 files changed

+119
-55
lines changed

6 files changed

+119
-55
lines changed

‎docs/platform/micropython.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ last_update:
1616

1717
<br/>
1818
<div style={{ textAlign: 'left' }}>
19-
<img src="/img/apps/micropython.logo.jpg" alt="MicroPython" style={{ width: '120px', height: 'auto' }} />
19+
<img src="/img/apps/micropython.logo.webp" alt="MicroPython" style={{ width: '120px', height: 'auto' }} />
2020
</div>
2121
<br/>
2222

‎docs/product/f1101/programming.mdx‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,10 @@ You can follow the official guide of [PlatformIO](https://platformio.org/platfor
5656
### Create a new project
5757

5858
1. Open the **PlatformIO Home** and navigate to **Projects**.
59-
2. Click "New Project" button.
60-
3. Input the project name, select the board "FoBE Quill nRF52840 Mesh", and select the framework "Arduino".
61-
4. Click "Finish" button, waiting for the project created.
59+
2. Click ```New Project``` button.
60+
3. Input the project **name**, select the board ```FoBE Quill nRF52840 Mesh```, and select the framework ```Arduino```.
61+
4. Click ```Finish``` button, waiting for the project created.
62+
5. Open the `src/main.cpp` file and write your code.
6263

6364
<div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-19-02-04-49.webp" alt="Guide Screenshot" style={{ width: '80%', height: 'auto' }} /></div>
6465

‎docs/product/f1102/programming.mdx‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,10 @@ You can follow the official guide of [PlatformIO](https://platformio.org/platfor
5656
### Create a new project
5757

5858
1. Open the **PlatformIO Home** and navigate to **Projects**.
59-
2. Click "New Project" button.
60-
3. Input the project name, select the board "FoBE Quill ESP32S3 Mesh", and select the framework "Arduino".
61-
4. Click "Finish" button, waiting for the project created.
59+
2. Click ```New Project``` button.
60+
3. Input the project **name**, select the board ```FoBE Quill ESP32S3 Mesh```, and select the framework ```Arduino```.
61+
4. Click ```Finish``` button, waiting for the project created.
62+
5. Open the `src/main.cpp` file and write your code.
6263

6364
<div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-08-07-04-15-50.webp" alt="Guide Screenshot" style={{ width: '80%', height: 'auto' }} /></div>
6465

‎docs/product/f2102/programming.mdx‎

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
---
2+
title: Programming with FoBE Mesh Tracker C1
3+
description: Programming with FoBE Mesh Tracker C1.
4+
sidebar_label: Programming
5+
image: /img/products/f2102-r1lg.main.webp
6+
slug: /mesh_tracker_c1_programming
7+
toc_max_heading_level: 4
8+
sidebar_position: 2
9+
keywords:
10+
- FoBE
11+
- nRF52840
12+
- Mesh
13+
- LoRa
14+
tags:
15+
- FoBE
16+
- nRF52840
17+
- Mesh
18+
- LoRa
19+
- Zephyr
20+
- MicroPython
21+
- CircuitPython
22+
- Arduino
23+
last_update:
24+
date: 10/30/2025
25+
author: Fernando
26+
---
27+
28+
# Programming with FoBE Mesh Tracker C1
29+
30+
This guide describes how to program the FoBE Mesh Tracker C1.
31+
32+
## Arduino
33+
34+
The following describes how to program the FoBE Mesh Tracker C1 with Arduino using PlatformIO.
35+
36+
### Install PlatformIO
37+
38+
You can follow the official guide of [PlatformIO](https://platformio.org/platformio-ide) to complete the installation.
39+
40+
### Add Platform repository
41+
42+
1. Open the **PlatformIO Home** and navigate to **Platforms**.
43+
2. Click "Advanced Installation" button.
44+
3. Input the git repository URL ```https://github.com/fobe-projects/fobe-nrf52-platformio.git#develop``` then click "Install" button, and wait for the installation to complete.
45+
46+
<div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-19-02-24-59.webp" alt="Guide Screenshot" style={{ width: '80%', height: 'auto' }} /></div>
47+
48+
Or you can use the **pio** command line tool to install:
49+
50+
```bash
51+
pio pkg install --platform https://github.com/fobe-projects/fobe-nrf52-platformio.git#develop
52+
```
53+
54+
### Create a new project
55+
56+
1. Open the **PlatformIO Home** and navigate to **Projects**.
57+
2. Click ```New Project``` button.
58+
3. Input the project **name**, select the board ```FoBE Mesh Tracker C1```, and select the framework ```Arduino```.
59+
4. Click ```Finish``` button, waiting for the project created.
60+
5. Open the `src/main.cpp` file and write your code.
61+
62+
<div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-19-02-24-07.webp" alt="Guide Screenshot" style={{ width: '80%', height: 'auto' }} /></div>
63+
64+
6. Click the "Upload" button to compile and upload your code.
65+
66+
<div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-19-02-25-52.webp" alt="Guide Screenshot" style={{ width: '80%', height: 'auto' }} /></div>
67+
68+
69+
## MicroPython
70+
71+
[MicroPython](https://micropython.org) is a lean and efficient implementation of the Python 3
72+
programming language that includes a small subset of the Python standard library and is
73+
optimised to run on microcontrollers and in constrained environments.
74+
75+
To flash and run the **MicroPython** onto your device, please refer to the instructions in [Platform MicroPython](/micropython_programming).
76+
77+
## CircuitPython
78+
79+
[CircuitPython](https://circuitpython.org) is a version of Python designed to run on microcontrollers. It is based on MicroPython and includes additional features and libraries to simplify experimentation and learning.
80+
81+
To flash and run the **CircuitPython** onto your device, please refer to the instructions in [Platform CircuitPython](/circuitpython_programming).
82+
83+
## Zephyr
84+
85+
The [Zephyr OS](https://zephyrproject.org) is based on a small-footprint kernel designed for use on resource-constrained and embedded systems: from simple embedded environmental sensors and LED wearables to sophisticated embedded controllers, smart watches, and IoT wireless applications.
86+
87+
To start the **Zephyr** firmware project onto your device, please refer to the instructions in
88+
[Platform Zephyr - Install](/zephyr_rtos_programming#setup).
89+
90+
:::info
91+
Project Board ID for FoBE Mesh Tracker C1
92+
- ```mesh_tracker_c1```
93+
:::

‎docs/product/f2102/quickstart.mdx‎

Lines changed: 16 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -170,60 +170,29 @@ The board features a jumper pad:
170170

171171
[Meshtastic](https://meshtastic.org) is a popular open-source project that allows you to create an off-grid, decentralized mesh network built to run on affordable, low-power devices.
172172

173-
The FoBE Quill nRF52840 Mesh is compatible with Meshtastic, allowing you to build your own mesh network using this development board.
173+
The FoBE Mesh Tracker C1 is compatible with **Meshtastic**, allowing you to build your own mesh network using this development board.
174174

175-
#### Flashing firmware
175+
:::tip
176+
Get and Flash the latest Meshtastic firmware from the [Firmware Hub](/firmware-hub?id=fobe_idea_mesh_tracker_c1).
177+
:::
176178

177-
This tutorial will guide users to flash the FoBE Quill nRF52840 Mesh to the Meshtastic version, for those who want to use the Meshtastic network.
179+
:::info
180+
Source code is available on the [FoBE Meshtastic Firmware Repository](https://github.com/fobe-projects/meshtastic-firmware).
181+
:::
178182

179-
#### Preparation
183+
### MeshCore
180184

181-
- FoBE Quill nRF52840 Mesh Board x 1
182-
- USB-C cable x 1
183-
- Computer with Python 3 installed
185+
[MeshCore](https://meshcore.co.uk) is a multi platform system for enabling secure text based communications utilising LoRa radio hardware. It can be used for Off-Grid Communication, Emergency Response & Disaster Recovery, Outdoor Activities, Tactical Security including law enforcement and private security and also IoT sensor networks.
184186

185-
#### Wiring
187+
The FoBE Mesh Tracker C1 is compatible with **MeshCore**, allowing you to build your own mesh network using this development board.
186188

187-
Connect the FoBE Quill nRF52840 Mesh to your computer using a USB-C cable.
189+
:::tip
190+
Get and Flash the latest MeshCore firmware from the [Firmware Hub](/firmware-hub?id=fobe_idea_mesh_tracker_c1).
191+
:::
188192

189-
#### Flash Meshtastic firmware
190-
191-
Download the latest firmware from the [Firmware Hub](/firmware-hub?id=fobe_idea_mesh_tracker_c1).
192-
193-
<Tabs defaultValue="uf2" values={[
194-
{ label: "UF2", value: "uf2" },
195-
{ label: "Hex", value: "hex" },
196-
]}>
197-
<TabItem value="uf2">
198-
199-
Double click the **Reset** button, there should be a `FoBE Boot` drive on your PC.
200-
201-
<div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-21-14-46-54.webp" alt="Guide Screenshot" style={{ width: '20%', height: 'auto' }} /></div>
202-
203-
Drag the `firmware-fobe_idea_mesh_tracker_c1-2.7.3.cf574c7.uf2` file to the drive. The installation will run automatically, then the drive will disappear.
204-
205-
</TabItem>
206-
<TabItem value="hex">
207-
208-
This is recommended method, to install latest version:
209-
210-
```shell
211-
pip3 install --user adafruit-nrfutil
212-
```
213-
214-
To flash the firmware, run the following command:
215-
216-
```shell
217-
adafruit-nrfutil --verbose dfu serial --package firmware-fobe_quill_nrf52840_mesh-2.7.3.cf574c7.zip \
218-
--port <your_device_port> -b 115200
219-
```
220-
221-
</TabItem>
222-
</Tabs>
223-
224-
Now you can use the FoBE Quill nRF52840 Mesh with the Meshtastic network. You can use the Meshtastic app to configure your device and start using it.
225-
226-
More information can be found in the [Meshtastic documentation](https://meshtastic.org/docs/).
193+
:::info
194+
Source code is available on the [FoBE MeshCore Firmware Repository](https://github.com/fobe-projects/meshcore-firmware).
195+
:::
227196

228197
import FAQStructuredData from '../../../src/theme/DocFAQ';
229198

‎sidebars.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ module.exports = {
7575
{
7676
type: "category",
7777
label: "Mesh Tracker C1",
78-
items: ["product/f2102/quickstart"],
78+
items: ["product/f2102/quickstart", "product/f2102/programming"],
7979
},
8080
{
8181
type: "category",

0 commit comments

Comments
 (0)