docs: Update documentation for FoBE Quill nRF52840 and ESP32S3 Mesh

chihosin · chihosin · commit ded60e8b062b · 2025-08-09T18:03:07.000+08:00
- Clarified instructions for firmware installation and programming.
- Improved voltage measurement explanations and calculations.
- Corrected minor grammatical errors for better readability.

Signed-off-by: ChihoSin chihosin@icloud.com
diff --git a/docs/product/f1101/applications.mdx b/docs/product/f1101/applications.mdx
@@ -43,7 +43,7 @@ Double click the **Reset** button, there should be a `FoBE Boot` drive on your P
 
 <br/><div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-21-14-46-54.png" alt="2025-07-21-14-46-54.png" style={{ width: '20%', height: 'auto' }} /></div><br/>
 
-Drag the `firmware-fobe_quill_nrf52840_mesh-2.7.3.cf574c7.uf2` file to the driver. The download will run automatically, then the driver will log out.
+Drag the `firmware-fobe_quill_nrf52840_mesh-2.7.3.cf574c7.uf2` file to the drive. The installation will run automatically, then the drive will disappear.
 
 </TabItem>
 <TabItem value="hex">
@@ -64,6 +64,6 @@ adafruit-nrfutil --verbose dfu serial --package firmware-fobe_quill_nrf52840_mes
 </TabItem>
 </Tabs>
 
