Merge branch 'docusaurus-version' into main

docs/Network/Meshtastic_Network/XIAO_ESP32S3_for_Meshtastic_and_LoRa/Get_Started.md

@@ -0,0 +1,26 @@
+---
+description: Meshtastic based on Wio SX1262 with XIAO esp32s3 module
+title: Get Started
+image: https://files.seeedstudio.com/wiki/seeed_logo/logo_2023.png
+slug: /wio_sx1262_xiao_esp32s3_for_meshtastic_get_started
+last_update:
+  date: 09/30/2024
+  author: Evelyn Chen
+---
+
+# Flash Firmware
+
+
+# Device Connection
+
+# Initial Configuration
+
+## Config Availability
+
+## Radio Configuration
+
+## Module Configuration
+
+# Communicate with Wio Tracker T1000-E
+
+

docs/Network/Meshtastic_Network/XIAO_ESP32S3_for_Meshtastic_and_LoRa/Get_Started_meshtastic.md

@@ -0,0 +1,159 @@
+---
+description: Meshtastic based on Wio SX1262 with XIAO esp32s3 module
+title: Get Started for Meshtastic
+image: https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/2.png
+slug: /wio_sx1262_xiao_esp32s3_for_meshtastic_get_started
+last_update:
+  date: 09/30/2024
+  author: Evelyn Chen
+---
+
+Meshtastic is an open source, off-grid, decentralized, mesh network built to run on affordable, low-power devices. Seeed Studio provides a comprehensive range of ready-to-go Meshtastic devices for hobbyists and industrial users. Wio SX1262 module and XIAO ESP32S3 kit is flexible solution for meshtastic developer and maker.
+
+
+## Flash Firmware
+
+**Step 1**: Firstly, open a browser and visit https://flasher.meshtastic.org/# requires Chrome or Edge browser.
+
+**Step 2**: Then, use a suitable USB cable to connect the device to the PC. You may need to turn off, then **press and hold the BOOT button** while plugging in the USB cable.
+
+**Step 3**: Follow the following instruction provided to perform the subsequent flashing operations. Select the Device as "**Seeed XIAO S3**", Firmware as **the lastest** one, and then click "**Flash**". Don't forget to tick "Full Erase and Install" if you want to cover previous firmware.
+
+<td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/flashfirmware1.gif" style={{width:700, height:'auto'}}/></div></td>
+
+
+## Software Overview
+
+Meshtastic provides multiple platform softwares for users to choose from, including Android app, Apple app, web client. It also provides Python CLI, Linux Native and integration methods for developers to use.
+
+For specific information, please refer to [the official website of Meshtastic](https://meshtastic.org/docs/software/).
+
+* [Android App](https://meshtastic.org/docs/category/android-app/): Android application is available on F-Droid repo and Google Play Store. This allows you to connect to your Meshtastic device from your Android phone via Bluetooth, Wi-Fi (if on the same network) or USB On-The-Go (OTG).
+* [Apple App](https://meshtastic.org/docs/category/apple-apps/): It is available on app store. By default, the Meshtastic app for iOS supports the use of native offline Apple Maps.
+* [Web Client](https://meshtastic.org/docs/software/web-client/): Meshtastic Web is a Meshtastic client that runs directly in your browser.
+* [Python CLI](https://meshtastic.org/docs/software/python/cli/): The python pip package installs a "meshtastic" command line executable, which displays packets sent over the network as JSON and lets you see serial debugging information from the meshtastic devices.
+* [Linux Native](https://meshtastic.org/docs/software/linux-native/): The device software can also run on a native Linux machine thanks to the Portduino framework.
+* [Meshtastic Integrations](https://meshtastic.org/docs/software/integrations/): The Meshtastic ecosystem is highly extensible and allows easy integration with a number of existing software products and projects.
+
+
+## Device Connection
+
+Before using Meshtastic, the device needs to be connected first. There are two connection methods. The first one is to use an expansion board, and the corresponding information will be displayed on the display. Then, the configuration can be carried out on the corresponding platform according to the reflected information. The second one is to connect the XIAO and the Wio SX1262 module, and use a serial port tool to obtain the node ID and password. 
+
+### Method 1: Connected to Expansion board
+
+After flashing firmware and downloading Meshtastic app, Expansion board would be a good tool
+ for connection and additional application such as adding grove sensors and modules easily.
+
+ Step 1: Ensure that the device to be connected (such as "device") is turned on and in a discoverable state. And open the Meshtastic app on your mobile phone.
+
+ Step 2: In the Meshtastic app, there is an "+" icon on bottom right. Click it to let the app start scanning for nearby connectable devices. Then select the corresponding device ID showing on OLED display.
+
+ Step 3: Once selected correctly, enter the code showing on OLED display. 
+
+<td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/2.gif" style={{width:700, height:'auto'}}/></div></td>
+
+Step 4: Set the Lora region, then the device will reboot.
+
+Step 5: Finish reboot, the device status can be checked on Meshtastic app and OLED display.
+
+<td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/1.gif" style={{width:700, height:'auto'}}/></div></td>
+
+
+
+### Method 2: Serial port tool
+Select a serial port debugging tool you like. I will take Comtool on mac as an example below. Select the **serial** connection, choose **the corresponding port**, configure the baud rate as **115200**, and turn on **RTS and DTR**. Open the connection and you can see the connection data.
+Search for "**nodenum**" to find the corresponding node ID. Its default **password is 123456**.
+
+<td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/11.png" style={{width:700, height:'auto'}}/></div></td>
+
+:::tip
+The last four digits of nodenum are the device number ID discovered by the meshtastic app. For example, "nodenum 0x9e20d02c" is "Meshtastic_d02c" in meshtastic.
+:::
+
+## Initial Configuration
+
+:::note
+For more details, please refer to [Meshtastic](https://meshtastic.org/docs).
+:::
+
+### Radio Configuration
+
+There are several config sections in the Meshtastic firmware, these are broken out so they can be sent as small admin messages over the mesh. 
+
+| Name | Description |
+| ---- | ---- |
+| [Bluetooth](https://meshtastic.org/docs/configuration/radio/bluetooth/) | Bluetooth config options are: Enabled, Pairing Mode and Fixed PIN. |
+| [Channels](https://meshtastic.org/docs/configuration/radio/channels/) | Channels config options are: Index, Role and Settings. |
+| [Device](https://meshtastic.org/docs/configuration/radio/device/) | Device config options are: Device Role, Serial Output, Debug Log and Factory Reset. |
+| [Display](https://meshtastic.org/docs/configuration/radio/display/) | Display config options are: Screen On Duration, Auto Carousel Interval, Always Point North, and GPS Format. |
+| [LoRa](https://meshtastic.org/docs/configuration/radio/lora/) | The LoRa config options are: Region, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Disabled and Ignore Incoming Array. |
+| [Network](https://meshtastic.org/docs/configuration/radio/network/) | Network config options are: WiFi Enabled, WiFi SSID, WiFi PSK, WiFi Mode and NTP Server. |
+| [Position](https://meshtastic.org/docs/configuration/radio/position/) | Position config options are: GPS Enabled, GPS Update Interval, GPS Attempt Time, Fixed Position, Smart Broadcast, Broadcast Interval and Position Packet Flags. |
+| [Power](https://meshtastic.org/docs/configuration/radio/power/) | Power config options are: Charge Current, Power Saving, Shutdown after losing power, ADC Multiplier Override Wait Bluetooth Interval, Light Sleep Interval and Minimum Wake Interval. |
+| [User](https://meshtastic.org/docs/configuration/radio/user/) | User config options are: Long Name, Short Name, and Is Licensed. |
+
+### Module Configuration
+
+Modules are included in the firmware and allow users to extend the functionality of their mesh or device.
+
+| Name | Description |
+| ---- | ---- |
+| [Ambient Lighting](https://meshtastic.org/docs/configuration/module/ambient-lighting/) | Adjust the brightness of NCP5623 I2C RGB LEDs. |
+| [Audio](https://meshtastic.org/docs/configuration/module/audio/) | Enable Support for Codec2 Voice Comms on certain devices. |
+| [Canned Message](https://meshtastic.org/docs/configuration/module/canned-message/) | Set a number of predefined messages to send out directly from the device with the use of an input device like a rotary encoder. |
+| [Detection Sensor](https://meshtastic.org/docs/configuration/module/detection-sensor/) | Configure a GPIO pin to be monitored for specified high/low status and send text alerts. |
+| [External Notification](https://meshtastic.org/docs/configuration/module/external-notification/) | Incoming messages are able to alert you using circuits you attach to the device (LEDs, Buzzers, etc). |
+| [MQTT](https://meshtastic.org/docs/configuration/module/mqtt/) | Forward packets along to an MQTT server. This allows users on the local mesh to communicate with users on another mesh over the internet. |
+| [Neighbor Info](https://meshtastic.org/docs/configuration/module/neighbor-info/)| Send info on 0-hop neighbors to the mesh. |
+| [Paxcounter](https://meshtastic.org/docs/configuration/module/paxcounter/) | Count the number of BLE and Wifi devices passing by a node. |
+| [Range Test](https://meshtastic.org/docs/configuration/module/range-test/) | Send messages with GPS location at an interval to test the distance your devices can communicate. Requires (at least) one device set up as a sender and one as a receiver. The receiver(s) will log all incoming messages to a CSV. |
+| [Remote Hardware](https://meshtastic.org/docs/configuration/module/remote-hardware/) | Set and read a GPIO status remotely over the mesh. |
+| [Serial Module](https://meshtastic.org/docs/configuration/module/serial/) | Send messages across the mesh by sending strings over a serial port. |
+| [Store & Forward](https://meshtastic.org/docs/configuration/module/store-and-forward-module/) | Stores messages on a device for delivery after disconnected clients rejoin the mesh. |
+| [Telemetry](https://meshtastic.org/docs/configuration/module/telemetry/) | Attach sensors to the device and transmit readings on a regular interval to the mesh. |
+| [Traceroute](https://meshtastic.org/docs/configuration/module/traceroute/) | Track which nodes are used to hop a message to a certain destination. |
+
+## Communicate with Wio Tracker T1000-E
+
+**Step 1**. Connect Wio Tracker T1000-E following [wiki](https://wiki.seeedstudio.com/sensecap_t1000_e/#get-started-1).
+
+**Step 2**. Make sure the following setting is same as your configuration on XIAO ESP32S3 for Meshatastic. 
+
+1. Device activation and setup
+- Ensure that both devices are turned on and in normal working condition.
+- The wireless communication function of the device (such as Bluetooth, LoRa, etc.) should be enabled. Check the relevant settings to ensure that it is not accidentally turned off or restricted.
+
+2. Distance and signal strength
+- The distance between the two devices cannot be too far. After initail testing, the communication distance of XIAO ESP32S3 for Meshtastic with 2 dbm IPEX antenna is over 2.5 km. Generally speaking, in a more open environment, can be over 20 km.
+
+3. Network Settings
+- Ensure that the devices are in the same network mode or channel setting. Easily set to same 'lora region' and 'Modem preset' using Meshtastic APP.
+
+<td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/12.png" style={{width:350, height:'auto'}}/></div></td>
+
+
+**Step 3**. Communicate with Wio Tracker T1000-E
+
+Once connected, you can start sending and receiving messages through the Meshtastic network. Messages can be text-based or may support additional features depending on the capabilities of the devices and the app. You can also monitor the network activity and see which devices are currently connected and active.
+
+<td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/3.gif" style={{width:350, height:'auto'}}/></div></td>
+
+
+## Tech Support & Product Discussion
+
+Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.
+
+<div class="table-center">
+  <div class="button_tech_support_container">
+  <a href="https://forum.seeedstudio.com/" class="button_forum"></a> 
+  <a href="https://www.seeedstudio.com/contacts" class="button_email"></a>
+  </div>
+
+  <div class="button_tech_support_container">
+  <a href="https://discord.gg/eWkprNDMU7" class="button_discord"></a> 
+  <a href="https://github.com/Seeed-Studio/wiki-documents/discussions/69" class="button_discussion"></a>
+  </div>
+</div>
+
+

docs/Network/Meshtastic_Network/XIAO_ESP32S3_for_Meshtastic_and_LoRa/Introduction.md

@@ -0,0 +1,145 @@
+---
+description: The introduction of Meshtastic based on Wio SX1262 with XIAO esp32s3 module
+title: Wio Sx1262 XIAO ESP32S3 Kit Introduction
+image: https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/2.png
+slug: /wio_sx1262_xiao_esp32s3
+last_update:
+  date: 09/30/2024
+  author: Evelyn Chen
+---
+
+
+<div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/2.png" style={{width:600, height:'auto'}}/></div>
+
+<div class="get_one_now_container" style={{textAlign: 'center'}}>
+    <a class="get_one_now_item" href="https://www.seeedstudio.com/Wio-SX1262-with-XIAO-ESP32S3-p-5982.html">
+            <strong><span><font color={'FFFFFF'} size={"4"}> Get One Now 🖱️</font></span></strong>
+    </a>
+</div>
+
+## Introduction
+
+This thumb-sized LoRa development kit, which consists of the XIAO ESP32S3 and the Wio-SX1262 LoRa module, is an ideal starter kit for Meshtastic and LoRa/LoRaWAN projects. Supporting WiFi, BLE, and LoRa, it includes a built-in power management chip and can be extended via IIC, UART, and other GPIO interfaces, and is compatible with Arduino development.
+The XIAO ESP32S3 with wio-sx1262 is a single-channel LoRaWAN LoRa module with a low price and high cost performance. It is suitable for application scenarios with long distance, low power consumption, and small data volume. It supports more than 30 node devices (depending on upload interval, data payload, etc.).
+
+Seeed provides 2 applications for this Wio SX1262 XIAO ESP32S3 kit. 
+- Using Meshtastic for network communication
+- Configuring as Lora/Lorawan node or gateway
+
+## Features
+
+* **Meshtactic works out of the box**: Pre-flashed with Meshtastic firmware, it is ready to work once powered on.
+* **Outstanding RF performance**: Supports LoRa(862-930MHz)  2.4GHz Wi-Fi and BLE 5.0 dual wireless communication, support 2~5km(LoRa) and 100m+(Wi-Fi/BLE) remote communication when connected with U.FL antenna.
+* **Thumb-sized Compact Design**: 21 x 18mm, adopting the classic form factor of XIAO, suitable for space-limited projects like wearable devices.
+* **Powerful MCU Board**: Incorporate the ESP32S3 32-bit, dual-core, Xtensa processor running at up to 240MHz, mounted multiple development ports, Arduino / MicroPython supported.
+* **Elaborate Power Design**: Includes a Type-C USB interface and lithium battery charge management.
+
+
+
+## Specification
+
+
+| Feature | Details |
+| ---- | ---- |
+| ESP32S3 | ESP32-S3R8, Xtensa LX7 dual-core, 32-bit processor running up to 240 MHz |
+| LoRa | Based on Semtech SX1262, supports 862-930MHz |
+| BLE | Bluetooth 5.0, Bluetooth mesh |
+| Wi-Fi | Complete 2.4GHz Wi-Fi subsystem |
+| Interface (ESP32S3) | 1x UART, 1x IIC, 1x IIS, 1x SPI(connect to SX1262),11x GPIO(PWM), 9x ADC, 1x User LED, 1x Charge LED, 1x Reset button, 1x Boot button |
+| Interface (Wio-SX1262) | 1x User button, 1x SPI(connect to ESP32S3) |
+| Power | Input voltage (Type-C): 5V <br/> Input voltage (BAT): 4.2V <br/> Charging battery current: 100mA |
+| Working Temperature | -40°C ~ 65°C |
+| Dimensions | 21 x 17.8mm |
+
+
+## Hardware Preparation
+
+
+### Part List
+
+| Item | Quantity |
+| ---- | ---- |
+| XIAO ESP32S3 | x1 |
+| Wio-SX1262 extension board | x1 |
+| Wi-Fi antenna | x1 |
+| LoRa antenna | x1 |
+
+### Recommended accessories
+
+Compatible with XIAO Expansion Board for adding screens and sensors, and add Grove sensors via the Grove expansion Board.
+
+<div class="table-center">
+  <table align="center">
+    <tr>
+      <th>XIAO Expansion Board</th>
+      <th>Grove Base for XIAO</th>
+    </tr>
+    <tr>
+      <td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/1.png" style={{width:250, height:'auto'}}/></div></td>
+      <td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/8.png" style={{width:250, height:'auto'}}/></div></td>
+    </tr>
+    <tr>
+      <td><div class="get_one_now_container" style={{textAlign: 'center'}}>
+        <a class="get_one_now_item" href="https://www.seeedstudio.com/Seeeduino-XIAO-Expansion-board-p-4746.html">
+        <strong><span><font color={'FFFFFF'} size={"4"}> Get One Now 🖱️</font></span></strong>
+        </a>
+      </div></td>
+      <td><div class="get_one_now_container" style={{textAlign: 'center'}}>
+        <a class="get_one_now_item" href="https://www.seeedstudio.com/Grove-Shield-for-Seeeduino-XIAO-p-4621.html">
+        <strong><span><font color={'FFFFFF'} size={"4"}> Get One Now 🖱️</font></span></strong>
+        </a>
+      </div></td>
+    </tr>
+  </table>
+</div>
+
+## Hardware Overview
+
+<table align="center">
+  <tr>
+	    <th>Wio-SX1262 extension board diagram</th>
+	</tr>
+    <tr>
+	    <td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/XIAO_ESP32S3_for_Meshtastic_LoRa/10.png" style={{width:700, height:'auto'}}/></div></td>
+	</tr>
+	<tr>
+	    <th>XIAO ESP32S3/XIAO ESP32S3 Sense front indication diagram</th>
+	</tr>
+	<tr>
+	    <td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/SeeedStudio-XIAO-ESP32S3/img/front-indication.png" style={{width:700, height:'auto'}}/></div></td>
+	</tr>
+    <tr>
+	    <th>XIAO ESP32S3/XIAO ESP32S3 Sense back indication diagram</th>
+	</tr>
+    <tr>
+	    <td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/SeeedStudio-XIAO-ESP32S3/img/back-indication.png" style={{width:700, height:'auto'}}/></div></td>
+	</tr>
+    <tr>
+	    <th>XIAO ESP32S3/XIAO ESP32S3 Sense Pin List</th>
+	</tr>
+    <tr>
+	    <td><div style={{textAlign:'center'}}><img src="https://files.seeedstudio.com/wiki/SeeedStudio-XIAO-ESP32S3/img/2.jpg" style={{width:700, height:'auto'}}/></div></td>
+	</tr>
+</table>
+
+## Resource
+
+* [Wio SX1262 Module Datasheet](https://files.seeedstudio.com/products/SenseCAP/Wio_SX1262/Wio-SX1262_Module_Datasheet.pdf)
+* [Wio SX1262 Schemetic Diagram](https://files.seeedstudio.com/products/SenseCAP/Wio_SX1262/Schematic_Diagram_Wio-SX1262_for_XIAO.pdf)
+* [Wio SX1262 for XIAO 3D file](https://files.seeedstudio.com/products/SenseCAP/Wio_SX1262/Wio-SX1262_for_XIAO_3D_file.rar)
+
+## Tech Support & Product Discussion
+
+Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.
+
+<div class="table-center">
+  <div class="button_tech_support_container">
+  <a href="https://forum.seeedstudio.com/" class="button_forum"></a> 
+  <a href="https://www.seeedstudio.com/contacts" class="button_email"></a>
+  </div>
+
+  <div class="button_tech_support_container">
+  <a href="https://discord.gg/eWkprNDMU7" class="button_discord"></a> 
+  <a href="https://github.com/Seeed-Studio/wiki-documents/discussions/69" class="button_discussion"></a>
+  </div>
+</div>