capsule-firmware

doc/node/esp32/source/capsule_sensor_v3/index.rst

@@ -4,9 +4,22 @@ CapSule Sensor V3
 
 CapSule Sensor V3 is a IoT tiny toy based on ESP32S3 and SX1262. It has excellent expansibility, and we provides a variety of compatible sensor modules and uploading the relevant code for it, using these resources, even if you are not an expert in IoT development, you can easily build many interesting applications or directly run some open source programs like Meshtastick.
 
+Main Features:
+   - ESP32-S3 + SX1262.
+   - Wireless communication method include Wi-Fi, Bluetooth and LoRa.
+   - Modular design, with a BTB interface reserved at the bottom, capable of connecting and replacing different sensors
+   - Touch pad and LED indicator light.
+   - Built in 250mAh rechargeable battery, magnetic suction charging port.
+   - Built in LoRa and Wi-Fi/BLE antennas, stylish appearance, compact and light.
+   - High strength plastic, IP65 waterproof.
+   - Support Heltec Wireless Boot system, download firmware, exchange information, and print logs through Wi-Fi.
+   - Meshtastic project compatible.
+   - Secondary development can be done through Arduino, Platform.io, etc.
+
 .. toctree::
    :maxdepth: 2
 
     Quick Start <quick_start>
-    Install the Heltec ESP32 development environment <https://docs.heltec.org/en/node/esp32/esp32_general_docs/quick_start.html>
+    Heltec ESP32 development environment <https://docs.heltec.org/en/node/esp32/esp32_general_docs/quick_start.html>
     LoRaWAN <https://docs.heltec.org/en/node/esp32/esp32_general_docs/lorawan/index.html>
+

doc/node/esp32/source/capsule_sensor_v3/quick_start.md

@@ -1,29 +1,91 @@
-# Quick Start
+Quick Start
 
 {ht_translation}`[简体中文]:[English]`
 
 CapSule Sensor V3 uses Wireless Boot to download firmware, exchange information, and print logs through WiFi. 
 
-Long press the indicator light of the device for 16 seconds until the Blue light of the device is always on.
+## Run Wireless Boot
+1. Long press the indicator light of the device for 16 seconds until the Blue light of the device is always on.
 
 ![](img/01.png)
 
-Find "WirelessBoot_xxxx" on your PC and connect, the password is "heltec.org".
+2. Find "WirelessBoot_xxxx" on your PC and connect, the password is "heltec.org".
 
-![](img/02.jpg)
+![](img/02.png)
 
-Enter `192.168.4.1` in your browser to navigate to the WirelessBoot configuration page.
+3. Enter `192.168.4.1` in your browser to navigate to the WirelessBoot configuration page.
 
-![](img/03.png)
+![](img/10.png)
 
-Enter the WiFi account and password, click `Save Configuration`.
+```{Tip} Although you can connect directly to the Capsule's AP hotspot for uploading, this approach is simpler, but may lack stability. Connecting the PC and the capsule to the same LAN is the more stable mode of operation.
+
+```
+
+4. Enter the WiFi account and password, click `Save Configuration`.
 
 ![](img/04.png)
 
-At this point, the device connected to the local area network can interact with CapSule V3.
+5. Connect your computer to the LAN where the Capsule V3 is located.
+
+## Upload Firmware (Secondary Development)
+
+- [Via Arduino](via-arduino-capsule)
+- [Via Local File](via-local-file-capsule)
 
-Take Arduino as an example, if your device is connected to the WiFi of CapSule at this time, you can choose this device at the port to replace the traditional serial port.
+(via-arduino-capsule)=
+### Via Arduino
+[Arduino](https://www.arduino.cc/) is the one we recommend, and Heltec provides a dedicated development environment, which you can install by following this link: [Heltec ESP32 DEV-Environment](https://docs.heltec.org/en/node/esp32/esp32_general_docs/quick_start.html).
+
+``` {Tip} Make sure the node is in wireless boot mode and that the computer and the node are connected to the same local area network.
+
+```
+
+1. Open the Arduino and click the `Tools` option. In the `Port` option, find **esp32s3_xxxx** and select it. 
 
 ![](img/05.jpg)
 
-For more details on WirelessBoot:[https://docs.heltec.org/en/node/esp32/wireless_boot/index.html](https://docs.heltec.org/en/node/esp32/wireless_boot/index.html)
+```{Tip} If you can't find such an port, restart the Arduino and check whether your device is connected to the same LAN as the computer.
+
+```
+
+3. `Board` select **Heltec Cupsule Sensor V3**; `LoRa Region` select the frequency band corresponding to the device.
+
+   ![](img/06.png)
+
+4. Select the sample code and upload it.
+
+![](img/07.png)
+
+### Via Local File
+``` {Tip} Make sure the node is in wireless boot mode and that the computer and the node are connected to the same local area network.
+
+```
+
+1. Type the router address in the browser, find the IP of the Capsule Sensor V3.
+
+![](img/09.png)
+
+2. Enter the Capsule-V3 IP in your browser to navigate to the WirelessBoot page.
+
+![](img/10.png)
+
+3. Erase the original firmware.
+
+![](img/11.png)
+
+4. Select the local firmware package.
+
+![](img/12.png)
+
+5. Select the partition and upload it.
+
+![](img/13.png)
+
+``` {Tip} Notice the progress bar at the top left, please upload one firmware before uploading another.
+
+```
+``` {Tip} Note the size of the capacity of each partition, do not allow the uploaded firmware size to exceed the capacity of the partition.
+
+```
+
+