-That your can use the FoBE Quill nRF52840 Mesh with the Meshtastic network, you can now use the Meshtastic app to configure your device and start using it.
+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.
 
 More information can be found in the [Meshtastic documentation](https://meshtastic.org/docs/).
diff --git a/docs/product/f1101/index.mdx b/docs/product/f1101/index.mdx
@@ -22,7 +22,7 @@ order: 1
 </div>
 ## Introduction
 
-The FoBE Quill nRF52840 Mesh is a compact and versatile development platform for IoT solutions. It combines Nordic's high-end multiprotocol SoC, the nRF52840, with Semtech's ultra-low-power sub-GHz radio transceiver, the SX1262 (packaged using SiP technology). Designed for IoT applications, it offers a comprehensive wireless connectivity solution, supporting protocols such as Bluetooth 5, Thread, Zigbee, IEEE 80.2.15.4, and LoRa®.
+The FoBE Quill nRF52840 Mesh is a compact and versatile development platform for IoT solutions. It combines Nordic's high-end multiprotocol SoC, the nRF52840, with Semtech's ultra-low-power sub-GHz radio transceiver, the SX1262. Designed for IoT applications, it offers a comprehensive wireless connectivity solution, supporting protocols such as Bluetooth 5, Thread, Zigbee, IEEE 80.2.15.4, and LoRa®.
 
 This development board is feature-rich, including a battery charger, dedicated power path management, an ultra-low quiescent current DC-DC converter, a 1.14-inch color IPS display, user-programmable LEDs and buttons, an MFP expansion connector, a reversible USB-C connector, and header sockets for easy expansion.
 
@@ -106,7 +106,7 @@ This development board is feature-rich, including a battery charger, dedicated p
             <td>Bluetooth® 5, Thread, Zigbee, IEEE 802.15.4, NFC-A Tag, 2.4 GHz proprietary<br/>Embedded SMD ceramic antenna</td>
         </tr>
         <tr>
-            <td>ASR6500 on Board</td>
+            <td>SX1262 on Board</td>
             <td>LoRa® (470 MHz for Model SLT, 868 - 915 MHz for Model SHT)<br/>iPEX-U.FL connector for sub-GHz external antenna</td>
         </tr>
         <tr>
diff --git a/docs/product/f1101/programming.mdx b/docs/product/f1101/programming.mdx
@@ -18,7 +18,7 @@ You can follow the official guide of [PlatformIO](https://platformio.org/platfor
 
     1. Open the **PlatformIO Home** and navigate to **Platforms**.
     2. Click "Advanced Installation" button.
-    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.
+    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.
 
     <br/><div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-19-02-24-59.png" alt="2025-07-19-02-24-59.png" style={{ width: '80%', height: 'auto' }} /></div><br/>
 
@@ -67,20 +67,20 @@ To install the MicroPython firmware, follow these steps:
 #### UF2 with USB Storage
 
     1. Download the latest firmware file with the `.uf2` extension.
-    2. Connect the FoBE Quill nRF52840 Mesh to your computer.
+    2. Connect the FoBE Quill nRF52840 Mesh to your computer using a USB-C cable.
     3. Double-click the reset button on the device to enter bootloader mode.
 
 <br/><div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-21-10-48-27.png" alt="2025-07-21-10-48-27.png" style={{ width: '80%', height: 'auto' }} /></div><br/>
 
-    3. Copy the `.uf2` file to the device storage "FoBE Boot".
-    4. The device will reboot automatically, and the MicroPython firmware will be installed.
+    4. Copy the `.uf2` file to the device storage "FoBE Boot".
+    5. The device will reboot automatically, and the MicroPython firmware will be installed.
 
 #### HEX with OpenOCD (CMSIS-DAP)
 
 Hex files are used for programming the device using OpenOCD. Please make sure OpenOCD is installed and configured correctly.
 
     1. Download the latest firmware file with the `.hex` extension.
-    2. Connect the FoBE Quill nRF52840 Mesh to your computer.
+    2. Connect the FoBE Quill nRF52840 Mesh to your computer using a USB-C cable.
     3. Connect the debug interface (CMSIS-DAP) to the FoBE Quill nRF52840 Mesh.
     4. Open a terminal and run the following command:
 
@@ -139,122 +139,122 @@ Before you start, make sure you have Python installed on your system.
     2. Create a virtual environment for the project:
 
     ```bash
-        # Create a new directory for the project
-        python3 -m venv .venv
+    # Create a virtual environment
+    python3 -m venv .venv
 
-        # Activate the virtual environment
-        source .venv/bin/activate
+    # Activate the virtual environment
+    source .venv/bin/activate
 
-        # Install the required packages
-        pip install west
+    # Install the required packages
+    pip install west
     ```
 
     3. Create `.west/config` file in the project directory with the following content:
 
     ```ini
-        [manifest]
-        path = app
-        file = west.yml
+    [manifest]
+    path = app
+    file = west.yml
 
-        [zephyr]
-        base = zephyr
-        ```
+    [zephyr]
+    base = zephyr
+    ```
     4. Create app folder and add some files like:
 
-        ```
-        .west/
-        └── config
-        app/
-        ├── CMakeLists.txt
-        ├── prj.conf
-        ├── west.yml
-        └── src
-            └── main.c
-        ```
-
-        Add `CMakeLists.txt` file with the following content:
-
-        ```cmake
-        cmake_minimum_required(VERSION 3.20.0)
-        find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
-        project(app)
-
-        target_sources(app PRIVATE src/main.c)
-        ```
-
-        Add `prj.conf` file with the following content:
-
-        ```ini
-        CONFIG_GPIO=y
-        ```
-
-        Add `west.yml` file with the following content:
-
-        ```yaml
-        manifest:
-        remotes:
-            - name: zephyr
-                url-base: https://github.com/zephyrproject-rtos
-            - name: fobe
-                url-base: https://github.com/fobe-projects
-        projects:
-            - name: zephyr
-                remote: zephyr
-                revision: main
-                path: zephyr
-                import: true
-            - name: fobe-zephyr-sdk
-                remote: fobe
-                path: fobe
-                revision: main
-        ```
-
-        Add `src/main.c` file with the following content:
-
-        ```c
-        #include <stdio.h>
-        #include <zephyr/kernel.h>
-        #include <zephyr/drivers/gpio.h>
-
-        /* 1000 msec = 1 sec */
-        #define SLEEP_TIME_MS 1000
-
-        /* The devicetree node identifier for the "led0" alias. */
-        #define LED0_NODE DT_ALIAS(led0)
-
-        /*
-        * A build error on this line means your board is unsupported.
-        * See the sample documentation for information on how to fix this.
-        */
-        static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios);
-
-        int main(void)
-        {
-            int ret;
-            bool led_state = true;
-
-            if (!gpio_is_ready_dt(&led)) {
-                return 0;
-            }
+    ```
+    .west/
+    └── config
+    app/
+    ├── CMakeLists.txt
+    ├── prj.conf
+    ├── west.yml
+    └── src
+        └── main.c
+    ```
+
+    Add `CMakeLists.txt` file with the following content:
+
+    ```cmake
+    cmake_minimum_required(VERSION 3.20.0)
+    find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+    project(app)
+
+    target_sources(app PRIVATE src/main.c)
+    ```
+
+    Add `prj.conf` file with the following content:
+
+    ```ini
+    CONFIG_GPIO=y
+    ```
+
+    Add `west.yml` file with the following content:
+
+    ```yaml
+    manifest:
+    remotes:
+        - name: zephyr
+            url-base: https://github.com/zephyrproject-rtos
+        - name: fobe
+            url-base: https://github.com/fobe-projects
+    projects:
+        - name: zephyr
+            remote: zephyr
+            revision: main
+            path: zephyr
+            import: true
+        - name: fobe-zephyr-sdk
+            remote: fobe
+            path: fobe
+            revision: main
+    ```
+
+    Add `src/main.c` file with the following content:
 
-            ret = gpio_pin_configure_dt(&led, GPIO_OUTPUT_ACTIVE);
+    ```c
+    #include <stdio.h>
+    #include <zephyr/kernel.h>
+    #include <zephyr/drivers/gpio.h>
+
+    /* 1000 msec = 1 sec */
+    #define SLEEP_TIME_MS 1000
+
+    /* The devicetree node identifier for the "led0" alias. */
+    #define LED0_NODE DT_ALIAS(led0)
+
+    /*
+    * A build error on this line means your board is unsupported.
+    * See the sample documentation for information on how to fix this.
+    */
+    static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios);
+
+    int main(void)
+    {
+        int ret;
+        bool led_state = true;
+
+        if (!gpio_is_ready_dt(&led)) {
+            return 0;
+        }
+
+        ret = gpio_pin_configure_dt(&led, GPIO_OUTPUT_ACTIVE);
+        if (ret < 0) {
+            return 0;
+        }
+
+        while (1) {
+            ret = gpio_pin_toggle_dt(&led);
             if (ret < 0) {
                 return 0;
             }
 
-            while (1) {
-                ret = gpio_pin_toggle_dt(&led);
-                if (ret < 0) {
-                    return 0;
-                }
-
-                led_state = !led_state;
-                printf("LED state: %s\n", led_state ? "ON" : "OFF");
-                k_msleep(SLEEP_TIME_MS);
-            }
-            return 0;
+            led_state = !led_state;
+            printf("LED state: %s\n", led_state ? "ON" : "OFF");
+            k_msleep(SLEEP_TIME_MS);
         }
-        ```
+        return 0;
+    }
+    ```
     5. Install and configure the Zephyr SDK:
 
     ```bash
diff --git a/docs/product/f1101/quickstart.mdx b/docs/product/f1101/quickstart.mdx
@@ -59,11 +59,15 @@ Power consumption measurements were performed while powering the board with a si
 
 Battery voltage is measured using a voltage divider with high-precision thick film resistors. The high-side resistor (R1) is 1M Ohm, and the low-side resistor (R2) is 1.5M Ohm. The SoC's **P0.05** GPIO is connected to the measurement point.
 
-For a voltage divider circuit with two resistors, R1 and R2, in series, where Vin is the input voltage and Vout is the voltage across R2:
+For a voltage divider circuit with two resistors, R1 and R2, in series, where Vin is the input voltage (battery voltage) and Vout is the voltage across R2 (measured by the ADC):
 
 **Vout = Vin * (R2 / (R1 + R2))**
 
-By reading the voltage at the measurement point with the ADC, the battery voltage can be calculated using this formula.
+In this case: **Vout = Vin * (1.5M / (1M + 1.5M)) = Vin * 0.6**
+
+Therefore: **Vin = Vout / 0.6 = Vout * 1.667**
+
+By reading the voltage at the measurement point with the ADC, the battery voltage can be calculated by multiplying the measured voltage by 1.667.
 
 ## General purpose I/Os
 
@@ -245,8 +249,8 @@ void loop()
   // Read battery voltage
   int raw = analogRead(PIN_VBAT);
   float vref = 3.0; // ADC reference voltage
-  float vmeas = raw * vref / 4095.0;
-  float voltage = vmeas * 1.72; // Adjusted for the voltage divider, assuming r1 and r2 are not used here
+  float vmeas = raw * vref / 4095.0; // Measured voltage at ADC pin
+  float voltage = vmeas * 1.667; // Calculate actual battery voltage using voltage divider ratio
   Serial.print("Battery voltage: ");
   Serial.print(voltage);
   Serial.println(" V");
diff --git a/docs/product/f1102/applications.mdx b/docs/product/f1102/applications.mdx
@@ -43,12 +43,12 @@ Double click the **Reset** button, there should be a `FoBE Boot` drive on your P
 
 <br/><div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-21-14-46-54.png" alt="2025-07-21-14-46-54.png" style={{ width: '20%', height: 'auto' }} /></div><br/>
 
-Drag the `firmware-fobe_quill_esp32s3_mesh-2.7.3.cf574c7.uf2` file to the driver. The download will run automatically, then the driver will log out.
+Drag the `firmware-fobe_quill_esp32s3_mesh-2.7.3.cf574c7.uf2` file to the drive. The installation will run automatically, then the drive will disappear.
 
 </TabItem>
 <TabItem value="hex">
 
-This is recommended method, to install latest version:
+This is the recommended method to install the latest version:
 
 ```shell
 pip3 install --user adafruit-nrfutil
@@ -64,6 +64,6 @@ adafruit-nrfutil --verbose dfu serial --package firmware-fobe_quill_nrf52840_mes
 </TabItem>
 </Tabs>
 
-That your can use the FoBE Quill ESP32S3 Mesh with the Meshtastic network, you can now use the Meshtastic app to configure your device and start using it.
+Now you can use the FoBE Quill ESP32S3 Mesh with the Meshtastic network. You can use the Meshtastic app to configure your device and start using it.
 
 More information can be found in the [Meshtastic documentation](https://meshtastic.org/docs/).
diff --git a/docs/product/f1102/index.mdx b/docs/product/f1102/index.mdx
@@ -23,9 +23,9 @@ order: 1
 
 ## Introduction
 
-The FoBE Quill ESP32S3 Mesh is a compact and feature-rich IoT development platform, integrating Espressif's high-performance multi-protocol SoC ESP32-S3 and Semtech's ultra-low-power sub-GHz radio transceiver SX1262 (SiP package). Designed for IoT applications, it provides a comprehensive wireless connectivity solution supporting IEEE 802.11 b/g/n Wi-Fi, Bluetooth 5, Thread, Zigbee, and LoRa®.
+The FoBE Quill ESP32S3 Mesh is a compact and feature-rich IoT development platform, integrating Espressif's high-performance multi-protocol SoC ESP32-S3 and Semtech's ultra-low-power sub-GHz radio transceiver SX1262. Designed for IoT applications, it provides a comprehensive wireless connectivity solution supporting IEEE 802.11 b/g/n Wi-Fi, Bluetooth 5, Thread, Zigbee, and LoRa®.
 
-This development board features efficient battery charging management, discrete power path, ultra-low quiescent current DC-DC converter, a 1.3-inch 16-pin OLED display (SSD1312 driver), user-programmable LED and button, MFP expansion connector, reversible USB-C connector, and easy-to-expand pin headers, making it ideal for rapid prototyping and development.
+This development board features efficient battery charging management, discrete power path, ultra-low quiescent current DC-DC converter, a 1.3-inch monochrome OLED display (SSD1306 compatible), user-programmable LED and button, MFP expansion connector, reversible USB-C connector, and easy-to-expand pin headers, making it ideal for rapid prototyping and development.
 
 ## Tech specs
 <table>
@@ -129,7 +129,7 @@ This development board features efficient battery charging management, discrete
         </tr>
         <tr>
             <td>Driver</td>
-            <td>SSD1312</td>
+            <td>SSD1306 compatible</td>
         </tr>
         <tr>
             <td colspan="1" rowspan="2">Buttons</td>
diff --git a/docs/product/f1102/programming.mdx b/docs/product/f1102/programming.mdx
diff --git a/docs/product/f1102/quickstart.mdx b/docs/product/f1102/quickstart.mdx
