Merge branch 'master' into patch-2

This commit is contained in:
rcarteraz 2024-02-07 08:53:06 -07:00 committed by GitHub
commit 3a56fd157a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
570 changed files with 398 additions and 315 deletions

View file

@ -9,7 +9,7 @@ import Link from "@docusaurus/Link";
Meshtastic® is a project that enables you to use inexpensive LoRa radios as a long range off-grid communication platform in areas without existing or reliable communications infrastructure. This project is 100% community driven and open source!
![LoRa Topology](/img/introduction/lora-topology-2.png)
![LoRa Topology](/img/introduction/lora-topology-2.webp)
### Features

View file

@ -45,7 +45,8 @@ This layer is conventional non-reliable LoRa packet transmission. A packet gener
| :----: | :-------: | :----------------------------- |
| 0 | 3 | HopLimit (see note in Layer 3) |
| 3 | 1 | WantAck |
| 4 .. 7 | 4 | Currently unused |
| 4 | 1 | ViaMQTT (packet came via MQTT) |
| 5 .. 7 | 3 | Currently unused |
#### Usage Details
@ -88,4 +89,4 @@ Due to limited coverage, it only reaches nodes 1 and 2. Since node 2 is farther
After node 0 received this rebroadcast, its message is acknowledged. Note that a message is already acknowledged once a rebroadcast from any Meshtastic node (whether or not it has the same encryption key) is received.
Since node 1 heard the rebroadcast by 2, it will not rebroadcast again. Node 3 heard the message for the first time and the HopLimit is not yet zero, so it starts a rebroadcast for potential other receivers.
![Mesh algorithm example](/img/SNR_based_flooding.png)
![Mesh algorithm example](/img/SNR_based_flooding.webp)

View file

@ -44,11 +44,11 @@ Default Long_Fast
- **Firmware Version:** 2.1.18
- **Antenna:** Standard LoRa 915MHz 60mm 2dBi Omnidirectional
<img src="/img/records/kboxlabs_sender.png" alt="Sending Node" />
<img src="/img/records/kboxlabs_sender.webp" alt="Sending Node" />
<img src="/img/records/kboxlabs_receiver.png" alt="Receiving Node" />
<img src="/img/records/kboxlabs_receiver.webp" alt="Receiving Node" />
<img src="/img/records/kboxlabs_map.png" alt="Geographic Locations" />
<img src="/img/records/kboxlabs_map.webp" alt="Geographic Locations" />
## Previous Record 166km
@ -115,9 +115,9 @@ Default Long_Fast
- **Firmware Version:** 2.1.10 (modified to place GPS in flight mode)
- **Antenna:** Stock Antenna
<img src="/img/records/Devices-Balloon.png" alt="Nodes and Balloon" />
<img src="/img/records/Devices-Balloon.webp" alt="Nodes and Balloon" />
<img src="/img/records/app-screenshots.png" alt="App Screenshots" />
<img src="/img/records/app-screenshots.webp" alt="App Screenshots" />
</TabItem>
</Tabs>
</Tabs>

View file

@ -0,0 +1,6 @@
position: 3
label: Enclosures
collapsible: true # make the category collapsible
link:
type: generated-index
title: Meshtastic Community Enclosures

View file

@ -1,11 +1,12 @@
---
id: enclosures
title: Enclosures
sidebar_label: Enclosures
sidebar_position: 2
id: heltec-enclosures
title: Heltec LoRa 32 Enclosures
description: Enclosures
sidebar_label: Heltec V2
sidebar_position: 5
---
import Tropho from "/img/enclosures/3dp-tropho-heltec32.png";
import Tropho from "/img/enclosures/3dp-tropho-heltec32.webp";
## Created by tropho/TonyG

View file

@ -1,11 +1,12 @@
---
id: enclosures
title: Enclosures
sidebar_label: Enclosures
sidebar_position: 3
id: lilygo-lora32-v2-enclosures
title: LILYGO® TTGO Lora Enclosures
description: Enclosures
sidebar_label: LILYGO® Lora V2
sidebar_position: 4
---
import Tropho from "/img/enclosures/3dp-tropho-lora32.png";
import Tropho from "/img/enclosures/3dp-tropho-lora32.webp";
## Created by tropho/TonyG

View file

