Merge branch 'master' into pr-nrf52-guide

2024-11-09 23:24:10 -08:00 · 2024-06-19 17:56:57 -07:00 · 2024-06-19 17:56:57 -07:00 · 6c40c2e555
parent 9cbea09e5c f6a97b28d3
commit 6c40c2e555
5 changed files with 109 additions and 17 deletions
--- a/docs/community/local-groups.mdx
+++ b/docs/community/local-groups.mdx
@ -97,6 +97,8 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
 - [UK Meshtastic North East England](https://www.facebook.com/groups/meshtasticnortheastengland/)

 ## United States
+- [Midwest Mesh](https://discord.gg/wYwD56K439)
+
 ### Arkansas
 - [Fort Smith Mesh](https://discord.com/invite/nwsvcXeqMX)

--- a/docs/hardware/devices/index.mdx
+++ b/docs/hardware/devices/index.mdx
@ -7,11 +7,13 @@ sidebar_position: 1
 ---

 ## Supported Devices
+
 Meshtastic firmware can be installed on a wide range of development boards. The list below provides a brief comparison of currently supported hardware.

 ### Which board should I choose?

 While all the boards listed on this page will run Meshtastic and mesh with each other, some current community favorites are:
+
 - RAK Meshtastic Start Kit
 - Station G1
 - LILYGO LoRa T3-S3
@ -20,20 +22,22 @@ While all the boards listed on this page will run Meshtastic and mesh with each
 Please do your research and choose the board that meets your needs (or maybe already have in a bin somewhere).

 :::info
+
 - The Semtech SX1262 transceiver is newer than the SX1276 and provides increased receive and transmit performance.
 - nRF52-based devices use a fraction of the power compared to ESP32-based devices and are therefore generally preferred for solar and handset applications.
 - ESP32-based devices require more power to operate but are typically lower-cost alternatives that do perform well when using house power, or for handsets that only require a day or two of runtime, and for applications that require WiFi connectivity.
-:::
+  :::

 ### [RAK Wisblock](./rak/)
+
 Modular hardware system with Base, Core and Peripheral modules including the low-power and solar ready nRF52840-based Meshtastic Starter Kit (19007 & 4631).

 [**WisBlock Core Modules**](./rak/core-module/)<br/>
-| Name                                           | MCU      | Radio  |     WiFi     | BT  |  GPS   |
+| Name | MCU | Radio | WiFi | BT | GPS |
 |:-----------------------------------------------|:---------|:-------|:------------:|:---:|:------:|
-| [RAK4631](./rak/core-module?rakcore=RAK4631)   | nRF52840 | SX1262 |      NO      | 5.0 | add-on |
-| [RAK11200](./rak/core-module?rakcore=RAK11200) | ESP32    | add-on | 2.4GHz b/g/n | 4.2 | add-on |
-| [RAK11310](./rak/core-module?rakcore=RAK11310) | RP2040   | SX1262 |      NO      | NO  | add-on |
+| [RAK4631](./rak/core-module?rakcore=RAK4631) | nRF52840 | SX1262 | NO | 5.0 | add-on |
+| [RAK11200](./rak/core-module?rakcore=RAK11200) | ESP32 | add-on | 2.4GHz b/g/n | 4.2 | add-on |
+| [RAK11310](./rak/core-module?rakcore=RAK11310) | RP2040 | SX1262 | NO | NO | add-on |

 [**Base Boards**](./rak/base-board/)<br/>
 [RAK5005-O](./rak/base-board?rakbase=RAK5005-O)<br/>
@ -59,10 +63,11 @@ RAK12013 Radar Sensor<br/>
 RAK13800 Ethernet Module<br/>

 ### [LILYGO® T-Beam](./tbeam/)
+
 Boards complete with GPS, 18650 battery holder, and optional screen.

 | Name                                     | MCU      | Radio             |     WiFi     | BT  | GPS |
-|:-----------------------------------------|:---------|:------------------|:------------:|:---:|:---:|
+| :--------------------------------------- | :------- | :---------------- | :----------: | :-: | :-: |
 | [T-Beam v0.7](./tbeam/?t-beam=0.7)       | ESP32    | SX1276            | 2.4GHz b/g/n | 4.2 | YES |
 | [T-Beam v1.1](./tbeam/?t-beam=1.1)       | ESP32    | SX1276            | 2.4GHz b/g/n | 4.2 | YES |
 | [T-Beam with M8N](./tbeam/?t-beam=m8n)   | ESP32    | SX1276<br/>SX1262 | 2.4GHz b/g/n | 4.2 | YES |
@ -70,17 +75,19 @@ Boards complete with GPS, 18650 battery holder, and optional screen.
 | [T-BeamSUPREME](./tbeam/?t-beam=supreme) | ESP32-S3 | SX1262            | 2.4GHz b/g/n | 5.0 | YES |

 ### [LILYGO® T-Echo](./techo/)
-All-in-one unit with E-Ink screen, GPS and battery in injection-molded case.  Features the low-power nRF52840 for long battery life.
+
+All-in-one unit with E-Ink screen, GPS and battery in injection-molded case. Features the low-power nRF52840 for long battery life.

 | Name               | MCU      | Radio  | WiFi | BT  | GPS |
-|:-------------------|:---------|:-------|:----:|:---:|:---:|
+| :----------------- | :------- | :----- | :--: | :-: | :-: |
 | [T-Echo](./techo/) | nRF52840 | SX1262 |  NO  | 5.0 | YES |

 ### [LILYGO® LoRa](./lora/)
+
 Inexpensive basic ESP32-based boards.

 | Name                                       | MCU      | Radio                        |     WiFi     | BT  | GPS |
-|:-------------------------------------------|:---------|:-----------------------------|:------------:|:---:|:---:|
+| :----------------------------------------- | :------- | :--------------------------- | :----------: | :-: | :-: |
 | [LoRa32 V1](./lora/?t-lora=v1)             | ESP32    | SX127x                       | 2.4GHz b/g/n | 4.2 | NO  |
 | [LoRa32 V1.3](./lora/?t-lora=v1.3)         | ESP32    | SX127x                       | 2.4GHz b/g/n | 4.2 | NO  |
 | [LoRa32 V2.0](./lora/?t-lora=v2.0)         | ESP32    | SX127x                       | 2.4GHz b/g/n | 4.2 | NO  |
@ -89,23 +96,25 @@ Inexpensive basic ESP32-based boards.
 | [LoRa32 T3-S3 V1.0](./lora/?t-lora=S3-v1)  | ESP32-S3 | SX1262<br/>SX1276<br/>SX1280 | 2.4GHz b/g/n | 5.0 | NO  |

 ### [LILYGO® T-Deck](./tdeck/)
+
 Standalone device with screen and keyboard

 | Name               | MCU         | Radio  | WiFi | BT  | GPS |
-|:-------------------|:------------|:-------|:----:|:---:|:---:|
+| :----------------- | :---------- | :----- | :--: | :-: | :-: |
 | [T-Deck](./tdeck/) | ESP32-S3FN8 | SX1262 | YES  | 5.0 | NO  |

 ### [LILYGO® T-Watch S3](./twatch/)

 | Name                    | MCU      | Radio  | WiFi | BT  | GPS |
-|:------------------------|:---------|:-------|:----:|:---:|:---:|
+| :---------------------- | :------- | :----- | :--: | :-: | :-: |
 | [T-Watch S3](./twatch/) | ESP32-S3 | SX1262 | YES  | 5.0 | NO  |

 ### [HELTEC® LoRa 32](./heltec/)
+
 Inexpensive basic ESP32-based boards.

 | Name                                                              | MCU         | Radio  |     WiFi     | BT  | GPS |
-|:------------------------------------------------------------------|:------------|:-------|:------------:|:---:|:---:|
+| :---------------------------------------------------------------- | :---------- | :----- | :----------: | :-: | :-: |
 | [LoRa32 V2.1](./heltec/?heltec=v2.1)                              | ESP32       | SX127x | 2.4GHz b/g/n | 4.2 | NO  |
 | [LoRa32 V3/3.1](./heltec/?heltec=v23)                             | ESP32-S3FN8 | SX1262 | 2.4GHz b/g/n | 5.0 | NO  |
 | [Wireless Stick Lite V3](./heltec/?heltec=Wireless+Stick+Lite+V3) | ESP32-S3FN8 | SX1262 | 2.4GHz b/g/n | 5.0 | NO  |
@ -113,26 +122,29 @@ Inexpensive basic ESP32-based boards.
 | [Wireless Paper](./heltec/?heltec=paper)                          | ESP32-S3FN8 | SX1262 | 2.4GHz b/g/n | 5.0 | NO  |

 ### [Nano Series](./nano/)
+
 Portable and durable devices designed for Meshtastic.

 | Name                                         | MCU         | Radio  |     WiFi     | BT  | GPS |
-|:---------------------------------------------|:------------|:-------|:------------:|:---:|:---:|
+| :------------------------------------------- | :---------- | :----- | :----------: | :-: | :-: |
 | [Nano G2 Ultra](./nano/?nano-series=g2)      | NRF52840    | SX1262 | 2.4GHz b/g/n | 5.0 | YES |
 | [Nano G1 Explorer](./nano/?nano-series=g1-e) | ESP32 WROOM | SX1262 | 2.4GHz b/g/n | 4.2 | YES |
 | [Nano G1](./nano/?nano-series=g1)            | ESP32 WROOM | SX1276 | 2.4GHz b/g/n | 4.2 | YES |

 ### [Station G1](./station-g1/)
+
 High power LoRa transceiver designed for Meshtastic Licensed HAM operation.

 | Name                        | MCU         | Radio  |     WiFi     | BT  | GPS |
-|:----------------------------|:------------|:-------|:------------:|:---:|:---:|
+| :-------------------------- | :---------- | :----- | :----------: | :-: | :-: |
 | [Station G1](./station-g1/) | ESP32 WROOM | SX1262 | 2.4GHz b/g/n | 4.2 | YES |

 ### [Raspberry Pi Pico](./raspberry-pi/)
+
 Fast versatile boards using the RP2040.

 | Name                                 | MCU    | Radio  |     WiFi     |      BT       | GPS |
-|:-------------------------------------|:-------|:-------|:------------:|:-------------:|:---:|
+| :----------------------------------- | :----- | :----- | :----------: | :-----------: | :-: |
 | [Raspberry Pi Pico](./raspberry-pi/) | RP2040 | SX1262 | 2.4GHz b/g/n | not supported | NO  |

 [**Pico Peripherals**](./raspberry-pi/peripherals/)<br/>
@ -141,8 +153,17 @@ SH1106 OLED Display<br/>
 CardKB Keyboard<br/>

 ### [CanaryOne](./canary)
-Complete solution with battery, screen, case, and antenna.  Ships pre-flashed with latest Meshtastic firmware.
+
+Complete solution with battery, screen, case, and antenna. Ships pre-flashed with latest Meshtastic firmware.

 | Name                  | MCU      | Radio  | WiFi | BT  | GPS |
-|:----------------------|:---------|:-------|:----:|:---:|:---:|
+| :-------------------- | :------- | :----- | :--: | :-: | :-: |
 | [CanaryOne](./canary) | nRF52840 | SX1262 |  NO  | 5.0 | YES |
+
+### [unPhone](./unPhone)
+
+All-in-one development device with LoRa, WiFi, BT, touchscreen, accelerometer, gyroscop, vibration motor, LiPo battery and more!
+
+| Name                  | MCU              | Radio  | WiFi | BT  | GPS |
+| :-------------------- | :--------------- | :----- | :--: | :-: | :-: |
+| [unPhone](./unPhone) | ESP32-S3-WROOM-1 | RF950W | YES  | 5.0 | NO  |
--- a/docs/hardware/devices/unPhone/index.mdx
+++ b/docs/hardware/devices/unPhone/index.mdx
@ -0,0 +1,69 @@
+---
+id: unphone
+title: unPhone
+sidebar_label: unPhone
+sidebar_position: 13
+---
+
+The unPhone is a versatile open hardware and open-source software development device designed to provide seamless connectivity and expandability. Developed by the University of Sheffield, in partnership with Pimoroni and Gareth Coleman, it features a touchscreen, battery, case, and antenna, and more, making it ideal for various projects.
+
+For more comprehensive information on the unPhone, please visit the project's website at [https://unphone.net](https://unphone.net).
+
+## Specifications
+
+- **MCU**
+  - ESP32-S3-WROOM-1
+    - Bluetooth 5.0
+    - WiFi support
+- **LoRa Transceiver**
+  - HopeRF RF950W
+- **Frequency options**
+  - 868 MHz
+- **Navigation Module**
+  - Not included
+- **Antenna**
+  - Integrated
+- **Connectors**
+  - USB-C
+
+## Features
+
+- 8MB flash and 8MB PSRAM
+- 3.5" (320x480) LCD capacitive touchscreen
+- IR LEDs
+- 1200mAh LiPo battery with USB-C charging
+- Vibration motor
+- Compass/Accelerometer (both 3-axis)
+- SD card slot
+- Expander board that supports two Featherwing sockets and a prototyping area
+
+## Flashing
+
+To flash ESP32-S3 devices like the unPhone, you typically need to place them in Espressif's firmware download mode. Use the "1200bps reset" button in the web flasher to do this. If this method does not work for any reason, you can follow the manual process below.
+
+:::warning
+
+Do not proceed unless an antenna is connected to avoid possible damage to the device's radio.
+
+:::
+
+The following process will manually place the device into the Espressif Firmware Download mode:
+
+1. Ensure the device is plugged in and powered on by switching the battery switch to `ON`.
+2. Press and hold the center (circle) button.
+3. While holding the center (circle) button, press the reset button on the side. _See [image](#images)._
+4. After 2-3 seconds, release center (circle) button.
+
+With the device now in the Espressif Firmware Download mode, you can proceed with flashing using one of the supported flashing methods. It's generally recommended to use the [Web Flasher](https://flasher.meshtastic.org/). You can select "unPhone" from the device drop-down.
+
+## Resources
+
+- Firmware file: `firmware-unphone-X.X.X.xxxxxxx.bin`
+- Purchase Link:
+
+  - [Pimoroni](https://shop.pimoroni.com/products/unphone?variant=40829810311251)
+
+  #### Images
+
+![unPhone-side](/img/hardware/unPhone/unphone-side.webp)
+![unphone-front](/img/hardware/unPhone/unphone-front-with-exander.webp)
--- a/static/img/hardware/unPhone/unphone-front-with-exander.webp
+++ b/static/img/hardware/unPhone/unphone-front-with-exander.webp
--- a/static/img/hardware/unPhone/unphone-side.webp
+++ b/static/img/hardware/unPhone/unphone-side.webp