Merge branch 'master' into flasher-method

docs/hardware/devices/heltec/buttons.mdx

@@ -0,0 +1,15 @@
+---
+id: buttons
+title: Hardware Buttons
+sidebar_label: Buttons
+sidebar_position: 3
+---
+
+## Functionality
+
+- **Reset Button**
+	- _**Single press**_ resets the device.
+- **Program button**
+	- _**Single press**_ changes the page of information displayed on the screen.
+	- _**Long press**_ adjusts the contrast of the screen.
+	- _**Triple press**_ sends a broadcast message of the device position.

docs/hardware/devices/heltec/enclosures.mdx

@@ -0,0 +1,23 @@
+---
+id: enclosures
+title: Enclosures
+sidebar_label: Enclosures
+sidebar_position: 3
+---
+
+import Tropho from '/img/enclosures/3dp-tropho-heltec32.png';
+
+## Created by tropho/TonyG
+
+### Heltec LoRa32 v2.1+ Case
+
+Download from [Printables](https://www.printables.com/model/118750-heltec-lora-32-case-for-meshtastic) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1170868625/meshtastic-heltec-lora-32-case).
+
+#### Required Hardware
+
+- (x4) M3x20mm socket-head cap screws
+- (x4) M3 Nuts
+- (x1) LiPo battery pack (1,000mAh)
+- (x1) Latching micro push button switch
+
+<img src={Tropho} width="600" align="left" />

docs/hardware/devices/heltec/index.mdx

@@ -0,0 +1,148 @@
+---
+id: heltec
+title: HELTEC® Lora 32
+sidebar_label: HELTEC® Lora 32
+sidebar_position: 7
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs
+groupId="heltec"
+defaultValue="v3"
+values={[
+{label: 'Lora32 V1', value: 'v1'},
+{label: 'Lora32 V2.0', value: 'v2.0'},
+{label: 'Lora32 V2.1', value: 'v2.1'},
+{label: 'Lora32 V3', value:'v3'},
+{label: 'Wireless Stick Lite V3', value:'Wireless Stick Lite V3'}
+]}>
+<TabItem value="v1">
+
+:::warning
+Not recommended! Very old board with design issues. Support is being phased out. Use V3 in new projects.
+:::
+
+- **MCU** 
+  - ESP32 (WiFi & Bluetooth)
+- **LoRa Transceiver**
+  - Semtech SX1276
+- **Frequency options**
+  - 433 MHz
+  - 915 MHz
+  - 868 MHz
+- **Connectors**
+  - Micro USB
+  - Antenna: U.FL antenna connector
+
+**Features**
+- Built in 0.96 inch OLED display
+- User and Reset switches
+- No GPS
+
+**Resources**
+- Firmware file: `firmware-heltec-v1-X.X.X.xxxxxxx.bin`
+
+</TabItem>
+<TabItem value="v2.0">
+
+:::warning
+Not recommended because of design issues! Support is being phased out. Use V3 in new projects.
+:::
+
+- **MCU** 
+  - ESP32 (WiFi & Bluetooth)
+- **LoRa Transceiver**
+  - Semtech SX127x
+- **Frequency options**
+  - 915 MHz
+  - 868 MHz
+- **Connectors**
+  - Micro USB
+  - Antenna: U.FL antenna connector
+
+**Features**
+- Built in 0.96 inch OLED display
+- User and Reset switches
+- No GPS
+
+**Resources**
+- Firmware file: `firmware-heltec-v2.0-X.X.X.xxxxxxx.bin`
+
+</TabItem>
+<TabItem value="v2.1">
+
+:::warning
+Not recommended because of design issues! Support is being phased out. Use V3 in new projects.
+:::
+
+- **MCU** 
+  - ESP32 (WiFi & Bluetooth)
+- **LoRa Transceiver**
+  - Semtech SX127x
+- **Frequency options**
+  - 433 MHz
+  - 868 MHz
+  - 915 MHz
+- **Connectors**
+  - Micro USB
+  - Antenna: U.FL antenna connector
+
+**Features**
+- Built in 0.96 inch OLED display
+- User and Reset switches
+- No GPS
+
+**Resources**
+- Firmware file: `firmware-heltec-v2.1-X.X.X.xxxxxxx.bin`
+
+</TabItem>
+<TabItem value="v3">
+
+- **MCU** 
+  - ESP32-S3 (WiFi & Bluetooth)
+- **LoRa Transceiver**
+  - Semtech SX126x
+- **Frequency options**
+  - 868 MHz
+  - 915 MHz
+- **Connectors**
+  - USB-C
+  - Antenna: U.FL antenna connector
+
+**Features**
+- Built in 0.96 inch OLED display
+- User and Reset switches
+- No GPS
+
+**Resources**
+- Firmware file: `firmware-heltec-v3-X.X.X.xxxxxxx.bin`
+- Purchase link: [AliExpress](https://www.aliexpress.com/item/1005004823000595.html)
+
+</TabItem>
+<TabItem value="Wireless Stick Lite V3">
+
+- **MCU** 
+  - ESP32-S3 (WiFi & Bluetooth)
+- **LoRa Transceiver**
+  - Semtech SX126x
+- **Frequency options**
+  - 433 MHz
+  - 868 MHz
+  - 915 MHz
+- **Connectors**
+  - USB-C
+  - Antenna: IPEX/u.FL antenna connector
+
+**Features**
+- no display
+- User and Reset switches
+- No GPS
+
+**Resources**
+- Firmware file: `firmware-heltec-wsl-v3-X.X.X.xxxxxxx.bin`
+- Purchase link: [AliExpress](https://www.aliexpress.com/item/1005004839521502.html)
+
+</TabItem>
+</Tabs>

docs/hardware/devices/lora/index.mdx

@@ -25,6 +25,10 @@ values={[
 Not recommended with a battery! These boards contain the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
 :::
 
+:::caution
+This board is still in production but for various reasons not recommended for new purchases or for unattended installations. Firmware support is phased out. If in doubt, choose the Lora V2.1-1.6 board.
+:::
+
 - **MCU** 
   - ESP32 (WiFi & Bluetooth)
 - **LoRa Transceiver**
@@ -53,6 +57,10 @@ Not recommended with a battery! These boards contain the wrong component in the
 Not recommended with a battery! These boards contain the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
 :::
 
+:::caution
+This board is still in production but for various reasons not recommended for new purchases or for unattended installations. Firmware support is phased out. If in doubt, choose the Lora V2.1-1.6 board.
+:::
+
 - **MCU** 
   - ESP32 (WiFi & Bluetooth)
 - **LoRa Transceiver**
@@ -77,11 +85,13 @@ Not recommended with a battery! These boards contain the wrong component in the
 </TabItem>
 <TabItem value="v2.0">
 
-
 :::warning
 Not recommended with a battery! These boards contain the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
 :::
 
+:::caution
+This board is still in production but for various reasons not recommended for new purchases or for unattended installations. Firmware support is phased out. If in doubt, choose the Lora V2.1-1.6 board.
+:::
 
 - **MCU** 
   - ESP32 (WiFi & Bluetooth)
@@ -112,7 +122,7 @@ Not recommended with a battery! These boards contain the wrong component in the
 
 
 :::caution
-Not recommended with a battery. Early versions of some of these boards contained the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
+Early versions of some of these boards contained the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged. Boards purchased after 2021 should be ok.
 :::
 
 - **MCU** 

docs/hardware/devices/rak/base-boards.mdx

@@ -23,6 +23,10 @@ values={[
 
 ### RAK5005-O
 
+:::caution
+The RAK5005-O is no longer in production. It is recommended to use the RAK19007 instead.
+:::
+
 - [RAK5005-O](https://store.rakwireless.com/products/rak5005-o-base-board) - The original WisBlock Base Board.
   - **Slots**
     - (x1) Core Module slot
@@ -39,6 +43,9 @@ values={[
   - **Screen Support**
     - OLED screen support (OLED screen sold separately)
 
+:::note
+The RAK5005 (without the -O) is not compatible.
+:::
 
 Further information on the RAK5005-O can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK5005-O/Overview/#product-description).
 
@@ -87,7 +94,7 @@ Further information on the RAK19007 can be found on the [RAK Documentation Cente
     - (x2) WisBlock Sensor Module slots
   - **Buttons**
     - (x1) Reset Button
-    - It is currently not possible to add a user button to this board.
+    - There is a 3rd party sensor module that breaks out the user button, available [here](https://www.etsy.com/de/listing/1254963521/mini-io-expansion-board-for-rak-wireless).
   - **Connectors**
     - Connector for 3.7v LiPo battery (with charge controller)
     - Connector for 5v solar panel (max 5.5v)
@@ -119,7 +126,7 @@ Further information on the RAK19003 can be found on the [RAK Documentation Cente
     - (x1) Reset Button
     - (x1) User-defined push button switch
     - (x1) Battery selector switch
-    - It may be possible to add a user button using the [13002 IO module](https://store.rakwireless.com/collections/wisblock-interface/products/adapter-module-rak13002).
+    - On this board the PIN for user button (IO5) is available as a solder contact on the upper header row.
   - **Connectors**
     - Connector for 3.7v LiPo battery (with charge controller)
     - Connector for 5v solar panel (max 5.5v)

docs/hardware/devices/rak/core-modules.mdx

@@ -62,7 +62,7 @@ Further information on the RAK4631 can be found on the [RAK Documentation Center
 ### RAK11200 / RAK13300
 
 :::caution Note
-Only supported on the RAK5005-O base board.
+Only supported on the RAK5005-O / RAK19007 and the RAK19001 base board.
 :::
 
 The RAK11200 does not contain a LoRa transceiver, and thus needs to be added separately in the form of the [RAK13300 LPWAN module](https://store.rakwireless.com/products/rak13300-wisblock-lpwan). This occupies the IO Port of the base board.
@@ -76,7 +76,6 @@ The RAK11200 does not contain a LoRa transceiver, and thus needs to be added sep
   - **Meshtastic Firmware**
     - [`firmware-rak11200-2.X.X.xxxxxx.bin`](/downloads)
 
-
 Further information on the RAK11200 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK11200/Overview/#product-description).
 
 - [RAK13300](https://store.rakwireless.com/products/rak13300-wisblock-lpwan)

docs/hardware/devices/tbeam/index.mdx

@@ -26,7 +26,7 @@ values={[
 <TabItem value="0.7">
 
 :::caution Firmware Version Notice
-This is an earlier version of the T-Beam board. Due to changes in the design this board uses a specific firmware file different from the other T-Beam boards.
+This is an earlier version of the T-Beam board. Due to changes in the design this board uses a specific firmware file different from the other T-Beam boards. This board is no longer in production and not recommended for new purchases.
 :::