@ -1,6 +1,6 @@
---
id: harbor_breeze_solar
title: Harbor Breeze Solar Light Enclosure Hack
id: harbor-breeze-solar-hack
title: RAK WisBlock Harbor Breeze Solar Light Enclosure Hack
sidebar_label: Solar Light Enclosure Hack
sidebar_position: 1
---
@ -8,7 +8,7 @@ sidebar_position: 1
## Created by tavdog/Tavis Gustafson
### Low Cost Harbor Breeze Solar Light RAK Enclosure Hack
![Solar Hack Complete](/img/enclosures/hbmh_complete.png)
![Solar Hack Complete](/img/enclosures/hbmh_complete.webp)
The Harbor Breeze Solar LED light can be purchased for about $15 and includes a capable solar panel, lithium ion cell and charge controller in a waterproof enclosure. The RAK baseboards fit perfectly inside the solar compartment. Below are the steps for completing this hack for a completely weatherproof solar powered Meshtastic node.
@ -22,25 +22,25 @@ An ipex to sma pigtail is needed if in order to have an external antenna. A JST
Step 1. Unscrew 4 small screws to open the solar compartment.
Step 2. Solder your battery JST-PHR-2 connector or power wires to the + and - terminals of the battery. If you don't have the proper connector you can solder directly to the pins on the back of the JST connector, just make sure you get the polarity correct.
![Solder to battery terminals](/img/enclosures/harbor_breeze_solar_battery_solder_points.jpg)
![Solder to battery terminals](/img/enclosures/harbor_breeze_solar_battery_solder_points.webp)
Step 3. Drill the hole for your sma pigtail. A perfectly vertical antenna via 90 degree bend will not allow for a very flat solar panel so choose wisely or use an externally mounted antenna. You can skip this step if you want to use an internal antenna that fits.
![Drill sma holes](/img/enclosures/harbor_breeze_solar_sma_hole1.jpg)![Drill sma holes](/img/enclosures/harbor_breeze_solar_sma_hole2.jpg)
![Drill sma holes](/img/enclosures/harbor_breeze_solar_sma_hole1.webp)![Drill sma holes](/img/enclosures/harbor_breeze_solar_sma_hole2.webp)
Step 4. Install the sma pigtail. Seal with silicone or marine sealant.
![Install sma pigtail](/img/enclosures/harbor_breeze_solar_sma_installed.jpg)![Seal](/img/enclosures/harbor_breeze_solar_sma_seal.jpg)
![Install sma pigtail](/img/enclosures/harbor_breeze_solar_sma_installed.webp)![Seal](/img/enclosures/harbor_breeze_solar_sma_seal.webp)
Step 5. Install the RAK module in the free space. You can lightly tack glue this in place if you want to.
![Instal module](/img/enclosures/harbor_breeze_solar_board_placement.jpg)
![Instal module](/img/enclosures/harbor_breeze_solar_board_placement.webp)
Step 6. Connect the antenna and battery and close up the back.
The light housing can be removed if not needed.
![External antenna via sma pigtail](/img/enclosures/harbor_breeze_solar_antenna_pigtail.jpg)
![External antenna via sma pigtail](/img/enclosures/harbor_breeze_solar_antenna_pigtail.webp)
The light housing is not as waterproof as the solar enclosure so be careful if putting electronics inside of it.
Attach to a stick and put it high up.
![External antenna via sma pigtail](/img/enclosures/harbor_breeze_solar_stick_mount.jpg)
![External antenna via sma pigtail](/img/enclosures/harbor_breeze_solar_stick_mount.webp)
The light will still turn on at night for a very stealthy node. To turn off the light there is a button on the back.
@ -49,4 +49,4 @@ Here is a Lowes.com link to the solar light : (https://www.lowes.com/pd/60LM-Sol
Here is a link to the Meshtastic Starter kit : (https://store.rakwireless.com/products/wisblock-meshtastic-starter-kit)
Here is an amazon link to the sma and antennas (https://www.amazon.com/DIYmalls-915MHz)
Here is an amazon link to the sma and antennas (https://www.amazon.com/DIYmalls-915MHz)

View file

@ -1,8 +1,9 @@
---
id: enclosures
title: Enclosures
sidebar_label: Enclosures
sidebar_position: 3
id: rak-enclosures
title: RAK WisBlock Enclosures
description: Enclosures
sidebar_label: RAK WisBlock
sidebar_position: 1
---
## Created by KeithMon/Voltaic Enclosures
@ -11,7 +12,7 @@ sidebar_position: 3
Download from [Printables](https://www.printables.com/model/297089-meshtastic-solar-base-station-node-enclosure-for-3) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1312727008/meshtastic-solar-base-station-off-grid).
![rak19003-micro](/img/enclosures/3dp-kmon-basestation.png)
![rak19003-micro](/img/enclosures/3dp-kmon-basestation.webp)
## Created by tropho/TonyG
@ -19,29 +20,29 @@ Download from [Printables](https://www.printables.com/model/297089-meshtastic-so
Download from [Printables](https://www.printables.com/model/286651-rak5005-case-for-meshtastic) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1158237722/meshtastic-rak5005-case).
![rak5005](/img/enclosures/3dp-tropho-rak5005.png)
![rak5005](/img/enclosures/3dp-tropho-rak5005.webp)
### RAK19007 Case
Download from [Printables](https://www.printables.com/model/286657-rak19007-case-for-meshtastic) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1302265084/meshtastic-rak19007-case).
![rak19007](/img/enclosures/3dp-tropho-rak19007.png)
![rak19007](/img/enclosures/3dp-tropho-rak19007.webp)
### RAK19003 Case
Download from [Printables](https://www.printables.com/model/286662-rak19003-case-for-meshtastic) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1316287559/meshtastic-rak19003-case).
![rak19003](/img/enclosures/3dp-tropho-rak19003.png)
![rak19003](/img/enclosures/3dp-tropho-rak19003.webp)
### RAK19003 (Micro) Case
Download from [Printables](https://www.printables.com/model/286664-rak19003-micro-case-for-meshtastic) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1302260756/meshtastic-rak19003-micro-case).
![rak19003-micro](/img/enclosures/3dp-tropho-rak19003-micro.png)
![rak19003-micro](/img/enclosures/3dp-tropho-rak19003-micro.webp)
## Created by tavdog/Tavis Gustafson
### [Harbor Breeze Meshtastic Hack](./harbor_breeze_solar_enclosure.mdx)
### [Harbor Breeze Meshtastic Hack](./harbor-breeze-solar-enclosure.mdx)
![Harbor Breeze Solar LED Meshtastic Hack Complete](/img/enclosures/hbmh_complete.png)
![Harbor Breeze Solar LED Meshtastic Hack Complete](/img/enclosures/hbmh_complete.webp)

View file

@ -1,8 +1,9 @@
---
id: enclosures
title: Enclosures
sidebar_label: Enclosures
sidebar_position: 3
id: tbeam-enclosures
title: T-Beam Enclosures
description: Enclosures
sidebar_label: T-Beam V1
sidebar_position: 2
---
## Created by tropho/TonyG
@ -17,6 +18,6 @@ Download from [Printables](https://www.printables.com/model/127253-t-beam-case-f
- (x4) M3 nuts
- (x4) M2x4mm screws (no nuts) to secure T-Beam to the frame
<img src="/img/enclosures/3dp-tropho-tbeam.jpg" width="400" align="left" />
<img src="/img/enclosures/3dp-tropho-tbeam.webp" width="400" align="left" />
<!-- ![TrophoTbeam](/img/enclosures/3dp-tropho-tbeam.jpg) -->
<!-- ![TrophoTbeam](/img/enclosures/3dp-tropho-tbeam.webp) -->

View file

@ -0,0 +1,17 @@
---
id: techo-enclosures
title: T-Echo Enclosures
description: Enclosures
sidebar_label: T-Echo
sidebar_position: 3
---
## Created by BrianN
### T-Echo Expedition Case
Download from [Thingiverse](https://www.thingiverse.com/thing:5028720).
<img src="/img/enclosures/3dp-briann-techo-exp.webp" width="400" align="left" />
<!-- ![T-Echo Expedition](/img/enclosures/3dp-briann-techo-exp.webp) -->

View file

@ -25,6 +25,11 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
- [SoCal Mesh](https://socalmesh.org)
- [Laguna Mesh](https://lagunamesh.com)
- [Mission Viejo Mesh](https://missionviejomesh.org/)
- [Bay Area Mesh](https://canvis.app/z2k8a8)
- [San Diego Mesh](https://discord.gg/HzE248x2)
### Hawaii
- [Hawaii Meshnet](https://www.hawaiimesh.net/)
- [Hawaii Meshnet](https://www.hawaiimesh.net/)
### Texas
- [Austin Mesh](https://austinmesh.org/)

View file

@ -150,23 +150,23 @@ values={[
Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > MQTT: Turn on the slider for **MQTT enabled** and tap **Send**.
[![MQTT Settings](/img/modules/mqtt/android_mqtt_encryption_sm.png)](/img/modules/mqtt/android_mqtt_encryption.png)
[![MQTT Settings](/img/modules/mqtt/android_mqtt_encryption_sm.webp)](/img/modules/mqtt/android_mqtt_encryption.webp)
*Optional:* To use your phone's internet connection to send and receive packets over the web, also enable the slider for **MQTT Client Proxy** and skip the Configure Network Settings step below.
[![Client Proxy](/img/modules/mqtt/android_mqtt_proxy_sm.png)](/img/modules/mqtt/android_mqtt_proxy_encryption.png)
[![Client Proxy](/img/modules/mqtt/android_mqtt_proxy_sm.webp)](/img/modules/mqtt/android_mqtt_proxy_encryption.webp)
<h3>2. Enable Channel Uplink & Downlink</h3>
Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > Channels > LongFast: Turn on the sliders for **Uplink enabled** and **Downlink enabled**, then tap **Save** and tap **Send**.
[![Channel Settings](/img/modules/mqtt/android_channel_sm.png)](/img/modules/mqtt/android_channel.png)
[![Channel Settings](/img/modules/mqtt/android_channel_sm.webp)](/img/modules/mqtt/android_channel.webp)
<h3>3. Configure Network Settings</h3>
Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > Network: Turn on the slider for **WiFi enabled**, Enter the **SSID** and **PSK** for your network, then tap **Send**.
[![Network Settings](/img/modules/mqtt/android_network_sm.png)](/img/modules/mqtt/android_network.png)
[![Network Settings](/img/modules/mqtt/android_network_sm.webp)](/img/modules/mqtt/android_network.webp)
</TabItem>
<TabItem value="apple">
@ -175,24 +175,24 @@ Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > Networ
Navigate to Settings > MQTT: Turn on the slider for MQTT enabled and tap **Save**
[![MQTT Settings 1](/img/modules/mqtt/apple_mqtt_1_encryption_sm.png)](/img/modules/mqtt/apple_mqtt_1_encryption.png)
[![MQTT Settings 2](/img/modules/mqtt/apple_mqtt_2_sm.png)](/img/modules/mqtt/apple_mqtt_2.png)
[![MQTT Settings 1](/img/modules/mqtt/apple_mqtt_1_encryption_sm.webp)](/img/modules/mqtt/apple_mqtt_1_encryption.webp)
[![MQTT Settings 2](/img/modules/mqtt/apple_mqtt_2_sm.webp)](/img/modules/mqtt/apple_mqtt_2.webp)
*Optional:* To use your phone's internet connection to send and receive packets over the web, also enable the slider for **MQTT Client Proxy** and skip the Configure Network Settings step below.
[![Client Proxy](/img/modules/mqtt/apple_mqtt_1_proxy_sm.png)](/img/modules/mqtt/apple_mqtt_1_proxy_encryption.png)
[![Client Proxy](/img/modules/mqtt/apple_mqtt_1_proxy_sm.webp)](/img/modules/mqtt/apple_mqtt_1_proxy_encryption.webp)
<h3>2. Enable Channel Uplink & Downlink</h3>
Navigate to Settings > Channels > Primary Channel: Turn on the sliders for **Uplink enabled** and **Downlink enabled** - Tap **Save**
[![Channel Settings](/img/modules/mqtt/apple_channel_sm.png)](/img/modules/mqtt/apple_channel.png)
[![Channel Settings](/img/modules/mqtt/apple_channel_sm.webp)](/img/modules/mqtt/apple_channel.webp)
<h3>3. Configure Network Settings</h3>
Navigate to Settings > Network: Turn on the slider for **WiFi enabled** - Enter your **SSID** and **PSK** for your network - Tap **Save**
[![Network Settings](/img/modules/mqtt/apple_network_sm.png)](/img/modules/mqtt/apple_network.png)
[![Network Settings](/img/modules/mqtt/apple_network_sm.webp)](/img/modules/mqtt/apple_network.webp)
</TabItem>
<TabItem value="cli">
@ -235,11 +235,11 @@ meshtastic --set network.wifi_enabled true --set network.wifi_ssid "your network
Navigate to Config > Module Config > MQTT - Turn on the slider for MQTT enabled - Click the **Save** icon.
[![MQTT Settings](/img/modules/mqtt/web_mqtt_encryption_sm.png)](/img/modules/mqtt/web_mqtt_encryption.png)
[![MQTT Settings](/img/modules/mqtt/web_mqtt_encryption_sm.webp)](/img/modules/mqtt/web_mqtt_encryption.webp)
*Optional:* To use your client's internet connection to send and receive packets over the web, also enable the slider for **Proxy to Client Enabled** and skip the Configure Network Settings step below.
[![Client Proxy](/img/modules/mqtt/web_mqtt_proxy_sm.png)](/img/modules/mqtt/web_mqtt_proxy_encryption.png)
[![Client Proxy](/img/modules/mqtt/web_mqtt_proxy_sm.webp)](/img/modules/mqtt/web_mqtt_proxy_encryption.webp)
:::caution
@ -252,13 +252,13 @@ Though this option may be visible in your UI, Client Proxy is not yet functional
Navigate to Channels > Primary: Turn on the sliders for **Uplink Enabled** and **Downlink Enabled** - Click the **Save** icon.
[![Channel Settings](/img/modules/mqtt/web_channel_sm.png)](/img/modules/mqtt/web_channel.png)
[![Channel Settings](/img/modules/mqtt/web_channel_sm.webp)](/img/modules/mqtt/web_channel.webp)
<h3>3. Configure Network Settings</h3>
Navigate to Radio Config > Device > Network: Turn on the slider for **Enabled** - Enter your **SSID** and **PSK** for your network - Click the **Save** icon.
[![Network Settings](/img/modules/mqtt/web_network_sm.png)](/img/modules/mqtt/web_network.png)
[![Network Settings](/img/modules/mqtt/web_network_sm.webp)](/img/modules/mqtt/web_network.webp)
</TabItem>
</Tabs>
</Tabs>

View file

@ -229,4 +229,4 @@ You can add a simple LED and resistor to validate that the GPIO operations work
By default, the pin may be "off" or "on". (It will most likely "off".) See the steps below for running commands. In the example of GPIO21, the mask would be `0x200000`.
![T-Lora v1 with LED on GPIO 21](/img/LED_on_TLoraV1.jpg)
![T-Lora v1 with LED on GPIO 21](/img/LED_on_TLoraV1.webp)

View file

@ -211,7 +211,7 @@ The following are examples of using either a Raspberry Pi Pico or Arduino Mini P
#### Raspberry Pi Pico Wiring
![image](/img/modules/Serial/pico-pir-wiring.png)
![image](/img/modules/Serial/pico-pir-wiring.webp)
- TX pin 14 on the T-Beam to RX pin 2 on the Pico
- RX pin 13 on the T-Beam to TX pin 1 on the Pico
@ -252,7 +252,7 @@ while True:
#### Arduino Mini Pro Wiring
![image](/img/modules/Serial/arduino-mini-pro-pir-wiring.png)
![image](/img/modules/Serial/arduino-mini-pro-pir-wiring.webp)
- T-BEAM RX PIN 13 to TX PIN on the ARDUINO MINI
- T-BEAM TX PIN 14 to RX PINon the ARDUINO MINI

View file

@ -25,7 +25,7 @@ Because of the increased network traffic for this overhead, it's not advised to
### How it works
![Store & Forward - Overview](/img/modules/store_and_forward/store_and_forward-overview.png)
![Store & Forward - Overview](/img/modules/store_and_forward/store_and_forward-overview.webp)
### Requirements

View file

@ -172,7 +172,7 @@ All telemetry module config options are available in the Web UI.
Setup of a RAK 4631 with Environment Sensor
[<img src="RAK4631_with_EnvSensor" src="/img/hardware/rak/RAK4631_with_EnvSensor.jpg" style={{zoom:'25%'}} />](/img/hardware/rak/RAK4631_with_EnvSensor.jpg)
[<img src="RAK4631_with_EnvSensor" src="/img/hardware/rak/RAK4631_with_EnvSensor.webp" style={{zoom:'25%'}} />](/img/hardware/rak/RAK4631_with_EnvSensor.webp)
Requirements:

View file

@ -36,7 +36,7 @@ The default pairing mode will be determined based on whether the device has or d
### Fixed PIN
If your pairing mode is set to `FIXED_PIN`, the default value is 123456. For all other pairing modes, this number is ignored. A custom integer (6 digits) can be set via the Bluetooth config options.
If your pairing mode is set to `FIXED_PIN`, the default value is **123456**. For all other pairing modes, this number is ignored. A custom integer (6 digits) can be set via the Bluetooth config options.
## Configure Bluetooth Config

View file

@ -121,7 +121,7 @@ values={[
:::info
Channel Config options are available on Android.
:::
![Android Menu Tabs](/img/android/android-menu-channel.png)
![Android Menu Tabs](/img/android/android-menu-channel.webp)
The Radio Configuration tab can be used for common tasks:
@ -131,7 +131,7 @@ The Radio Configuration tab can be used for common tasks:
See [Android App Usage](/docs/software/android/usage#setup-a-channel) for more further instruction on setting up your primary channel.
[![Channel Editor](/img/android/android-channel-edit-sm.png)](/img/android/android-channel-edit.png)
[![Channel Editor](/img/android/android-channel-edit-sm.webp)](/img/android/android-channel-edit.webp)
Tap the Channel Name (or the pen icon) to access the Channel Menu:

View file

@ -28,7 +28,25 @@ Acceptable values:
| `SENSOR` | Sensor - For use with devices intended to primarily collect sensor readings. Telemetry packets sent from this device will be higher priority, broadcasting every five minutes. When used in conjunction with power.is_power_saving = true, nodes will wake up, send environment telemetry, and then sleep for telemetry.environment_update_interval seconds. |
| `TAK` | TAK - Used for nodes dedicated for connection to an ATAK EUD. Turns off many of the routine broadcasts to favor CoT packet stream from the Meshtastic ATAK plugin -> IMeshService -> Node. |
| `CLIENT_HIDDEN` | Client Hidden - Used for nodes that "only speak when spoken to." Turns off all of the routine broadcasts but allows for ad-hoc communication. Still rebroadcasts, but with local only rebroadcast mode (known meshes only). Can be used for clandestine operation or to dramatically reduce airtime / power consumption |
| `LOST_AND_FOUND` | Lost and Found - Used to automatically send a text message to the mesh with the current position of the device on a frequent interval: "I'm lost! Position: lat / long" |
| `LOST_AND_FOUND` | Lost and Found - Used to automatically send a text message with current position at frequent intervals to the primary channel for the device: "I'm lost! Position: lat / long" |
#### Role Comparison
This table shows the **default** values after selecting a preset. As always, individual settings can be adjusted after choosing a preset.
| Device Role | Bluetooth/Wi-Fi Enabled | Screen Enabled | Power Consumption | Retransmit | Prioritized Routing | Visible in Nodes List |
| -------------- | ----------------------- | -------------- | ----------------- | ---------- | ------------------- | --------------------- |
| CLIENT | Yes | Yes | Regular | Yes | No | Yes |
| CLIENT_MUTE | Yes | Yes | Lowest | No | No | Yes |
| CLIENT_HIDDEN | Yes | Yes | Lowest | Local only | No | No |
| TRACKER | Yes | No | Regular | No | No | Yes |
| LOST_AND_FOUND | Yes | No | Regular | No | No | Yes |
| SENSOR | Yes | No | High | No | No | Yes |
| TAK | Yes | Optional | Low | Yes | No | Yes |
| ROUTER | No | No | High | Yes | Yes | Yes |
| ROUTER_CLIENT | Yes | Yes | Highest | Yes | Yes | Yes |
| REPEATER | Yes | No | High | Yes | Yes | No |
### Rebroadcast Mode

View file

@ -8,7 +8,7 @@ import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import LoRaRegions from "../../blocks/_lora-regions.mdx";
The LoRa config options are: Region, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Channel Number, Ignore Incoming Array, Override Duty Cycle Limit, SX126x RX Boosted Gain, and Override Frequency. LoRa config uses an admin message sending a `Config.LoRa` protobuf.
The LoRa config options are: Region, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Channel Number, Ignore Incoming Array, Ignore MQTT, Override Duty Cycle Limit, SX126x RX Boosted Gain, and Override Frequency. LoRa config uses an admin message sending a `Config.LoRa` protobuf.
:::note
In order to communicate fully, devices within a mesh must have identical settings for Region and Modem Preset, or identical custom Modem settings.
@ -57,7 +57,7 @@ The Presets available are as follows, and follow a linear pattern of Fastest \<\
Maximum number of hops. This can't be greater than 7. Default is 3 which should be fine for most applications. _**Really, 3 is fine.**_
![Hop Count](/img/configuration/max-hops.png)
![Hop Count](/img/configuration/max-hops.webp)
### Transmit Power
@ -112,6 +112,10 @@ LoRa Channel Configuration should not to be confused with messaging [Channel Con
For testing it is useful sometimes to force a node to never listen to particular other nodes (simulating radio out of range). All nodenums listed in the ignore_incoming array will have packets they send dropped on receive (by router.cpp)
### Ignore MQTT
Setting this to option to 'true' means the device will ignore any messages it receives via LoRa that came via MQTT somewhere along the path towards the device. Note this only works when your device and the MQTT node are running at least firmware version 2.2.19.
### Override Duty Cycle Limit
Setting this option to 'true' means the device will ignore the hourly duty cycle limit in Europe. This means that you might violate regulations if the device transmits too much. By default, this option is set to 'false,' which means the device will stop sending data when it reaches the hourly limit and will start again when it is allowed to do so.
@ -175,6 +179,7 @@ LoRa config commands are available in the python CLI. Example commands are below
| lora.tx_power | `0` to `30` | `0` |
| lora.tx_enabled | `false`, `true` | `true` |
| lora.channel_num | `0`, `1` to `NUM_CHANNELS` | `0` |
| lora.ignore_mqtt | `false`, `true` | `false` |
| lora.override_duty_cycle | `false`, `true` | `false` |
| lora.sx126x_rx_boosted_gain | `false`, `true` | `false` |
| lora.override_frequency | Any supported frequency the LoRA radio is capable of. Please respect local rules and regulations | `0` |

View file

@ -38,7 +38,7 @@ This conversion requires the use of either a [DAPLink](https://daplink.io/) or [
```
3. Download the required bootloader: [WisCore_RAK4631_Board_Bootloader.hex](https://github.com/RAKWireless/WisBlock/releases/download/0.4.2/WisCore_RAK4631_Board_Bootloader.hex)
4. Connect the RAKDAP as follows:
[<img src="/img/rak4631-rakdap1.png" style={{zoom:'25%'}} />](/img/rak4631-rakdap1.png)
[<img src="/img/rak4631-rakdap1.webp" style={{zoom:'25%'}} />](/img/rak4631-rakdap1.webp)
5. Flash the bootloader
```shell
pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex

View file

@ -1,6 +1,6 @@
---
id: buttons
title: Hardware Buttons
title: Heltec LoRa 32 Hardware Buttons
sidebar_label: Buttons
sidebar_position: 1
---

View file

@ -83,7 +83,7 @@ This device may have issues charging a connected battery if utilizing a USB-C to
### Pin Map
![HTIT-WSL_V3_PIN_MAP](</img/hardware/HTIT-WB32LA(F)_V3.png>)
![HTIT-WSL_V3_PIN_MAP](</img/hardware/HTIT-WB32LA(F)_V3.webp>)
Image Source: [Heltec](<https://resource.heltec.cn/download/WiFi_LoRa32_V3/HTIT-WB32LA(F)_V3.png>)
@ -140,8 +140,10 @@ Image Source: [Heltec](https://resource.heltec.cn/download/Wireless_Stick_Lite_V
### Resources
- Firmware file: `firmware-heltec-wsl-v3-X.X.X.xxxxxxx.bin`
- Purchase link: [Heltec](https://heltec.org/project/wireless-stick-lite-v2/)
- Purchase link: [AliExpress](https://www.aliexpress.us/item/3256805256996507.html)
- Purchase Links:
- International
- [Heltec](https://heltec.org/project/wireless-stick-lite-v2/)
- [AliExpress](https://www.aliexpress.us/item/3256805256996507.html)
</TabItem>
@ -193,15 +195,17 @@ With the device now in the Espressif Firmware Download mode, you can proceed wit
### Pin Map
![HT-Tracker_V1 Pin Map](/img/hardware/HT-Tracker_V1_Pin_Map.png)
![HT-Tracker_V1 Pin Map](/img/hardware/HT-Tracker_V1_Pin_Map.webp)
Image Source: [Heltec](https://heltec.org/project/wireless-tracker/)
### Resources
- Firmware file: `firmware-heltec-wireless-tracker-X.X.X.xxxxxxx.bin`
- Purchase link: [Heltec](https://heltec.org/project/wireless-tracker/)
- Purchase link: [AliExpress](https://www.aliexpress.us/item/3256805495189423.html)
- Purchase Links:
- International
- [Heltec](https://heltec.org/project/wireless-tracker/)
- [AliExpress](https://www.aliexpress.us/item/3256805495189423.html)
</TabItem>
@ -241,8 +245,10 @@ This device may have issues charging a connected battery if utilizing a USB-C to
### Resources
- Firmware file: `firmware-heltec-wireless-paper-X.X.X.xxxxxxx.bin`
- Purchase link: [Heltec](https://heltec.org/project/wireless-paper/)
- Purchase link: [AliExpress](https://www.aliexpress.us/item/3256805461611876.html)
- Purchase Links:
- International
- [Heltec](https://heltec.org/project/wireless-paper/)
- [AliExpress](https://www.aliexpress.us/item/3256805461611876.html)
</TabItem>
</Tabs>

View file

@ -1,8 +1,8 @@
---
id: buttons
title: Hardware Buttons
title: LILYGO® TTGO Lora Hardware Buttons
sidebar_label: Buttons
sidebar_position: 3
sidebar_position: 1
---
## Functionality

View file

@ -1,18 +1,18 @@
---
id: gpio
title: GPIO
title: LILYGO® TTGO Lora GPIO
sidebar_label: GPIO
sidebar_position: 4
sidebar_position: 2
---
## GPIO IO12
For the Lora V2.1-1.6 and V2.1-1.8, Shorting IO12 to ground will progress through the screen pages and/or wake up the device. A simple push switch can be added for this purpose.
<img src="/img/hardware/lora32-v2-1.6-button.jpg" width="400" align="left" />
<img src="/img/hardware/lora32-v2-1.6-button.webp" width="400" align="left" />
<img
src="/img/hardware/lora32-v2-1.6-button-example.jpg"
src="/img/hardware/lora32-v2-1.6-button-example.webp"
width="400"
align="left"
/>

View file

@ -51,11 +51,13 @@ This board is still in production but for various reasons not recommended for ne
### Resources
- Firmware file: `firmware-tlora-v1-X.X.X.xxxxxxx.bin`
- Purchase Links
- [AliExpress](https://www.aliexpress.com/item/32996759721.html)
- US Distributor [Rokland](https://store.rokland.com/products/lilygo-ttgo-lora32-v1-0-wireless-module-esp32-lora-915mhz-oled-0-96-inch-display-wifi-bluetooth-esp-32-antenna-ch9102-q184?ref=8Bb2mUO5i-jKwt)
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-ttgo-lora32-v1-0-wireless-module-esp32-lora-915mhz-oled-0-96-inch-display-wifi-bluetooth-esp-32-antenna-ch9102-q184?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/32996759721.html)
![LILYGO® TTGO Lora V1](/img/hardware/lora-v1.png)
![LILYGO® TTGO Lora V1](/img/hardware/lora-v1.webp)
</TabItem>
@ -89,10 +91,11 @@ This board is still in production but for various reasons not recommended for ne
### Resources
- Firmware file: `firmware-tlora_v1_3-X.X.X.xxxxxxx.bin`
- Purchase links
- [AliExpress](https://www.aliexpress.com/item/4000628100802.html)
- Purchase Links:
- International
- [AliExpress](https://www.aliexpress.com/item/4000628100802.html)
![LILYGO® TTGO Lora V1.3](/img/hardware/lora-v1.3.png)
![LILYGO® TTGO Lora V1.3](/img/hardware/lora-v1.3.webp)
![LILYGO® TTGO Lora V1.3 pin map](/img/hardware/lora-v1.3_pinmap.webp)
</TabItem>
@ -130,10 +133,11 @@ This board is still in production but for various reasons not recommended for ne
### Resources
- Firmware file: `firmware-tlora-v2-X.X.X.xxxxxxx.bin`
- Purchase links
- [AliExpress](https://www.aliexpress.com/item/32846302183.html)
- Purchase Links:
- International
- [AliExpress](https://www.aliexpress.com/item/32846302183.html)
![LILYGO® TTGO Lora V2](/img/hardware/lora-v2.0.png)
![LILYGO® TTGO Lora V2](/img/hardware/lora-v2.0.webp)
</TabItem>
<TabItem value="v2.1">
@ -172,11 +176,14 @@ Early versions of some of these boards contained the wrong component in the LiPo
### Resources
- Firmware file: `firmware-tlora-v2-1-1.6-X.X.X.xxxxxxx.bin`
- Purchase Links
- [AliExpress](https://www.aliexpress.com/item/32915894264.html)
- US Distributor [Rokland](https://store.rokland.com/products/lilygo-ttgo-lora32-v2-1_1-6-version-915mhz-esp32-lora-oled-0-96-inch-sd-card-bluetooth-wifi-wireless-module-esp-32-sma-q211?ref=8Bb2mUO5i-jKwt)
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-ttgo-lora32-v2-1_1-6-version-915mhz-esp32-lora-oled-0-96-inch-sd-card-bluetooth-wifi-wireless-module-esp-32-sma-q211?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/32915894264.html)
- [Lilygo](https://www.lilygo.cc/products/lora3)
![TTGO Lora V2.1-1.6](/img/hardware/lora-v2.1-1.6.png)
![TTGO Lora V2.1-1.6](/img/hardware/lora-v2.1-1.6.webp)
</TabItem>
@ -205,7 +212,7 @@ Early versions of some of these boards contained the wrong component in the LiPo
- Firmware file: `firmware-tlora-v2-1-1.8-X.X.X.xxxxxxx.bin`
![TTGO Lora V2.1-1.8](/img/hardware/lora-v2.1-1.8.jpg)
![TTGO Lora V2.1-1.8](/img/hardware/lora-v2.1-1.8.webp)
</TabItem>
@ -261,10 +268,15 @@ If after successfully flashing the device and the screen remains black, you may
### Resources
- Firmware file: `firmware-tlora-t3s3-v1.xxxxxxx.bin`
- Purchase links
- [AliExpress](https://www.aliexpress.com/item/1005004627139838.html)
- Purchase Links:
- US
- [Amazon](https://www.amazon.com/LILYGO-ESP32-S3-Development-Wireless-Display/dp/B0BW5W9QXZ)
- International
- [AliExpress](https://www.aliexpress.com/item/1005004627139838.html)
- [Lilygo](https://www.lilygo.cc/products/t3s3-v1-0)
- [Tindie](https://www.tindie.com/products/lilygo/lilygo-t3-s3-v10-esp32-s3-lora-sx1280-24g/)
![TTGO Lora T3S3 V1](/img/hardware/lora-t3s3.jpg)
![TTGO Lora T3S3 V1](/img/hardware/lora-t3s3.webp)
</TabItem>

View file

@ -1,6 +1,6 @@
---
id: buttons
title: Hardware Buttons
title: Nano Series Hardware Buttons
sidebar_label: Buttons
sidebar_position: 1
---

View file

@ -59,13 +59,13 @@ The Nano G2 Ultra and Nano G1 Explorer have exactly the same Lora front-end circ
### Resources
- Firmware file: `firmware-nano-g2-ultra-X.X.X.xxxxxxx.uf2`
- Official Purchase Links:
- [Official Store](https://shop.uniteng.com/product/meshtastic-mesh-device-nano-g2-ultra/)
- [Official Tindie Store](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-nano-g2-ultra/)
- [Unit Engineering's Official Wiki](https://wiki.uniteng.com/en/meshtastic/nano-g2-ultra)
- Purchase Links:
- International
- [Official Store](https://shop.uniteng.com/product/meshtastic-mesh-device-nano-g2-ultra/)
- [Official Tindie Store](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-nano-g2-ultra/)
Further information on the Nano G2 Ultra can be found on [Unit Engineering's Wiki](https://wiki.uniteng.com/en/meshtastic/nano-g2-ultra).
![Nano G2 Ultra](/img/hardware/nano_g2_ultra.jpeg)
![Nano G2 Ultra](/img/hardware/nano_g2_ultra.webp)
</TabItem>
@ -104,13 +104,13 @@ The Nano G1 Explorer, powered by Meshtastic, is a significant upgrade from the N
### Resources
- Firmware file: `firmware-nano-g1-explorer-X.X.X.xxxxxxx.bin`
- Official Purchase Links:
- [Official Store](https://shop.uniteng.com/product/meshtastic-mesh-device-nano-edition/)
- [Official Tindie Store](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-nano-g1-explorer/)
- [Unit Engineering's Official Wiki](https://wiki.uniteng.com/en/meshtastic/nano-g1-explorer)
- Purchase Links:
- International
- [Official Store](https://shop.uniteng.com/product/meshtastic-mesh-device-nano-edition/)
- [Official Tindie Store](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-nano-g1-explorer/)
Further information on the Nano G1 can be found on [Unit Engineering's Wiki](https://wiki.uniteng.com/en/meshtastic/nano-g1-explorer).
![Nano G1 Explorer](/img/hardware/nano_g1_explorer.jpeg)
![Nano G1 Explorer](/img/hardware/nano_g1_explorer.webp)
</TabItem>
@ -147,10 +147,9 @@ The Nano G1 is the first dedicated hardware device to be designed from scratch p
### Resources
- Firmware file: `firmware-nano-g1-X.X.X.xxxxxxx.bin`
- [Unit Engineering's Official Wiki](https://uniteng.com/wiki/doku.php?id=meshtastic:nano)
Further information on the Nano G1 can be found on [Unit Engineering's Wiki](https://uniteng.com/wiki/doku.php?id=meshtastic:nano).
![Nano G1](/img/hardware/nano-g1-front.jpg)
![Nano G1](/img/hardware/nano-g1-front.webp)
</TabItem>
</Tabs>

View file

@ -52,7 +52,7 @@ Further information on the RAK5005-O can be found on the [RAK Documentation Cent
<img
alt="RAK4631 5005"
src="/img/hardware/rak4631_5005.png"
src="/img/hardware/rak4631_5005.webp"
style={{ zoom: "50%" }}
/>
@ -81,7 +81,7 @@ Further information on the RAK5005-O can be found on the [RAK Documentation Cent
Further information on the RAK19007 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK19007/Overview/#product-description).
### Resources
- Purchase links
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/rak-wireless-wisblock-base-board-2nd-gen-rak19007-ver-b-pid-110082)
- International
@ -113,7 +113,7 @@ Further information on the RAK19007 can be found on the [RAK Documentation Cente
Further information on the RAK19003 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK19003/Overview/#product-description)
### Resources
- Purchase links
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/rak-wireless-wisblock-mini-base-board-rak19003-ver-b-pid-306024)
- International
@ -121,7 +121,7 @@ Further information on the RAK19003 can be found on the [RAK Documentation Cente
<img
alt="RAK4631 19003"
src="/img/hardware/rak4631_19003.png"
src="/img/hardware/rak4631_19003.webp"
style={{ zoom: "50%" }}
/>
@ -152,7 +152,7 @@ Further information on the RAK19003 can be found on the [RAK Documentation Cente
Further information on the RAK19001 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK19001/Overview/#product-description).
### Resources
- Purchase links
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/rak-wireless-wisblock-dual-io-base-board-rak19001-pid-110081)
- International

View file

@ -1,6 +1,6 @@
---
id: buttons
title: Hardware Buttons
title: RAK WisBlock Hardware Buttons
sidebar_label: Buttons
sidebar_position: 3
---

View file

@ -49,7 +49,7 @@ Please be aware of the difference between the RAK4631 (Arduino bootloader) and t
- Firmware file: `firmware-rak4631-X.X.X.xxxxxxx.uf2`
- Further information on the RAK4631 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631/Overview/#product-description).
- Purchase Links
- Purchase Links:
- US
- [Rokland - US915 Mhz](https://store.rokland.com/products/rak-wireless-rak4631-nordic-nrf52840-ble-core-module-for-lorawan-with-lora-sx1262)
- International
@ -58,7 +58,7 @@ Please be aware of the difference between the RAK4631 (Arduino bootloader) and t
<img
alt="RAK4631 Core Module"
src="/img/hardware/rak4631.png"
src="/img/hardware/rak4631.webp"
style={{ zoom: "50%" }}
/>
@ -115,14 +115,14 @@ The RAK11200 does not contain a LoRa transceiver, and thus needs to be added sep
- Firmware file: `firmware-rak11200-X.X.X.xxxxxxx.bin`
- Further information on the RAK11200 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK11200/Overview/#product-description).
- Purchase Links
- Purchase Links:
- International
- [RAK Wireless Store](https://store.rakwireless.com/products/wiscore-esp32-module-rak11200)
- [RAK Wireless Aliexpress](https://www.aliexpress.us/item/3256802312474717.html)
<img
alt="RAK4631 5005 11200"
src="/img/hardware/rak11200.jpg"
src="/img/hardware/rak11200.webp"
style={{ zoom: "50%" }}
/>
@ -160,7 +160,7 @@ The RAK11200 does not contain a LoRa transceiver, and thus needs to be added sep
- Firmware file: `firmware-rak11310-X.X.X.xxxxxxx.uf2`
- Further information on the RAK11310 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK11310/Overview/#product-description).
- Purchase Links
- Purchase Links:
- International
- [RAK Wireless Store](https://store.rakwireless.com/products/rak11310-wisblock-lpwan-module)
- [RAK Wireless Aliexpress](https://www.aliexpress.us/item/3256803225175784.html)

View file

@ -1,6 +1,6 @@
---
id: peripherals
title: Supported Peripherals
title: RAK WisBlock Supported Peripherals
sidebar_label: Peripherals
sidebar_position: 3
---
@ -40,7 +40,7 @@ To add a GPS to the RAK19003 base board, you need the [RAK12500 GPS sensor](http
- RAK Documentation Center
- [RAK12500](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK12500/Overview/#product-description)
- [RAK1910](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1910/Overview/#product-description)
- Purchase Links
- Purchase Links:
- US
- [Rokland RAK1910](https://store.rokland.com/products/rak-wireless-rak1910-wisblock-gnss-location-module)
- [Rokland RAK12500](https://store.rokland.com/products/rak-wireless-rak12500-gnss-gps-location-module-u-blox-zoe-m8q)
@ -57,7 +57,7 @@ The [RAK18001 Buzzer Module](https://store.rakwireless.com/products/wisblock-buz
### Resources
- [RAK Documentation Center RAK18001](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK18001/Overview/#product-description)
- Purchase Links
- Purchase Links:
- International
- [RAK Wireless](https://store.rakwireless.com/products/wisblock-buzzer-module-rak18001)
@ -79,7 +79,7 @@ There is development activity in progress to get sensors such as this added to t
### Resources
- [RAK Documentation Center RAK13002](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK13002/Overview)
- Purchase Links
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/rak-wireless-rak13002-wisblock-io-adapter-module)
- International
@ -120,7 +120,7 @@ The [RAK1906 Environment Sensor](https://store.rakwireless.com/products/rak1906-
- [RAK1901](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1901/Overview/#product-description)
- [RAK1902](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1902/Overview/#product-description)
- [RAK1906](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1906/Overview/#product-description)
- Purchase Links
- Purchase Links:
- US
- [Rokland RAK1901](https://store.rokland.com/products/rak-wireless-rak1901-temperature-and-humidity-sensor-sensirion-shtc3-pid-100001)
- [Rokland RAK1902](https://store.rokland.com/products/rak-wireless-rak1902-barometric-pressure-sensor-stmicroelectronics-lps22hb-100010-2-pack)

View file

@ -1,6 +1,6 @@
---
id: screens
title: Screens
title: RAK WisBlock Screens
sidebar_label: Screens
sidebar_position: 2
---
@ -34,13 +34,13 @@ If pin ordering on the OLED board are swapped, there are some tricks to allow ei
### Resources
- [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1921/Overview/#product-description)
- Purchase Links
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/rak-wireless-wisblock-oled-display-rak1921-pid-110004)
- International
- [RAK Wireless](https://store.rakwireless.com/products/rak1921-oled-display-panel)
[<img alt="0.96 inch OLED display" src="/img/hardware/screen.png" style={{zoom:'25%'}} />](/img/hardware/screen.png)
[<img alt="0.96 inch OLED display" src="/img/hardware/screen.webp" style={{zoom:'25%'}} />](/img/hardware/screen.webp)
</TabItem>
<TabItem value="E-Ink">
@ -60,7 +60,7 @@ Please note only the white-black display is supported at this time, the white-bl
### Resources
- Firmware for 5005 with RAK14000 e-paper: [`firmware-rak4631_eink-X.X.X.xxxxxxx.uf2`](/downloads)
- [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK14000/Overview/#product-description)
- Purchase Links
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/rak-wireless-wisblock-epd-module-rak14000-pid-110024)
- International
@ -68,7 +68,7 @@ Please note only the white-black display is supported at this time, the white-bl
<img
alt="RAK4631 5005 14000"
src="/img/hardware/rak4631_5005_epaper.jpg"
src="/img/hardware/rak4631_5005_epaper.webp"
style={{ zoom: "50%" }}
/>

View file

@ -15,7 +15,7 @@ The Raspberry Pi Pico series is a range of tiny, fast, and versatile boards buil
Only the Pico W has WiFi/BLE capabilities. Meshtastic supports WiFi on the Pico W (although no web server and HTTP API), but does not currently support BLE.
:::
### Pico
## Specifications
- **MCU:**
- Raspberry Pi RP2040
@ -46,8 +46,8 @@ LoRa transmissions may interfere with the USB connection. It is recommended to p
:::
### Pico Resources
### Resources
- Firmware file:`firmware-pico-X.X.X.xxxxxxx.uf2`
- for Pico W use: `firmware-picow-X.X.X.xxxxxxx.uf2`
- for Pico W use: `firmware-picow-X.X.X.xxxxxxx.uf2`
- [Offical Website for the Raspberry Pi Pico](https://www.raspberrypi.com/products/raspberry-pi-pico/), including official reseller links.

View file

@ -1,6 +1,6 @@
---
id: peripherals
title: Supported Peripherals
title: Raspberry Pi Pico Supported Peripherals
sidebar_label: Peripherals
sidebar_position: 1
---
@ -11,4 +11,4 @@ I<sup>2</sup>C peripherals like OLED Displays (e.g. SSD1306 or SH1106) and keybo
## External device using Serial Module
For connecting an external device via the [Serial Module](/docs/configuration/module/serial), it's recommended to use GPIO pins 8 (`serial.txd`) and 9 (`serial.rxd`).
For connecting an external device via the [Serial Module](/docs/configuration/module/serial), it's recommended to use GPIO pins 8 (`serial.txd`) and 9 (`serial.rxd`).

View file

@ -1,6 +1,6 @@
---
id: buttons
title: Hardware Buttons
title: Station G1 Hardware Buttons
sidebar_label: Buttons
sidebar_position: 1
---

View file

@ -7,7 +7,7 @@ sidebar_position: 9
The Station G1 is the second dedicated hardware device to be designed from scratch purely for Meshtastic Licensed (HAM) Operation by Neil Hao. It has been designed to be small and compact with the inclusion of 35dBm high power PA.
### Specifications
## Specifications
- **MCU**
- ESP32 WROOM (WiFi & Bluetooth)
@ -25,7 +25,7 @@ The Station G1 is the second dedicated hardware device to be designed from scrat
- **Connectors**
- USB-C
### Features
## Features
- Meshtastic pre-installed
- User button
@ -33,12 +33,13 @@ The Station G1 is the second dedicated hardware device to be designed from scrat
- Optional GPS Module and IO Extension Socket
- Optional [12V Battery Docker](https://shop.uniteng.com/product/12v-battery-docker-for-station-edition-g1/) which can be used as Backup Power, or in scenarios that require mobility
### Resources
## Resources
- Firmware file: `firmware-station-g1-X.X.X.xxxxxxx.bin`
- [Official Store](https://shop.uniteng.com/product/meshtastic-mesh-device-station-edition/)
- [Official Tindie Store](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-station-edition/)
- [Unit Engineering's Official Wiki](https://uniteng.com/wiki/doku.php?id=meshtastic:station)
- Purchase Links:
- International
- [Official Store](https://shop.uniteng.com/product/meshtastic-mesh-device-station-edition/)
- [Official Tindie Store](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-station-edition/)
Further information on the Station G1 can be found on [Unit Engineering's Wiki](https://uniteng.com/wiki/doku.php?id=meshtastic:station).
![Station G1](/img/hardware/station-g1.jpg)
![Station G1](/img/hardware/station-g1.webp)

View file

@ -1,8 +1,8 @@
---
id: buttons
title: Hardware Buttons
title: T-Beam Hardware Buttons
sidebar_label: Buttons
sidebar_position: 3
sidebar_position: 1
---
## Functionality
@ -17,9 +17,9 @@ sidebar_position: 3
- **Double press:** Sends an adhoc ping of the device's position to the network.
- **Triple press:** Disables the device's GPS. Repeat to re-enable. (_This will be indicated on both information screen pages on the device's display as shown below_)
<img src="/img/hardware/GPS-disabled.jpg" width="200" align="center-left" />
<img src="/img/hardware/GPS-disabled.webp" width="200" align="center-left" />
<img
src="/img/hardware/GPS-disabled-by-button.jpg"
src="/img/hardware/GPS-disabled-by-button.webp"
width="200"
align="center-right"
/>

View file

@ -57,10 +57,12 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
### Resources
- Firmware file: `firmware-tbeam0.7-X.X.X.xxxxxxx.bin`
- Purchase link: [AliExpress](https://www.aliexpress.com/item/4000469332610.html)
- Purchase Links:
- International
- [AliExpress](https://www.aliexpress.com/item/4000469332610.html)
![T-Beam v0.7](/img/hardware/t-beam-v0.7.png)
![T-Beam v0.7 pin map](/img/hardware/t-beam_v0.7_pinmap.jpeg)
![T-Beam v0.7](/img/hardware/t-beam-v0.7.webp)
![T-Beam v0.7 pin map](/img/hardware/t-beam_v0.7_pinmap.webp)
</TabItem>
@ -92,10 +94,14 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
### Resources
- Firmware file: `firmware-tbeam-X.X.X.xxxxxxx.bin`
- Purchase link: [AliExpress](https://www.aliexpress.com/item/4001178678568.html)
- US Distributor - Purchase link: Rokland [No OLED](https://store.rokland.com/products/lilygo-ttgo-t-beam-v1-1-lora-esp32-development-board-wifi-bluetooth-module-gps-neo-6m-sx1276-915mhz-q219?ref=8Bb2mUO5i-jKwt), [OLED](https://store.rokland.com/products/lilygo-ttgo-meshtastic-t-beam-v1-1-esp32-lora-915-mhz-wireless-module-wifi-gps-neo-6m-with-oled-display-soldered-for-arduino-q349)
- Purchase Links:
- US
- [Rokland OLED](https://store.rokland.com/products/lilygo-ttgo-meshtastic-t-beam-v1-1-esp32-lora-915-mhz-wireless-module-wifi-gps-neo-6m-with-oled-display-soldered-for-arduino-q349)
- [Rokland No OLED](https://store.rokland.com/products/lilygo-ttgo-t-beam-v1-1-lora-esp32-development-board-wifi-bluetooth-module-gps-neo-6m-sx1276-915mhz-q219?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/4001178678568.html)
![TTGO T-Beam v1.1](/img/hardware/t-beam-v1.1.png)
![TTGO T-Beam v1.1](/img/hardware/t-beam-v1.1.webp)
![TTGO T-Beam v1.1 pinmap](/img/hardware/t-beam_v1.1_pinmap.webp)
</TabItem>
@ -128,10 +134,13 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
### Resources
- Firmware file: `firmware-tbeam-X.X.X.xxxxxxx.bin`
- Purchase link: [AliExpress](https://www.aliexpress.com/item/32889583204.html)
- US Distributor - Purchase link: [Rokland](https://store.rokland.com/products/lilygo-ttgo-t-beam-v1-1-ipex-esp32-lora-915mhz-wifi-wireless-bluetooth-module-gps-neo-m8n-ipex-18650-battery-holder-q107?ref=8Bb2mUO5i-jKwt)
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-ttgo-t-beam-v1-1-ipex-esp32-lora-915mhz-wifi-wireless-bluetooth-module-gps-neo-m8n-ipex-18650-battery-holder-q107?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/32889583204.html)
![TTGO T-Beam M8N](/img/hardware/t-beam-m8n.png)
![TTGO T-Beam M8N](/img/hardware/t-beam-m8n.webp)
</TabItem>
@ -163,10 +172,13 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
### Resources
- Firmware file: `firmware-tbeam-X.X.X.xxxxxxx.bin`
- Purchase link: [AliExpress](https://www.aliexpress.com/item/4001287221970.html)
- US Distributor - Purchase link: [Rokland](https://store.rokland.com/products/lilygo-t-beam-v1-1-neo-m8n-gnss-ipex-lora-sx1262-915mhz-wireless-module-wifi-bluetooth-board-q215?ref=8Bb2mUO5i-jKwt)
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-t-beam-v1-1-neo-m8n-gnss-ipex-lora-sx1262-915mhz-wireless-module-wifi-bluetooth-board-q215?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/4001287221970.html)
![T-Beam M8N & SX1262](/img/hardware/t-beam-sx1262.png)
![T-Beam M8N & SX1262](/img/hardware/t-beam-sx1262.webp)
</TabItem>
@ -198,9 +210,11 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
### Resources
- Firmware file: `firmware-tbeam-s3-core-X.X.X.xxxxxxx.bin`
- Purchase Link: [AliExpress](https://www.aliexpress.com/item/1005005418286231.html)
- Purchase Links:
- International
- [AliExpress](https://www.aliexpress.com/item/1005005418286231.html)
![T-Beam S3-Core](/img/hardware/T-BEAM-S3Core.jpg)
![T-Beam S3-Core](/img/hardware/T-BEAM-S3Core.webp)
</TabItem>
@ -257,12 +271,15 @@ With the device now in the Espressif Firmware Download mode, you can proceed wit
### Resources
- Firmware file: `firmware-tbeam-s3-core-X.X.X.xxxxxxx.bin`
- Purchase links:
- LilyGO Store: [Meshtastic T-Beam 433/868/915/923Mhz](https://www.lilygo.cc/products/t-beam-v1-1-esp32-lora-module)
- AliExpress: [Meshtastic T-Beam 868/915MHz](https://www.aliexpress.com/item/1005005418286231.html)
- US Distributor - Purchase link: Rokland [NEO-M10S](https://store.rokland.com/products/lilygo-t-beam-supreme-esp32-s3-lora-development-board-sx1262-915mhz-gps-l76k-or-u-blox?variant=41051191378003), [Quectel L76K](https://store.rokland.com/products/lilygo-t-beam-supreme-esp32-s3-lora-development-board-sx1262-915mhz-gps-l76k-or-u-blox?variant=41051191345235)
- Purchase Links:
- International
- [LilyGO Store](https://www.lilygo.cc/products/t-beam-v1-1-esp32-lora-module)
- [AliExpress](https://www.aliexpress.com/item/1005005418286231.html)
- US
- [Rokland NEO-M10S](https://store.rokland.com/products/lilygo-t-beam-supreme-esp32-s3-lora-development-board-sx1262-915mhz-gps-l76k-or-u-blox?variant=41051191378003)
- [Rokland Quectel L76K](https://store.rokland.com/products/lilygo-t-beam-supreme-esp32-s3-lora-development-board-sx1262-915mhz-gps-l76k-or-u-blox?variant=41051191345235)
![T-Beam Supreme](/img/hardware/T-BEAM-S3-Supreme.jpg)
![T-Beam Supreme](/img/hardware/T-BEAM-S3-Supreme.webp)
</TabItem>

View file

@ -1,17 +1,12 @@
---
id: screens
title: Screens
title: T-Beam Screens
sidebar_label: Screens
sidebar_position: 2
---
## 0.96 inch OLED I<sup>2</sup>C display
- [Purchase link](https://www.aliexpress.com/item/32922106384.html)
- US Distributor - Purchase link: [Rokland](https://store.rokland.com/products/lilygo-ttgo-0-96-inch-oled-white-color-text-display-module-l206-for-t-beam-and-t-sim)
![0.96 inch OLED display](/img/hardware/screen.png)
### Pin map
To attach the screen:
@ -21,4 +16,13 @@ To attach the screen:
3. Connect SCL to pin 22
4. Connect SDA to pin 21
![Connecting the OLED screen to a T-Beam](/img/hardware/t-beam-screen.jpg)
![Connecting the OLED screen to a T-Beam](/img/hardware/t-beam-screen.webp)
### Resources
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-ttgo-0-96-inch-oled-white-color-text-display-module-l206-for-t-beam-and-t-sim)
- International
- [Aliexpress](https://www.aliexpress.com/item/32922106384.html)
![0.96 inch OLED display](/img/hardware/screen.webp)

View file

@ -52,9 +52,11 @@ With the device now in the Espressif Firmware Download mode, you can proceed wit
## Resources
- Firmware file: `firmware-t-deck-X.X.X.xxxxxxx.bin`
- Purchase links:
- LilyGO Store: [T-Deck 433/868/915Mhz](https://www.lilygo.cc/products/t-deck)
- AliExpress: [T-Deck 433/868/915MHz](https://www.aliexpress.us/item/3256805505920840.html)
- US Distributor - Purchase link: Rokland [915MHz](https://store.rokland.com/products/lilygo-t-deck-portable-microcontroller-programmer-lora-915-mhz-h642)
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-t-deck-portable-microcontroller-programmer-lora-915-mhz-h642)
- International
- [LilyGO Store](https://www.lilygo.cc/products/t-deck)
- [AliExpress](https://www.aliexpress.us/item/3256805505920840.html)
![T-Deck](/img/hardware/LILYGO-T-DECK.jpg)
![T-Deck](/img/hardware/LILYGO-T-DECK.webp)

View file

@ -1,8 +1,8 @@
---
id: buttons
title: Hardware Buttons
title: T-Echo Hardware Buttons
sidebar_label: Buttons
sidebar_position: 3
sidebar_position: 1
---
## Functionality
@ -17,4 +17,4 @@ sidebar_position: 3
- **Double press:** Turns the screen backlight on/off and sends an adhoc ping of the device's position to the network.
- **Long press:** Signals the device to shutdown after 5 seconds.
![TechoButtons](/img/hardware/t-echo-lilygo.jpg)
![TechoButtons](/img/hardware/t-echo-lilygo.webp)

View file

@ -1,16 +0,0 @@
---
id: enclosures
title: Enclosures
sidebar_label: Enclosures
sidebar_position: 3
---
## Created by BrianN
### T-Echo Expedition Case
Download from [Thingiverse](https://www.thingiverse.com/thing:5028720).
<img src="/img/enclosures/3dp-briann-techo-exp.jpg" width="400" align="left" />
<!-- ![T-Echo Expedition](/img/enclosures/3dp-briann-techo-exp.jpg) -->

View file

@ -34,9 +34,12 @@ Further information on the LILYGO® T-Echo devices can be found on LILYGO®'s [G
## Resources
- Firmware file: `firmware-t-echo-2.x.x.uf2`
- Purchase links:
- LilyGO Store: [T-Echo Meshtastic 433/868/915MHz](https://www.lilygo.cc/products/t-echo)
- AliExpress: [T-Echo Meshtastic 433/868/915MHz with optional BME280 sensor](https://www.aliexpress.com/item/1005003026107533.html)
- US Distributor - Rokland: [915MHz](https://store.rokland.com/products/lilygo-ttgo-meshtastic-t-echo-white-lora-sx1262-wireless-module-915mhz-nrf52840-gps-for-arduino?ref=8Bb2mUO5i-jKwt) [915MHz BME280 Kit](https://store.rokland.com/products/lilygo-ttgo-meshtastic-t-echo-white-bme280-lora-sx1262-wireless-module-915mhz-nrf52840-gps-rtc-nfc-for-arduino?ref=8Bb2mUO5i-jKwt)
- Purchase Links:
- US
- [Rokland 915MHz](https://store.rokland.com/products/lilygo-ttgo-meshtastic-t-echo-white-lora-sx1262-wireless-module-915mhz-nrf52840-gps-for-arduino?ref=8Bb2mUO5i-jKwt)
- [Rokland 915MHz w/ BME280 Kit](https://store.rokland.com/products/lilygo-ttgo-meshtastic-t-echo-white-bme280-lora-sx1262-wireless-module-915mhz-nrf52840-gps-rtc-nfc-for-arduino?ref=8Bb2mUO5i-jKwt)
- International
- [LilyGO](https://www.lilygo.cc/products/t-echo)
- [AliExpress](https://www.aliexpress.com/item/1005003026107533.html)
![LILYGO T-Echo](/img/hardware/t-echo.svg)

View file

@ -47,7 +47,7 @@ The following process will manually place the device into the Espressif Firmware
2. Remove the device's back cover.
3. Locate and press and hold the boot button.
![T Watch S3 Boot Button](/img/hardware/T-Watch-S3-BUTTON.jpg)
![T Watch S3 Boot Button](/img/hardware/T-Watch-S3-BUTTON.webp)
4. While holding the boot button, press the crown button once to turn the device on.
5. After 2-3 seconds, release the BOOT button.
@ -57,9 +57,11 @@ With the device now in the Espressif Firmware Download mode, you can proceed wit
## Resources
- Firmware file: `firmware-t-watch-X.X.X.xxxxxxx.bin`
- Purchase links:
- LilyGO Store: [T-Watch 433/868/915Mhz](https://www.lilygo.cc/products/t-watch-s3)
- AliExpress: [T-Watch 433/868/915MHz](https://www.aliexpress.us/item/3256805456685117.html)
- US Distributor - Purchase link: Rokland [915MHz](https://store.rokland.com/products/lilygo-t-watch-s3-open-source-smartwatch-with-lora-and-esp32)
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-t-watch-s3-open-source-smartwatch-with-lora-and-esp32)
- International
- [LilyGO](https://www.lilygo.cc/products/t-watch-s3)
- [AliExpress](https://www.aliexpress.us/item/3256805456685117.html)
![T-Watch](/img/hardware/LILYGO-T-Watch-S3.jpg)
![T-Watch](/img/hardware/LILYGO-T-Watch-S3.webp)

View file

@ -54,7 +54,7 @@ _Google Play and the Google Play logo are trademarks of Google LLC._
<a href="https://github.com/meshtastic/Meshtastic-Android/releases/latest">
<img
alt="Download at https://github.com/meshtastic/Meshtastic-Android/releases/latest"
src="/img/android/get-it-on-github.png"
src="/img/android/get-it-on-github.webp"
width="49%"
/>
</a>

View file

@ -9,7 +9,7 @@ sidebar_position: 2
The Meshtastic Android app handles the communication and can show the location of everyone in your private group. Each member of your private mesh can see the location and distance of members and text messages sent to your group chat.
[![No device connected](/img/android/android-settings-none-sm.png)](/img/android/android-settings-none.png)
[![No device connected](/img/android/android-settings-none-sm.webp)](/img/android/android-settings-none.webp)
Open the app and you should see the Settings tab like the screen above. Notice the cloud with a slash through it in the upper right, showing no device connection. You can move through the tabs but nothing much will be visible until you connect to a radio device.
@ -17,11 +17,11 @@ Open the app and you should see the Settings tab like the screen above. Notice t
You will need a device with Meshtastic installed to go any further. See the [getting started](/docs/getting-started) section for information on how to do this.
[![Search for devices](/img/android/android-settings-none-c.png)](/img/android/android-settings-none.png)
[![Search for devices](/img/android/android-settings-none-c.webp)](/img/android/android-settings-none.webp)
To find devices to connect via Bluetooth click the "+" button on the bottom right corner.
[![Device available to select](/img/android/android-settings-connect-sm.png)](/img/android/android-settings-connect.png)
[![Device available to select](/img/android/android-settings-connect-sm.webp)](/img/android/android-settings-connect.webp)
1. Select the device name, `Meshtastic_769d` in this example. (You will see devices within range, so make sure to get the right one.)
2. Before you can connect for the first time, you need to "pair" the devices to allow communication between them. Some devices are pinless, others require entering a PIN shown on the device screen.
@ -31,15 +31,15 @@ To find devices to connect via Bluetooth click the "+" button on the bottom righ
:::
3. This starts the communication with the device. The cloud icon on the status bar should change and show a check mark.
[![Device connected](/img/android/android-settings-mike-c.png)](/img/android/android-settings-mike-c.png)
[![Device connected](/img/android/android-settings-mike-c.webp)](/img/android/android-settings-mike-c.webp)
The cloud icon at the top right corner indicates if you are connected to a device. This currently has three states:
![Not connected](/img/android/android-cloud-cross.png) Cloud with a slash through it: No device connected to the application.
![Not connected](/img/android/android-cloud-cross.webp) Cloud with a slash through it: No device connected to the application.
![Connected](/img/android/android-cloud-tick.png) Cloud with a tick in it: Device connected to the application.
![Connected](/img/android/android-cloud-tick.webp) Cloud with a tick in it: Device connected to the application.
![Sleeping](/img/android/android-cloud-up.png) Cloud with an up arrow in it: Device is connected, but currently sleeping or out of range.
![Sleeping](/img/android/android-cloud-up.webp) Cloud with an up arrow in it: Device is connected, but currently sleeping or out of range.
## Common tasks
@ -52,7 +52,7 @@ In order to start communicating with your mesh, you must select a region. This s
Edit the "Your name", e.g. to be "Mike Bird". This is the name that other people will see, so make it unique within your group. The initials e.g. "MB" should also be unique and will be used to identify you in the message history and on the device screens. Initials, or "short name", can be customized in the Radio configuration - User settings. The four characters displayed after your initials cannot be changed. These are the last four hex digits of the device MAC address. Devices with unset names will display these four characters as the device short name.
[![Changing device name](/img/android/android-settings-mike-sm.png)](/img/android/android-settings-mike.png)
[![Changing device name](/img/android/android-settings-mike-sm.webp)](/img/android/android-settings-mike.webp)
### Setup a channel
@ -62,15 +62,15 @@ You can also create a new Channel and share the details with your group. The gro
The Channel tab allows you to create a new private mesh. This screen is initially locked so that you don't change it accidentally. Press the lock symbol, and you will be able to edit. First, select the Channel options, as shown here, and chose the most appropriate option:
[![Changing channel settings](/img/android/android-change-channel-sm.png)](/img/android/android-change-channel.png)
[![Changing channel settings](/img/android/android-change-channel-sm.webp)](/img/android/android-change-channel.webp)
Here we selected `Long Range / Fast`, and then made a Channel Name using the keyboard. This identifies your group, here "Owl Team".
[![Changing channel name](/img/android/android-channel-owl-sm.png)](/img/android/android-channel-owl.png)
[![Changing channel name](/img/android/android-channel-owl-sm.webp)](/img/android/android-channel-owl.webp)
You will see a warning because changing the Channel will break communications with your group, i.e. if you change your settings without sharing the new details with the group.
[![Do you want to change the channel?](/img/android/android-new-channel-sm.png)](/img/android/android-new-channel.png)
[![Do you want to change the channel?](/img/android/android-new-channel-sm.webp)](/img/android/android-new-channel.webp)
The app will generate a new QR code on the screen. This encodes the channel details and a random 256-bit key for sharing with the new group. You can share the QR code with other Meshtastic users, or use the Share button and share the link via chat message, SMS, or email. The link is a very long code, for example: https://www.meshtastic.org/d/#CgUYAyIBAQ
@ -78,7 +78,7 @@ The app will generate a new QR code on the screen. This encodes the channel det
1. If another user shares a QR code, you will be able to scan it directly with your camera using the `Scan` button.
[![Open with Meshtastic](/img/android/android-open-with-c.png)](/img/android/android-open-with.png)
[![Open with Meshtastic](/img/android/android-open-with-c.webp)](/img/android/android-open-with.webp)
2. If the channel is shared from a file or link using the `Share` button, you can click on the file or link and you need to choose "Open with Meshtastic".
@ -88,7 +88,7 @@ The app will generate a new QR code on the screen. This encodes the channel det
3. If you see the option "Open the supported links", make sure it is enabled.
:::
[![Accept new channel](/img/android/android-accept-channel-c.png)](/img/android/android-accept-channel.png)
[![Accept new channel](/img/android/android-accept-channel-c.webp)](/img/android/android-accept-channel.webp)
Proceed and you should see a message like "Do you want to switch to the 'Owl Team' channel?".
Accept this, and the app will change to this new channel. You will lose any current channel setting!
@ -99,11 +99,11 @@ Setting the same Name and Options directly doesn't work as there are other radio
You can test changing channels with the QR code shown below.
![Meshtastic Default Channel](/img/android/default-channel.png)
![Meshtastic Default Channel](/img/android/default-channel.webp)
### Send a message
[![Messages](/img/android/android-messages-sm.png)](/img/android/android-messages.png)
[![Messages](/img/android/android-messages-sm.webp)](/img/android/android-messages.webp)
The message window operates like most messaging apps. Note that your primary channel i.e. `LongFast` contact is always shown and works as a group chat. Other contacts are for direct messaging, or private group chats.
@ -122,7 +122,7 @@ By default there is no long-term store-and-forward of messages, so messages not
### View your network
[![Local Meshtastic network](/img/android/android-nodes-sm.png)](/img/android/android-nodes.png)
[![Local Meshtastic network](/img/android/android-nodes-sm.webp)](/img/android/android-nodes.webp)
The network list shows all the users (devices) that have connected to the same Channel. For each entry, it shows the last time they were active, their location and distance (when available), and their last known power status. In the example above, Monkey is the local user, Rabbit was last heard from 10 minutes ago and is 50m away, and Panda was last heard 11 minutes ago and 5m away.
@ -131,36 +131,36 @@ The network list shows all the users (devices) that have connected to the same C
### View the map
[![Meshtastic Map View](/img/android/android-map-sm.png)](/img/android/android-map.png)
[![Meshtastic Map View](/img/android/android-map-sm.webp)](/img/android/android-map.webp)
The Map tab will show a local map with an icon for each active mesh node that has a known position. The users names are shown above the icon.
[![Map Layers](/img/android/android-map-layers-c.png)](/img/android/android-map-layers.png)
[![Map Layers](/img/android/android-map-layers-c.webp)](/img/android/android-map-layers.webp)
- Clicking the layers icon in the top-right will allow you to select the map type.
### Offline maps
[![Download offline maps](/img/android/android-map-download-c.png)](/img/android/android-map-download.png)
[![Download offline maps](/img/android/android-map-download-c.webp)](/img/android/android-map-download.webp)
- Some map types allow downloading for offline use. If offline maps are available for your selected map type, a download icon will appear in the bottom-right corner of the map. Tap this icon and choose the option to Download Region, then select the area you wish to download.
## Configuration options
[![Meshtastic configuration options](/img/android/android-settings-options-c.png)](/img/android/android-settings-options.png)
[![Meshtastic configuration options](/img/android/android-settings-options-c.webp)](/img/android/android-settings-options.webp)
Pressing the three vertical dots in the top right corner shows the configuration menu.
### Debug Panel
[![Debug page](/img/android/android-debug-sm.png)](/img/android/android-debug.png)
[![Debug page](/img/android/android-debug-sm.webp)](/img/android/android-debug.webp)
The debug panel allows you to see all packets sent between the application and the device. This can be useful for debugging purposes.
### Radio Configuration
[![Meshtastic configuration options](/img/android/android-radio-configuration-c.png)](/img/android/android-radio-configuration.png)
[![Meshtastic configuration options](/img/android/android-radio-configuration-c.webp)](/img/android/android-radio-configuration.webp)
Radio Configuration opens a list of all radio and module configuration settings.
- See [Radio Config](/docs/configuration/radio) for radio settings.
@ -175,7 +175,7 @@ To reset the values go to the Debug Panel and press the "Clear" button.
### Theme
[![Meshtastic theme](/img/android/android-settings-theme-c.png)](/img/android/android-settings-theme.png)
[![Meshtastic theme](/img/android/android-settings-theme-c.webp)](/img/android/android-settings-theme.webp)
Allows you to change between light and dark themes, or to select the system default.
@ -189,7 +189,7 @@ Opens the introduction slideshow.
### Quick chat options
[![Quick Chat](/img/android/android-quick-chat-sm.png)](/img/android/android-quick-chat.png)
[![Quick Chat](/img/android/android-quick-chat-sm.webp)](/img/android/android-quick-chat.webp)
Brings up an editor to create and edit quick response messages. These will appear as buttons in the chat window. Messages have the option to send instantly, or be appended to your message and sent manually.

View file

@ -8,6 +8,6 @@ sidebar_label: Installation
<a href="https://apple.co/3Auysep">
<img
alt="Meshtastic App Store Launch Image"
src="/img/apple/meshtastic-1080x1080.png"
src="/img/apple/meshtastic-1080x1080.webp"
/>
</a>

View file

@ -38,25 +38,25 @@ To setup CalTopo for Meshtastic integration using the Live Tracking via APRS, re
Example `topo.properties` file configuration for use with Meshtastic:
![topo.properties](/img/software/integrations/caltopo/properties.png)
![topo.properties](/img/software/integrations/caltopo/properties.webp)
After starting CalTopo Desktop, NMEA waypoint location sentences should be streamed into the logs from the connected Meshtastic device every 10 seconds:
![CalTopo Logs](/img/software/integrations/caltopo/logs.png)
![CalTopo Logs](/img/software/integrations/caltopo/logs.webp)
In the desktop's web UI for your CalTopo map, scroll down and check the **Shared Locations** checkbox under **Realtime Data**. Your nodes should appear on the map as points if they are connected correctly.
![shared-locations](/img/software/integrations/caltopo/local-stations.png)
![shared-locations](/img/software/integrations/caltopo/local-stations.webp)
You can click on one or more of the node points and in the resulting tooltip, click **Record to Map**
![node point](/img/software/integrations/caltopo/click.png)
![node point](/img/software/integrations/caltopo/click.webp)
In the resulting dialog, you can assign attributes such as a label or color to the live track created by the node.
![track](/img/software/integrations/caltopo/track.png)
![track](/img/software/integrations/caltopo/track.webp)
When you view the shared map on another device or mobile, the nodes should appear there as well now, if both the desktop and mobile device have internet connectivity.
![app](/img/software/integrations/caltopo/app.png)
![app](/img/software/integrations/caltopo/app.webp)

View file

@ -2,7 +2,7 @@
title: Meshtastic Integrations
slug: /software/integrations
sidebar_label: Integrations
sidebar_position: 11
sidebar_position: 6
---
The Meshtastic ecosystem is highly extensible and allows easy integration with a number of existing software products and projects.
@ -13,4 +13,6 @@ Current Meshtastic integrations:
- [ATAK Plugin](/docs/software/integrations/integrations-atak-plugin) - Official Meshtastic ATAK Plugin for sending CoT to IMeshService in the Meshtastic Android app.
- [MQTT](/docs/software/integrations/mqtt) - Bridging mesh networks over the internet and integrating Meshtastic protocols with popular technologies such as Home Assistant, Node Red, and Adafruit IO.
Support for the integrated products should be sought from their respective authors or vendors.

View file

@ -198,7 +198,7 @@ Always Check Configuration before reloading YAML or restarting Home Assistant to
:::
![HA Developer Tools](/img/software/mqtt/ha_developer_tools.png)
![HA Developer Tools](/img/software/mqtt/ha_developer_tools.webp)
## Create Dashboard Cards
@ -206,13 +206,13 @@ Always Check Configuration before reloading YAML or restarting Home Assistant to
Create a new Entities Card and select the entities you have created.
![HA Entities Card](/img/software/mqtt/ha_entities_card.png)
![HA Entities Card](/img/software/mqtt/ha_entities_card.webp)
### Logbook Card for Messaging
The logbook card is useful to keep a record of incoming messages from the mesh. Below is an example of how the logbook card would be set up.
![HA Logbook Card](/img/software/mqtt/ha_logbook_card.png)
![HA Logbook Card](/img/software/mqtt/ha_logbook_card.webp)
## Trigger HA Automations
@ -223,7 +223,7 @@ It is possible to have Home Assistant trigger automations based on messages or e
This example waits for a message containing @Tropho and then sends a pop-up notification to his flip phone with the message. Optionally you can have ALL messages from the mesh sent as HA notifications to your phone.
![HA At Tropho Message](/img/software/mqtt/ha_at_tropho.png)
![HA At Tropho Message](/img/software/mqtt/ha_at_tropho.webp)
Add the following code to your automations.yaml file. Be sure to modify the `topic`, `regex_search`, and `service` for your configuration.
```yaml
@ -264,11 +264,11 @@ It is possible to create an input text box to send messages to your mesh from wi
First, create an input text helper entity. The preferred way to configure an input text is via the HA interface at Settings > Devices & Services > Helpers. Click the add button and then choose the Text option. Make a text input helper with a max length of 190 to be on the safe side. See example below:
![HA Input Text Helper](/img/software/mqtt/ha_input_text_helper.png)
![HA Input Text Helper](/img/software/mqtt/ha_input_text_helper.webp)
### Create a Send Message Automation
This automation will check the send box for changes. After typing a message, either hit enter or click off the box and the automation will send a text string in JSON to the mqtt broker. Make sure to update the channel name and device ID in the example below.
This automation will check the send box for changes. After typing a message, either hit enter or click off the box and the automation will send a text string in JSON to the mqtt broker. Make sure to call your channel "mqtt" and to update the device ID and `from` field in the example below.
```yaml
- alias: Meshtastic - Send Automation
@ -288,9 +288,9 @@ This automation will check the send box for changes. After typing a message, ei
data:
qos: 0
retain: false
topic: msh/2/json/LongFast/!67ea9400
topic: msh/2/json/mqtt/!67ea9400
payload: >-
{"channel":"0","sender":"broker","type":"sendtext","payload":"{{
{"from":1743426560,"type":"sendtext","payload":"{{
states('input_text.meshtastic_send_box') }}"}
- delay:
hours: 0
@ -310,4 +310,4 @@ This automation will check the send box for changes. After typing a message, ei
mode: single
```
Add this card to your dashboard by going to Edit Dashboard -> + ADD CARD. Then search BY ENTITY for Meshtastic Send Box and check the box next to the entry. Click CONTINUE, then ADD TO DASHBOARD.
Add this card to your dashboard by going to Edit Dashboard -> + ADD CARD. Then search BY ENTITY for Meshtastic Send Box and check the box next to the entry. Click CONTINUE, then ADD TO DASHBOARD.

View file

@ -7,7 +7,7 @@ sidebar_position: 6
## Bridging networks
![Common MQTT Layout](/img/software/mqtt/mqtt.png)
![Common MQTT Layout](/img/software/mqtt/mqtt.webp)
Meshtastic networks in different locations beyond the reach of LoRa can be easily bridged together using MQTT. The simplest option is to connect your mesh to the official Meshtastic MQTT broker. This makes your devices appear on the world map, and provides a copy of your mesh traffic, translated into JSON. All you have to do to join the public MQTT server is to Enable MQTT and set Uplink and Downlink on the channels that you want to share over MQTT. The default device configuration using the public MQTT Server is encrypted.
@ -96,11 +96,14 @@ The `from` field can thus be used as a stable identifier for a specific node. N
If the message received contains valid JSON in the payload, the JSON is deserialized and added as a JSON object rather than a string containing the serialized JSON.
**Sent messages** will be checked if the MQTT payload contains a valid JSON-encoded envelope:
#### JSON downlink to instruct a node to send a message
You can also send a JSON message to the topic `msh/2/json/mqtt/` to instruct a gateway node to send a message to the mesh. Note that the channel **must** be called "mqtt". The JSON message should contain the following fields:
```json
{
"sender": "SENDER",
"from": <node number>,
"type": "type",
"payload": {
"key":"value"
...
@ -108,7 +111,10 @@ If the message received contains valid JSON in the payload, the JSON is deserial
}
```
`sender` and `payload` fields are required for a valid envelope. If a valid MQTT message is found, the message is sent over the radio as a message of type `TEXT_MESSAGE_APP` with the serialized `payload` value in the message payload.
`from` and `payload` fields are required for a valid envelope (note that in firmware &lt;2.2.20 a field `sender` was required, but this is no longer the case). The `from` field should be equal to the node number of the node that will transmit the message. Optionally, you can specify a destination by setting the `to` field to the node number of the destination. If the `to` field is not set, the message will be broadcast to all nodes on the mesh.
Currently two types of messages are supported: `"sendtext"` and `"sendposition"`.
For the type `sendtext`, the `payload` should be a string containing the text to send. For the type `sendposition`, the payload should be an object with the fields `latitude_i`, `longitude_i`, `altitude` (optional) and `time` (optional).
### Basic Configuration
@ -139,12 +145,12 @@ An existing public [MQTT broker](https://mosquitto.org) will be the default for
## Examples
- [Using mosquitto on a mac](/docs/software/mqtt/mosquitto.mdx)
- [Using mosquitto on a mac](/docs/software/integrations/mqtt/mosquitto.mdx)
- [Sending/receiving messages on mosquitto server using python](/docs/software/mqtt/python.mdx)
- [Sending/receiving messages on mosquitto server using python](/docs/software/integrations/mqtt/python.mdx)
- [Using MQTT with Node-RED](/docs/software/mqtt/nodered.mdx)
- [Using MQTT with Node-RED](/docs/software/integrations/mqtt/nodered.mdx)
- [Using MQTT with Home Assistant](/docs/software/mqtt/home-assistant.mdx)
- [Using MQTT with Home Assistant](/docs/software/integrations/mqtt/home-assistant.mdx)
- [Using MQTT with Adafruit IO](/docs/software/mqtt/adafruit-io.mdx)
- [Using MQTT with Adafruit IO](/docs/software/integrations/mqtt/adafruit-io.mdx)

View file

@ -54,13 +54,13 @@ The JSON output only publishes the following subset of the messages on a Meshtas
> Protobufs are mesh native.
#### 1. Using JSON-encoded messages
Make sure that option *JSON Output Enabled* is set in MQTT module options.
Make sure that option *JSON Output Enabled* is set in MQTT module options and your channel is called "mqtt".
Below is a valid JSON envelope for information sent by MQTT to a device for broadcast onto the mesh.
```json
{
"sender":"whatever you want to be the SENDER",
"from":<node number of the transmitter>,
"type":"sendtext",
"payload": text or a json object go here
}
@ -979,11 +979,11 @@ The flow is:
]
```
Sending a position to a device for broadcast to the mesh is much easier with JSON. This introduces a new MQTT Service Envelope type: "sendposition". A valid MQTT envelope and message to broadcast lat, lon, altitude looks like this.
Sending a position to a device for broadcast to the mesh is much easier with JSON. It requires a channel called "mqtt". This introduces a new MQTT Service Envelope type: "sendposition". A valid MQTT envelope and message to broadcast lat, lon, altitude (optional) and time (optional) looks like this:
```json
{
"sender": "someSender",
"from": 2130636288,
"type": "sendposition",
"payload": {
"latitude_i": 399600000,

View file

@ -2,7 +2,7 @@
id: linux-native
title: Linux Native Application
sidebar_label: Linux Native
sidebar_position: 9
sidebar_position: 5
---
The device software can also run on a native Linux machine thanks to the [Portduino framework](https://github.com/geeksville/framework-portduino).

View file

@ -12,7 +12,7 @@ There are three ways of accessing the app:
2. A hosted version located at [client.meshtastic.org](https://client.meshtastic.org).
3. Hosting it yourself.
![WebUI](/img/webUI.png)
![WebUI](/img/webUI.webp)
## Compatibility

View file

@ -36,7 +36,7 @@ const SocialCards: SocialCardProps[] = [
<img
alt="facebook"
className="m-auto h-14"
src="/img/homepage/f_logo_RGB-White_1024.png"
src="/img/homepage/f_logo_RGB-White_1024.webp"
/>
),
},

Binary file not shown.

Before

Width:  |  Height:  |  Size: 897 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 480 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.1 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 180 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.1 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 506 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 884 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 554 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 746 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 525 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 786 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Some files were not shown because too many files have changed in this diff Show more