mirror of
https://github.com/meshtastic/meshtastic.git
synced 2025-03-05 21:00:08 -08:00
Merge branch 'master' into i18n
This commit is contained in:
Thomas Göttgens
GitHub
commit
f14a781612
|
|
@ -1,4 +0,0 @@
|
|||
{
|
||||
"plugins": ["@docusaurus"],
|
||||
"extends": ["plugin:@docusaurus/recommended"]
|
||||
}
|
||||
3
.gitattributes
vendored
Normal file
3
.gitattributes
vendored
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
* text=auto eol=lf
|
||||
*.{cmd,[cC][mM][dD]} text eol=crlf
|
||||
*.{bat,[bB][aA][tT]} text eol=crlf
|
||||
44
.github/workflows/ci.yml
vendored
44
.github/workflows/ci.yml
vendored
|
|
@ -1,38 +1,28 @@
|
|||
name: CI
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- 'master'
|
||||
workflow_run:
|
||||
workflows:
|
||||
- 'Update protobufs'
|
||||
pull_request:
|
||||
|
||||
jobs:
|
||||
deploy-website:
|
||||
environment: Production
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout code
|
||||
- name: Checkout code & submodules
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
#- name: Install Go
|
||||
# uses: actions/setup-go@v3
|
||||
# with:
|
||||
# go-version: 1.19
|
||||
#- name: Install Protoc
|
||||
# uses: arduino/setup-protoc@v1
|
||||
# with:
|
||||
# version: '3.x'
|
||||
#- name: Install protoc-gen-doc
|
||||
# run: go install github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc@latest
|
||||
#- name: Generate protobuf docs
|
||||
# run: protoc --doc_out="docs/developers/Protobufs" --doc_opt="./protobuf.tmpl,api.mdx" --proto_path="protobufs" protobufs/*.proto
|
||||
- uses: amondnet/vercel-action@v20
|
||||
|
||||
- name: Setup pnpm
|
||||
uses: pnpm/action-setup@v2.2.1
|
||||
with:
|
||||
vercel-token: ${{ secrets.VERCEL_TOKEN }}
|
||||
vercel-args: '--prod'
|
||||
vercel-org-id: ${{ secrets.ORG_ID}}
|
||||
vercel-project-id: ${{ secrets.PROJECT_ID}}
|
||||
scope: ${{ secrets.ORG_ID}}
|
||||
version: latest
|
||||
|
||||
- name: Install Dependencies
|
||||
run: pnpm install
|
||||
|
||||
- name: Trunk Check
|
||||
uses: trunk-io/trunk-action@v1
|
||||
|
||||
- name: Build Site
|
||||
run: pnpm build
|
||||
|
|
|
|||
27
.github/workflows/nightly.yml
vendored
Normal file
27
.github/workflows/nightly.yml
vendored
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
name: Nightly
|
||||
on:
|
||||
schedule:
|
||||
- cron: 0 8 * * 1-5
|
||||
workflow_dispatch: {}
|
||||
|
||||
jobs:
|
||||
trunk_check:
|
||||
name: Trunk Check Upload
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
|
||||
- name: Setup pnpm
|
||||
uses: pnpm/action-setup@v2.2.1
|
||||
with:
|
||||
version: latest
|
||||
|
||||
- name: Install Dependencies
|
||||
run: pnpm install
|
||||
|
||||
- name: Trunk Check
|
||||
uses: trunk-io/trunk-action@v1
|
||||
with:
|
||||
trunk-token: ${{ secrets.TRUNK_TOKEN }}
|
||||
31
.github/workflows/pr.yml
vendored
31
.github/workflows/pr.yml
vendored
|
|
@ -1,31 +0,0 @@
|
|||
name: Pull Request
|
||||
|
||||
on: pull_request
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout code & submodules
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
|
||||
- name: Setup pnpm
|
||||
uses: pnpm/action-setup@v2.2.1
|
||||
with:
|
||||
version: latest
|
||||
|
||||
- name: Setup NodeJS
|
||||
uses: actions/setup-node@v3
|
||||
with:
|
||||
node-version: 17
|
||||
|
||||
- name: Install Dependencies
|
||||
run: pnpm install
|
||||
|
||||
- name: Lint & Format
|
||||
run: pnpm format
|
||||
|
||||
- name: Build Site
|
||||
run: pnpm build
|
||||
26
.github/workflows/update_protobufs.yml
vendored
26
.github/workflows/update_protobufs.yml
vendored
|
|
@ -1,26 +0,0 @@
|
|||
name: "Update protobufs"
|
||||
on: workflow_dispatch
|
||||
|
||||
jobs:
|
||||
update-protobufs:
|
||||
environment: Production
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout code
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
|
||||
- name: Update Submodule
|
||||
run: |
|
||||
git pull --recurse-submodules
|
||||
git submodule update --remote --recursive
|
||||
|
||||
- name: Commit update
|
||||
run: |
|
||||
git config --global user.name 'github-actions'
|
||||
git config --global user.email 'bot@noreply.github.com'
|
||||
git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
|
||||
git add protobufs
|
||||
git commit -m "Update protobuf submodule" && git push || echo "No changes to commit"
|
||||
3
.gitmodules
vendored
3
.gitmodules
vendored
|
|
@ -1,6 +1,3 @@
|
|||
[submodule "protobufs"]
|
||||
path = protobufs
|
||||
url = https://github.com/meshtastic/protobufs/
|
||||
[submodule "static/design"]
|
||||
path = static/design
|
||||
url = https://github.com/meshtastic/design/
|
||||
|
|
|
|||
|
|
@ -1 +0,0 @@
|
|||
"@meshtastic/eslint-config/prettier"
|
||||
7
.trunk/.gitignore
vendored
Normal file
7
.trunk/.gitignore
vendored
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
*out
|
||||
*logs
|
||||
*actions
|
||||
*notifications
|
||||
plugins
|
||||
user_trunk.yaml
|
||||
user.yaml
|
||||
9
.trunk/configs/.eslintrc
Normal file
9
.trunk/configs/.eslintrc
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
|
||||
|
||||
|
||||
{
|
||||
"extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended", "plugin:@docusaurus/recommended"],
|
||||
"parser": "@typescript-eslint/parser",
|
||||
"plugins": ["@docusaurus", "@typescript-eslint"],
|
||||
"root": true
|
||||
}
|
||||
10
.trunk/configs/.markdownlint.yaml
Normal file
10
.trunk/configs/.markdownlint.yaml
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# Autoformatter friendly markdownlint config (all formatting rules disabled)
|
||||
default: true
|
||||
blank_lines: false
|
||||
bullet: false
|
||||
html: false
|
||||
indentation: false
|
||||
line_length: false
|
||||
spaces: false
|
||||
url: false
|
||||
whitespace: false
|
||||
3
.trunk/configs/.prettierrc
Normal file
3
.trunk/configs/.prettierrc
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
{
|
||||
"trailingComma": "none"
|
||||
}
|
||||
7
.trunk/configs/.shellcheckrc
Normal file
7
.trunk/configs/.shellcheckrc
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
enable=all
|
||||
source-path=SCRIPTDIR
|
||||
disable=SC2154
|
||||
|
||||
# If you're having issues with shellcheck following source, disable the errors via:
|
||||
# disable=SC1090
|
||||
# disable=SC1091
|
||||
14
.trunk/configs/svgo.config.js
Normal file
14
.trunk/configs/svgo.config.js
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
module.exports = {
|
||||
plugins: [
|
||||
{
|
||||
name: "preset-default",
|
||||
params: {
|
||||
overrides: {
|
||||
removeViewBox: false, // https://github.com/svg/svgo/issues/1128
|
||||
sortAttrs: true,
|
||||
removeOffCanvasPaths: true
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
};
|
||||
23
.trunk/trunk.yaml
Normal file
23
.trunk/trunk.yaml
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
version: 0.1
|
||||
cli:
|
||||
version: 1.3.1
|
||||
plugins:
|
||||
sources:
|
||||
- id: trunk
|
||||
ref: v0.0.8
|
||||
uri: https://github.com/trunk-io/plugins
|
||||
lint:
|
||||
enabled:
|
||||
- markdownlint@0.33.0
|
||||
- actionlint@1.6.22
|
||||
- gitleaks@8.15.2
|
||||
- git-diff-check
|
||||
- shellcheck@0.9.0
|
||||
- prettier@2.8.2
|
||||
- shfmt@3.5.0
|
||||
- eslint@8.31.0
|
||||
- svgo@3.0.2
|
||||
runtimes:
|
||||
enabled:
|
||||
- go@1.18.3
|
||||
- node@18.12.1
|
||||
3
.vscode/extensions.json
vendored
Normal file
3
.vscode/extensions.json
vendored
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
{
|
||||
"recommendations": ["trunk.io"]
|
||||
}
|
||||
7
.vscode/settings.json
vendored
Normal file
7
.vscode/settings.json
vendored
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"editor.formatOnSave": true,
|
||||
"editor.defaultFormatter": "trunk.io",
|
||||
"files.associations": {
|
||||
"*.mdx": "markdown"
|
||||
}
|
||||
}
|
||||
|
|
@ -11,7 +11,7 @@ Website and documentation source for the Meshtastic project.
|
|||
|
||||
## Stats
|
||||
|
||||
|
||||
|
||||
|
||||
## Development & Building
|
||||
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ There are many technologies (and repositories) used in creating the Meshtastic e
|
|||
|
||||
### Protocol Buffers
|
||||
|
||||
Most communication and interactions happen with protocol buffers. The [Meshtastic Protobuf Definitions](https://github.com/meshtastic/protobufs) repo is where all of the protocol buffer changes happen. See the [Protobuf API Reference](/docs/developers/protobufs/api) for more details.
|
||||
Most communication and interactions happen with protocol buffers. The [Meshtastic Protobuf Definitions](https://github.com/meshtastic/protobufs) repo is where all of the protocol buffer changes happen. See the [Protobuf API Reference](https://buf.build/meshtastic/protobufs/) for more details.
|
||||
|
||||
### Device Firmware
|
||||
|
||||
|
|
@ -44,10 +44,10 @@ The [firmware](https://github.com/meshtastic/firmware) is where all of the firmw
|
|||
|
||||
@sachaw has been making tons of progress on the web app and would love help with:
|
||||
|
||||
* Saving of preferences
|
||||
* Better loading state indicators
|
||||
* Chat scroll lock
|
||||
* Various module support
|
||||
- Saving of preferences
|
||||
- Better loading state indicators
|
||||
- Chat scroll lock
|
||||
- Various module support
|
||||
|
||||
### Mobile Apps (Device Interface)
|
||||
|
||||
|
|
@ -59,4 +59,3 @@ There are two phone apps that interact with the Meshtastic devices:
|
|||
### Documentation
|
||||
|
||||
This website is in the [Meshtastic](https://github.com/meshtastic/meshtastic) repository.
|
||||
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ Everyone contributes in a different way. Join the [Meshtastic Discord](https://d
|
|||
|
||||
### What versions of Android does the Meshtastic Android App require?
|
||||
|
||||
Minimum requirement is Android 5 (Lollipop 2014, first BLE support), however at least Android 6 (Marshmallow 2015) is recommended as Bluetooth is more stable. While Android 5/6 are officially supported by Meshtastic, it is *not* recommended that you purchase devices with these versions due to their limited OS support and limited battery life due to age. Many newer models exist that are very affordable. A good resource to use when researching affordable devices is the [LineageOS Supported Devices List](https://wiki.lineageos.org/devices/).
|
||||
Minimum requirement is Android 5 (Lollipop 2014, first BLE support), however at least Android 6 (Marshmallow 2015) is recommended as Bluetooth is more stable. While Android 5/6 are officially supported by Meshtastic, it is _not_ recommended that you purchase devices with these versions due to their limited OS support and limited battery life due to age. Many newer models exist that are very affordable. A good resource to use when researching affordable devices is the [LineageOS Supported Devices List](https://wiki.lineageos.org/devices/).
|
||||
|
||||
### What does the icon next to the message mean?
|
||||
|
||||
|
|
@ -91,7 +91,7 @@ Hold down the left PWR button for about 10 seconds and the display should turn o
|
|||
|
||||
Push the left PWR button for about 1 second.
|
||||
|
||||
### Functionality of the T-Beam Buttons ###
|
||||
### Functionality of the T-Beam Buttons
|
||||
|
||||
[T-Beam Buttons](/docs/hardware/devices/tbeam/buttons) explained here
|
||||
|
||||
|
|
@ -140,17 +140,18 @@ Meshtastic can be used by both unlicensed people and licensed HAM operators.
|
|||
If you use your HAM radio license with Meshtastic, consider both the privileges and restrictions:
|
||||
|
||||
#### Privileges
|
||||
|
||||
- Increased Transmit Power
|
||||
- Up to 1500W transmit power! [FCC Part 97.313](https://www.ecfr.gov/current/title-47/chapter-I/subchapter-D/part-97/subpart-D/section-97.313)
|
||||
- Higher Gain Antennas
|
||||
|
||||
#### Restrictions
|
||||
|
||||
- Plain-Text Only
|
||||
- On amateur radio bands, encryption is illegal. [FCC Part 97.113.C](https://www.ecfr.gov/current/title-47/chapter-I/subchapter-D/part-97/subpart-B/section-97.113)
|
||||
- Lack of Privacy
|
||||
- As a HAM operator, it is a requirement that you identify yourself by your call sign periodically when transmitting. Your call sign will be publicly transmitted at least once every 10 minutes at minimum. [FCC Part 97.119.A](https://www.ecfr.gov/current/title-47/chapter-I/subchapter-D/part-97/subpart-B/section-97.119)
|
||||
|
||||
|
||||
### How do I set my HAM call sign?
|
||||
|
||||
Please see instructions for [Enabling HAM License from the Python CLI](/docs/software/python/cli/usage#ham-radio-support)
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ slug: /introduction
|
|||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Link from '@docusaurus/Link';
|
||||
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!
|
||||
|
||||
|
|
@ -32,8 +32,8 @@ If you are interested in a more technical overview of how Meshtastic works, visi
|
|||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/overview'}
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/overview"}
|
||||
>
|
||||
Technical Overview
|
||||
</Link>
|
||||
|
|
@ -45,8 +45,8 @@ Meshtastic is an open source project available on GitHub. Our generous volunteer
|
|||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/contributing'}
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/contributing"}
|
||||
>
|
||||
Contribute!
|
||||
</Link>
|
||||
|
|
@ -54,7 +54,7 @@ Meshtastic is an open source project available on GitHub. Our generous volunteer
|
|||
|
||||
<!--- FIXME add Github organization list/contributor list --->
|
||||
|
||||
## Start using Meshtastic!
|
||||
## Start using Meshtastic
|
||||
|
||||
Hopefully your "Getting Started" experience is straight forward and headache free. If you encounter any issues, please consider updating our documentation to improve future user experiences or reach out on the forum or Discord.
|
||||
|
||||
|
|
@ -62,8 +62,8 @@ Our support is 100% volunteer based. We are passionate about the project and hop
|
|||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/getting-started'}
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started"}
|
||||
>
|
||||
Getting Started
|
||||
</Link>
|
||||
|
|
|
|||
|
|
@ -55,62 +55,59 @@ I'm assuming that meshtastic is being used to hike in places where someone capab
|
|||
|
||||
I'm guessing that the network behaves somewhat like a store-and-forward network - or, at least, that the goal is to avoid establishing a two-way connection to transmit data. I'm afraid I haven't worked with mesh networks much, but remember studying them briefly in school about ten years ago.
|
||||
|
||||
|
||||
## Phased Proposal for the Meshtastic Security Framework
|
||||
|
||||
### Phase 1 - Fixed network encryption with AES-CTR
|
||||
|
||||
The current implementation provides optional confidentiality to members of a configured network:
|
||||
* Encryption is implemented in devices/nodes with network-wide encryption keys.
|
||||
* Encryption is optional and is turned off when devices are in 'Ham mode'.
|
||||
* There is no encryption supported in the clients (iOS, Android) to facilitate distribution as mass market software.
|
||||
* Pairing from client-to-device is by:
|
||||
* direct USB cable
|
||||
* BT pairing
|
||||
* Devices are 'promiscuous' and will pair with any near-by client. Network confidentiality requires physical protextion of all nodes.
|
||||
|
||||
- Encryption is implemented in devices/nodes with network-wide encryption keys.
|
||||
- Encryption is optional and is turned off when devices are in 'Ham mode'.
|
||||
- There is no encryption supported in the clients (iOS, Android) to facilitate distribution as mass market software.
|
||||
- Pairing from client-to-device is by:
|
||||
- direct USB cable
|
||||
- BT pairing
|
||||
- Devices are 'promiscuous' and will pair with any near-by client. Network confidentiality requires physical protextion of all nodes.
|
||||
|
||||
### Phase 2 - Strong device and client identity
|
||||
|
||||
**Phase 2 security goals:**
|
||||
* Know who sent a message (strong binding of messages to a particular node and/or terminal device)
|
||||
* This would be an optional feature for a message
|
||||
* Optionaly enforce identity based restrictions on some actions performed at nodes and/or clients
|
||||
* Optional support of strong pairing of a client to a device/node and restrict ability to manage and receive messages based on the pairing.
|
||||
* The BT paring and the cryptographic paring are separate (to simplify pahse 1 deployment and testing)
|
||||
* Above features should be architected to be ‘cryptographically strong’ and algorithm agile.
|
||||
|
||||
- Know who sent a message (strong binding of messages to a particular node and/or terminal device)
|
||||
- This would be an optional feature for a message
|
||||
- Optionaly enforce identity based restrictions on some actions performed at nodes and/or clients
|
||||
- Optional support of strong pairing of a client to a device/node and restrict ability to manage and receive messages based on the pairing.
|
||||
- The BT paring and the cryptographic paring are separate (to simplify pahse 1 deployment and testing)
|
||||
- Above features should be architected to be ‘cryptographically strong’ and algorithm agile.
|
||||
|
||||
**Phase 2 Proposed mechanisms:**
|
||||
* Proposed initial algorithms
|
||||
|
||||
- Proposed initial algorithms
|
||||
- Ed25519 for signatures based on NaCl libraries and iOS support for Ed25519
|
||||
* Clients and nodes to generate local identity Ed25519 keys
|
||||
* Devices maintain knowledge of owner public key
|
||||
* Devices maintain knowledge of some peers public keys and associated information (name, etc.)
|
||||
* Experimental protobuf message type with
|
||||
* cipher suite indicator (csi)
|
||||
* wrapped data using a cipher suite identifier to indicate use of Ed25519 wrapping identified algorithms.
|
||||
- Clients and nodes to generate local identity Ed25519 keys
|
||||
- Devices maintain knowledge of owner public key
|
||||
- Devices maintain knowledge of some peers public keys and associated information (name, etc.)
|
||||
- Experimental protobuf message type with
|
||||
- cipher suite indicator (csi)
|
||||
- wrapped data using a cipher suite identifier to indicate use of Ed25519 wrapping identified algorithms.
|
||||
Wrapped data to contain any of the existing message types.
|
||||
* initial ‘cipher suite’ **only** signs a message
|
||||
* new signed/authenticated messages to:
|
||||
* device->client: provide ownership status of device (owner is identifed by a public key)
|
||||
* client->device: set owner key (must be existing device owner or owner null)
|
||||
* any->all. Broadcast public key and associated info (crude initial key distribution)
|
||||
- initial ‘cipher suite’ **only** signs a message
|
||||
- new signed/authenticated messages to:
|
||||
- device->client: provide ownership status of device (owner is identifed by a public key)
|
||||
- client->device: set owner key (must be existing device owner or owner null)
|
||||
- any->all. Broadcast public key and associated info (crude initial key distribution)
|
||||
|
||||
### Phase 3 and 3+:
|
||||
* Device/node e2e message confidentiality (1-to-1)
|
||||
* NO client side encryption
|
||||
* All encryption turned off for a network in 'Ham mode'
|
||||
* Protect messages sent over LoRa from eavesdroppers outside of a well identified group
|
||||
|
||||
- Device/node e2e message confidentiality (1-to-1)
|
||||
- NO client side encryption
|
||||
- All encryption turned off for a network in 'Ham mode'
|
||||
- Protect messages sent over LoRa from eavesdroppers outside of a well identified group
|
||||
- multicast group key distribution / discovery (1-to-n)
|
||||
* Privacy
|
||||
* BT MAC layer address privatization
|
||||
* Node address privatization (Use use if based on device public key and schedule based aliasing)
|
||||
* Private peer discovery
|
||||
* Private service announcement and discovery
|
||||
* Device/node security (hardening key storage, tamper resistance, side channel protection, etc.)
|
||||
* Public key pairing process for client-to-device also sets up BT (no BT pin)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
- Privacy
|
||||
- BT MAC layer address privatization
|
||||
- Node address privatization (Use use if based on device public key and schedule based aliasing)
|
||||
- Private peer discovery
|
||||
- Private service announcement and discovery
|
||||
- Device/node security (hardening key storage, tamper resistance, side channel protection, etc.)
|
||||
- Public key pairing process for client-to-device also sets up BT (no BT pin)
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ This preamble allows receiving radios to synchronize clocks and start framing. W
|
|||
This layer is conventional non-reliable LoRa packet transmission. The transmitted packet has the following representation before encoding for transmission:
|
||||
|
||||
| Offset | Length | Type | Usage |
|
||||
|:------------:|:-----------------------------:|:-------:|:---------------------------------------------------------------------------------------- |
|
||||
| :----------: | :---------------------------: | :-----: | :--------------------------------------------------------------------------------------- |
|
||||
| 0x00 | 1 byte | Integer | syncWord, always `0x2B`. |
|
||||
| 0x01 | 4 bytes | Integer | Packet header: Destination. The destination's unique NodeID. `0xFFFFFFFF` for broadcast. |
|
||||
| 0x05 | 4 bytes | Integer | Packet Header: Sender. The sender's unique NodeID. |
|
||||
|
|
@ -38,7 +38,7 @@ This layer is conventional non-reliable LoRa packet transmission. The transmitte
|
|||
#### Packet Header Flags
|
||||
|
||||
| Index | # of Bits | Usage |
|
||||
|:-------:|:---------:|:------------------------------|
|
||||
| :-----: | :-------: | :----------------------------- |
|
||||
| 0 | 3 | HopLimit (see note in Layer 3) |
|
||||
| 3 | 1 | WantAck |
|
||||
| 4 .. 32 | 28 | Currently unused |
|
||||
|
|
@ -51,7 +51,7 @@ This layer is conventional non-reliable LoRa packet transmission. The transmitte
|
|||
|
||||
- **Packet Header - Unique ID:** The ID is a large, 32 bit ID to ensure there is enough unique state to protect an encrypted payload from attack.
|
||||
|
||||
- **Payload:** An encrypted and packed protobuf encoding of the SubPacket protobuf. Only the SubPacket is encrypted, while headers are not. This allows the option of eventually allowing nodes to route packets without knowing anything about the encrypted payload. For more information, see the [encryption](/docs/overview/encryption) and [protobufs](/docs/developers/protobufs/api) documentation. Any data past the maximum length is truncated.
|
||||
- **Payload:** An encrypted and packed protobuf encoding of the SubPacket protobuf. Only the SubPacket is encrypted, while headers are not. This allows the option of eventually allowing nodes to route packets without knowing anything about the encrypted payload. For more information, see the [encryption](/docs/overview/encryption) and [Protobuf API Reference](https://buf.build/meshtastic/protobufs/). Any data past the maximum length is truncated.
|
||||
|
||||
#### Carrier-Sense Multiple Access with Collision Avoidance (CSMA/CA)
|
||||
|
||||
|
|
|
|||
|
|
@ -66,15 +66,15 @@ Various data-rate options are available when configuring a channel and are inver
|
|||
We have six predefined channels. These are the most common settings and have been proven to work well:
|
||||
|
||||
| Channel setting | Alt Channel Name | Data-Rate | SF / Symbols | Coding Rate | Bandwidth | Link Budget |
|
||||
| :------------------: | :---------------: | :------------------: | :-----------: | :----------: | :--------:| :---------- :|
|
||||
| :--------------------: | :--------------: | :-----------------: | :----------: | :---------: | :-------: | :---------: |
|
||||
| Short Range / Fast | Short Fast | 6.8 kbps | 7 / 128 | 4/8 | 250 | 137dB |
|
||||
| Short Range / Slow | Short Slow | 3.9 kbps | 8 / 256 | 4/8 | 250 | 140dB |
|
||||
| Medium Range / Fast | Medium Fast | 2.2 kbps | 9 / 512 | 4/8 | 250 | 143dB |
|
||||
| Medium Range / Slow | Medium Slow | 1.2 kbps | 10 / 1024 | 4/8 | 250 | 146dB |
|
||||
| Long Range / Fast | Long Fast | 0.67 kbps (default) | 11 / 2048 | 4/8 | 250 | 148.5dB |
|
||||
| Long Range / Moderate | Long Moderate | 0.335 kbps | 11 / 2048 | 4/8 | 125 | 151dB |
|
||||
| Long Range / Slow | Long Slow | 0.18 kbps | 12 / 4096 | 4/8 | 125 | 154dB |
|
||||
| Very Long Range - Slow | Very Long Slow | 0.05 kbps | 12 / 4096 | 4/8 | 31.25 | 160.1dB |
|
||||
|
||||
| Very Long Range / Slow | Very Long Slow | 0.09 kbps | 12 / 4096 | 4/8 | 62.5 | 157dB |
|
||||
|
||||
:::note
|
||||
The link budget used by these calculations assumes a transmit power of 17dBm and an antenna with 0dB gain. Adjust your link budget assumptions based on your actual devices. Data-rate in this table is actual measured but doesn't count mesh overhead, hops and re-transmissions.
|
||||
|
|
@ -93,7 +93,7 @@ After applying the settings, you will need to restart the device. After your dev
|
|||
Some example settings:
|
||||
|
||||
| Data-rate | SF / Symbols | Coding Rate | Bandwidth | Link Budget | Note |
|
||||
| :---------:| :-----------:| :----------:| :--------:| :----------:| :----------------------------------------------------------------------- |
|
||||
| :--------: | :----------: | :---------: | :-------: | :---------: | :----------------------------------------------------------------------- |
|
||||
| 37.50 kbps | 6 / 64 | 4/5 | 500 | 129dB | Fastest possible speed |
|
||||
| 3.125 kbps | 8 / 256 | 4/5 | 125 | 143dB | |
|
||||
| 1.953 kbps | 8 / 256 | 4/8 | 125 | 143dB | |
|
||||
|
|
@ -102,7 +102,6 @@ Some example settings:
|
|||
| 0.814 kbps | 10 / 1024 | 4/6 | 125 | 149dB | |
|
||||
| 0.610 kbps | 10 / 1024 | 4/8 | 125 | 149dB | |
|
||||
| 0.488 kbps | 11 / 2048 | 4/6 | 125 | 152dB | |
|
||||
| 0.336 kbps | 11 / 2048 | 4/8 | 125 | 152dB | |
|
||||
| 0.073 kbps | 12 / 4096 | 4/5 | 31 | 160dB | Twice the range and/or coverage of "Long Slow", low resilience to noise |
|
||||
| 0.046 kbps | 12 / 4096 | 4/8 | 31 | 160dB | Twice the range and/or coverage of "Long Slow", high resilience to noise |
|
||||
|
||||
|
|
|
|||
|
|
@ -12,18 +12,21 @@ sidebar_position: 4
|
|||
- **Record Holder:** _PuzzledPancake_
|
||||
- **Source:** [Meshtastic Discourse](https://meshtastic.discourse.group/t/practical-range-test-results/692/44)
|
||||
|
||||
**Modem Settings**
|
||||
### Modem Settings
|
||||
|
||||
- **Frequency:** 868MHz
|
||||
- **Bandwidth:** 125
|
||||
- **Spread Factor:** 12
|
||||
- **Coding Rate:** 4/8
|
||||
|
||||
**Node A**
|
||||
### Node A
|
||||
|
||||
- **Device:** [LILYGO TTGO T-Beam w/ SX1262](/docs/hardware/devices/tbeam)
|
||||
- **Firmware Version:** 1.2
|
||||
- **Antenna:** [868MHz 5dBi Antenna](https://ivent.co.nz/product/category/1000/868mhz%205dbi%20antenna%20193mm%20black%20sma%20%28m%29/38646)
|
||||
|
||||
**Node B**
|
||||
### Node B
|
||||
|
||||
- **Device:** [LILYGO TTGO T-Beam w/ SX1262](/docs/hardware/devices/tbeam)
|
||||
- **Firmware Version:** 1.2
|
||||
- **Antenna:** [868MHz Vertical 6dBi](https://ivent.co.nz/product/category/1000/868mhz%20vertical%206dbi%20antenna/38606)
|
||||
|
|
@ -34,5 +37,6 @@ sidebar_position: 4
|
|||
|
||||
|
||||
|
||||
**Resources Used**
|
||||
### Resources Used
|
||||
|
||||
- http://www.heywhatsthat.com
|
||||
|
|
@ -1,6 +1,5 @@
|
|||
|
||||
| Region Code | Description |
|
||||
| :-------: | :--------: |
|
||||
| :---------: | :---------------------: |
|
||||
| `UNSET` | Unset |
|
||||
| `US` | United States |
|
||||
| `EU_433` | European Union 433MHz |
|
||||
|
|
@ -13,6 +12,8 @@
|
|||
| `RU` | Russia |
|
||||
| `IN` | India |
|
||||
| `NZ_865` | New Zealand 865MHz |
|
||||
| `UA_433` | Ukraine 433MHz |
|
||||
| `UA_868` | Ukraine 868MHz |
|
||||
| `TH` | Thailand |
|
||||
| `LORA_24` | 2.4 GHz band worldwide |
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/config/bluetooth
|
|||
sidebar_label: Bluetooth
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The Bluetooth config options are: Enabled, Pairing Mode and Fixed PIN Value. Bluetooth config uses an admin message sending a `Config.Bluetooth` protobuf.
|
||||
|
||||
|
|
@ -83,7 +83,7 @@ All Bluetooth module config options are available in the python CLI. Example com
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :-----------------------: | :-----------------: | :-----: |
|
||||
| :------------------: | :---------------------------------: | :----------: |
|
||||
| `bluetooth.enabled` | `true`, `false` | `true` |
|
||||
| `bluetooth.mode` | `RANDOM_PIN`, `FIXED_PIN`, `NO_PIN` | `RANDOM_PIN` |
|
||||
| `bluetooth.fixedPin` | `integer` (6 digits) | `123456` |
|
||||
|
|
@ -107,6 +107,7 @@ meshtastic --set bluetooth.enabled false
|
|||
meshtastic --set bluetooth.mode FIXED_PIN
|
||||
meshtastic --set bluetooth.fixed_pin 111111
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="web">
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/config/channels
|
|||
sidebar_label: Channels
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The Channels config options are: Index, Roles, and Settings. Channel config uses an admin message sending a `Channel` protobuf which also consists of a `ChannelSettings` protobuf.
|
||||
|
||||
|
|
@ -27,7 +27,7 @@ The channel index begins at 0 and ends at 7.
|
|||
_Indexing_ can not be modified.
|
||||
|
||||
| Index | Channel | Default Role | Purpose |
|
||||
| :--------------------: | :----------------: | :----------------: | :----------------: |
|
||||
| :---: | :-----: | :----------: | :-----------------------: |
|
||||
| 0 | 1 | `PRIMARY` | Used as `default` channel |
|
||||
| 1 | 2 | `DISABLED` | User defined |
|
||||
| 2 | 3 | `DISABLED` | User defined |
|
||||
|
|
@ -55,6 +55,11 @@ Each channel is assigned one of 3 roles:
|
|||
- The channel is no longer available for use.
|
||||
- The channel settings are set to default.
|
||||
|
||||
:::note
|
||||
While you can have a different PRIMARY channel and communicate over SECONDARY channels with the same PSK, a hash of the PRIMARY channel's name sets the LoRa channel number, which determines the actual frequency you are transmitting on in the band.
|
||||
To ensure devices with different PRIMARY channel name transmit on the same frequency, you must explicitly set the LoRa channel number.
|
||||
:::
|
||||
|
||||
## Channel Settings Values
|
||||
|
||||
The Channel Settings options are: ID, Name, PSK, Downlink Enabled, and Uplink Enabled. Channel settings are embedded in the `Channel` protobuf as a `ChannelSettings` protobuf and sent as an admin message.
|
||||
|
|
@ -74,7 +79,7 @@ Set to `0` by default.
|
|||
A short identifier for the channel. _(< 12 bytes)_
|
||||
|
||||
| Reserved Name | Purpose |
|
||||
| :--------------------: | :----------------: |
|
||||
| :------------: | :----------------------------------------------------------------------------------------------------------------------------: |
|
||||
| `""` (default) | If left empty on the Primary channel, this designates the `default` channel. |
|
||||
| `admin` | On Secondary channels, the name `admin` (case sensitive) designates the `admin` channel used to administer nodes over the mesh |
|
||||
|
||||
|
|
@ -140,13 +145,13 @@ meshtastic --ch-set name "My Channel" --ch-set psk random --ch-set uplink_enable
|
|||
|
||||
:::
|
||||
|
||||
**Id**
|
||||
### Id
|
||||
|
||||
```shell title="Set the PRIMARY channel ID"
|
||||
meshtastic --ch-set id 1234 --ch-index 0
|
||||
```
|
||||
|
||||
**Name**
|
||||
### Name
|
||||
|
||||
```shell title="Set channel name for the PRIMARY channel"
|
||||
# without spaces
|
||||
|
|
@ -155,7 +160,7 @@ meshtastic --ch-set name MyChannel --ch-index 0
|
|||
meshtastic --ch-set name "My Channel" --ch-index 0
|
||||
```
|
||||
|
||||
**PSK**
|
||||
### PSK
|
||||
|
||||
If you use Meshtastic for exchanging messages you don't want other people to see, `random` is the setting you should use. Selecting `default` or any of the `simple` values from the following table will use publicly known encryption keys. They're shipped with Meshtastic source code and thus, anyone can listen to messages encrypted by them. They're great for testing and public channels.
|
||||
|
||||
|
|
@ -186,7 +191,7 @@ meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a
|
|||
meshtastic --ch-set psk none --ch-index 0
|
||||
```
|
||||
|
||||
**Uplink / Downlink**
|
||||
### Uplink / Downlink
|
||||
|
||||
For configuring gateways, please see [MQTT](/docs/settings/moduleconfig/mqtt)
|
||||
|
||||
|
|
|
|||
|
|
@ -5,36 +5,66 @@ slug: /settings/config/device
|
|||
sidebar_label: Device
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The device config options are: Role, Serial Output, and Debug Log. Device config uses an admin message sending a `Config.Device` protobuf.
|
||||
|
||||
## Device Config Values
|
||||
|
||||
### Role
|
||||
Sets the role of node.
|
||||
|
||||
Sets the role of the node.
|
||||
|
||||
Acceptable values:
|
||||
|
||||
| Value | Description |
|
||||
| :-------: | :---------------------------------------------------------------------------------------: |
|
||||
| `CLIENT` | Client (default) - App connected client. |
|
||||
| :-------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
||||
| `CLIENT` | Client (default) - This role will follow the standard routing rules while also allowing the device to interact with client applications via BLE/Wi-Fi (Android/Apple/Web). |
|
||||
| `CLIENT_MUTE` | Client Mute - Same as a client except packets will not hop over this node, does not contribute to routing packets for mesh. |
|
||||
| `ROUTER` | Router - Mesh packets will prefer to be routed over this node. This node will not be used by client apps. The WiFi/BLE radios and the OLED screen will be put to sleep. |
|
||||
| `ROUTER_CLIENT` | Router Client - Mesh packets will prefer to be routed over this node. The Router Client can be used as both a Router and an app connected Client. |
|
||||
| `ROUTER` | Router - Mesh packets will prefer to be routed over this node. The assumption is that Router-type devices will be placed in locations with a height/range/antenna advantage, and therefore have better overall coverage. This node will not be used by client apps. The BLE/Wi-Fi radios and the OLED screen will be put to sleep. Please note: Due to the preferred routing, this role may cause higher power usage due to more frequent transmission. |
|
||||
| `ROUTER_CLIENT` | Router Client - Hybrid of the Client and Router roles. Similar to Router, except the Router Client can be used as both a Router and an app connected Client. BLE/Wi-Fi and OLED screen will not be put to sleep. |
|
||||
| `REPEATER`[^1] | Repeater - Mesh packets will prefer to be routed over this node. This role eliminates unnecessary overhead such as NodeInfo, DeviceTelemetry, and any other mesh packet, resulting in the device not appearing as part of the network. As such, direct messaging this node is not available, as it will not appear in your nodes list which results in a cleaner mesh network. Channel and modem settings of the mesh packets being repeated must be identical to the repeater's configuration. Please see Rebroadcast Mode for additional settings specific to this role.[^1] |
|
||||
| `TRACKER`[^1] | Tracker - For use with devices intended as a GPS tracker. Position packets sent from this device will be higher priority, with position broadcasting every two minutes. Smart Position Broadcast will default to off.[^1] |
|
||||
|
||||
[^1]: These roles are new as of the 2.0.15 alpha release. They are still a work in progress and as such features and functionality may not work as described and can evolve or change as development continues.
|
||||
|
||||
### Rebroadcast Mode
|
||||
|
||||
This setting defines the device's behavior for how messages are rebroadcasted. [^2]
|
||||
|
||||
[^2]: This setting is new as of the 2.0.16 alpha release. It is still a work in progress and as such features and functionality may not work as described and can evolve or change as development continues.
|
||||
|
||||
| Value | Description |
|
||||
| :-----------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
||||
| `ALL` | ALL (Default) - This setting will rebroadcast ALL messages from its primary mesh as well as other meshes with the same modem settings, including when encryption settings differ. |
|
||||
| `All_SKIP_DECODING` | ALL_SKIP_DECODING - Same as behavior as ALL, but skips packet decoding and simply rebroadcasts them. **Only available with Repeater role.** |
|
||||
| `LOCAL_ONLY` | LOCAL_ONLY - Ignores observed messages from foreign meshes that are open or those which it cannot decrypt. Only rebroadcasts message on the nodes local primary / secondary channels. |
|
||||
|
||||
### Serial Console
|
||||
|
||||
Acceptable values: `true` or `false`
|
||||
|
||||
Disabling this will disable the SerialConsole by not initializing the StreamAPI.
|
||||
|
||||
### Debug Log
|
||||
|
||||
Acceptable values: `true` or `false`
|
||||
|
||||
By default we turn off logging as soon as an API client connects. Set this to true to leave the debug log outputting even when API is active.
|
||||
|
||||
### GPIO for user button
|
||||
|
||||
This is the GPIO pin number that will be used for the user button, if your device does not come with a predefined user button.
|
||||
|
||||
### GPIO for PWM Buzzer
|
||||
|
||||
This is the GPIO pin number that will be used for the PWM buzzer, if your device does not come with a predefined buzzer.
|
||||
|
||||
### Node Info Broadcast Seconds
|
||||
|
||||
This is the number of seconds between NodeInfo message broadcasts from the device. The device will still respond ad-hoc to NodeInfo messages when a response is wanted.
|
||||
|
||||
## Device Config Client Availability
|
||||
|
||||
<Tabs
|
||||
|
|
@ -74,10 +104,14 @@ All device config options are available in the python CLI. Example commands are
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
|--------------------------|----------------------------------------------------|----------|
|
||||
| ------------------------------- | ------------------------------------------------------------------------- | ----------------- |
|
||||
| device.debug_log_enabled | `true`, `false` | `false` |
|
||||
| device.role | `CLIENT`, `CLIENT_MUTE`, `ROUTER`, `ROUTER_CLIENT` | `CLIENT` |
|
||||
| device.role | `CLIENT`, `CLIENT_MUTE`, `ROUTER`, `ROUTER_CLIENT`, `REPEATER`, `TRACKER` | `CLIENT` |
|
||||
| device.rebroadcast_mode | `ALL`, `ALL_SKIP_DECODING`, `LOCAL_ONLY` | `ALL` |
|
||||
| device.serial_enabled | `true`, `false` | `true` |
|
||||
| device.button_gpio | `0` - `34` | `0` |
|
||||
| device.buzzer_gpio | `0` - `34` | `0` |
|
||||
| device.node_info_broadcast_secs | `0` - `UINT MAX` | `10800` (3 hours) |
|
||||
|
||||
:::tip
|
||||
|
||||
|
|
|
|||
|
|
@ -5,29 +5,33 @@ slug: /settings/config/display
|
|||
sidebar_label: Display
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The display config options are: Screen On Duration, Auto Carousel Interval, Always Point North and GPS Format. Display config uses an admin message sending a `Config.Display` protobuf.
|
||||
|
||||
## Device Config Values
|
||||
|
||||
### Screen On Duration
|
||||
|
||||
How long the screen remains on after the user button is pressed or messages are received.
|
||||
|
||||
### Auto Carousel Interval
|
||||
|
||||
Automatically toggles to the next page on the screen like a carousel, based the specified interval.
|
||||
|
||||
### Always Point North
|
||||
|
||||
If this is set, the compass heading on the screen outside of the circle will always point north. This feature is off by default and the top of display represents your heading direction, the North indicator will move around the circle.
|
||||
|
||||
### GPS Format
|
||||
|
||||
The format used to display GPS coordinates on the device screen.
|
||||
|
||||
Acceptable values:
|
||||
|
||||
| Value | Description |
|
||||
| :-------: | :--------------------------: |
|
||||
| :----: | :-----------------------------: |
|
||||
| `DEC` | Decimal Degrees |
|
||||
| `DMS` | Degrees Minutes Seconds |
|
||||
| `UTM` | Universal Transverse Mercator |
|
||||
|
|
@ -36,21 +40,33 @@ Acceptable values:
|
|||
| `OSGR` | Ordnance Survey Grid Reference |
|
||||
|
||||
### Prefered display units
|
||||
|
||||
switch between `METRIC` (default) and `IMPERIAL` units
|
||||
|
||||
### Flip Screen
|
||||
|
||||
If enabled, the screen will be rotated 180 degrees, for cases that mount the screen upside down
|
||||
|
||||
### OLED Defintion
|
||||
The type of OLED Controller is auto-detected by default, but can be defined with this setting if the auto-detection fails.
|
||||
|
||||
The type of OLED Controller is auto-detected by default, but can be defined with this setting if the auto-detection fails. For the SH1107, we assume a square display with 128x128 Pixels like the GME128128-1.
|
||||
|
||||
Acceptable values:
|
||||
|
||||
| Value | Description |
|
||||
| :-------: | :--------------------------: |
|
||||
| :------------: | :-----------------------------------------: |
|
||||
| `OLED_AUTO` | Auto detect display controller |
|
||||
| `OLED_SSD1306` | Always use SSD1306 driver |
|
||||
| `OLED_SH1106` | Always use SH1106 driver |
|
||||
| `OLED_SH1107` | Always use SH1107 driver (Geometry 128x128) |
|
||||
|
||||
### Display Mode
|
||||
|
||||
The display mode can be set to `NORMAL` (default), `TWOCOLOR` or `INVERTED`. The `TWOCOLOR` mode is intended for OLED displays with the first line of output being a different color than the rest of the display. The `INVERTED` mode will invert that bicolor area, resulting in a white background headline on monochrome displays.
|
||||
|
||||
### Heading Bold
|
||||
|
||||
The heading can be hard to read when 'INVERTED' or 'TWOCOLOR' display mode is used. This setting will make the heading bold, so it is easier to read.
|
||||
|
||||
## Device Config Client Availability
|
||||
|
||||
|
|
@ -91,14 +107,16 @@ All display config options are available in the python CLI. Example commands are
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
|-----------------------------------|--------------------------------------------|------------------------------|
|
||||
| display.auto_screen_carousel_secs | `integer` | Default of `0` is 10 minutes |
|
||||
| --------------------------------- | --------------------------------------------------------- | ----------------------------- |
|
||||
| display.auto_screen_carousel_secs | `integer` | Default of `0` is off. |
|
||||
| display.compass_north_top | `false`, `true` | `false` |
|
||||
| display.flip_screen | `fasle`, `true` | `false` |
|
||||
| display.gps_format | `DEC`, `DMS`, `UTM`, `MGRS`, `OLC`, `OSGR` | `DEC` |
|
||||
| display.oled | `OLED_AUTO`, `OLED_SSD1306`, `OLED_SH1106` | `OLED_AUTO` |
|
||||
| display.screen_on_secs | `integer` | Default of `0` is off. |
|
||||
| display.oled | `OLED_AUTO`, `OLED_SSD1306`, `OLED_SH1106`, `OLED_SH1107` | `OLED_AUTO` |
|
||||
| display.screen_on_secs | `integer` | Default of `0` is 10 minutes. |
|
||||
| display.units | `METRIC`, `IMPERIAL` | `METRIC` |
|
||||
| display.displaymode | `NORMAL`, `TWOCOLOR`, `INVERTED` | `NORMAL` |
|
||||
| display.heading_bold | `false`, `true` | `false` |
|
||||
|
||||
:::tip
|
||||
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ sidebar_position: 1
|
|||
There are several config sections in the Meshtastic firmware, these are broken out so they can be sent as small admin messages over the mesh.
|
||||
|
||||
| Name | Description |
|
||||
|:----:|:-----------:|
|
||||
| :------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
||||
| [Bluetooth](/docs/settings/config/bluetooth) | Bluetooth config options are: Enabled, Pairing Mode and Fixed PIN. |
|
||||
| [Channels](/docs/settings/config/channels) | Channels config options are: Index, Role and Settings. |
|
||||
| [Device](/docs/settings/config/device) | Device config options are: Device Role, Serial Output, Debug Log and Factory Reset. |
|
||||
|
|
|
|||
|
|
@ -5,12 +5,16 @@ slug: /settings/config/lora
|
|||
sidebar_label: LoRa
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import LoRaRegions from '../../blocks/_lora-regions.mdx';
|
||||
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 and Ignore Incoming Array. 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.
|
||||
:::
|
||||
|
||||
## LoRa Config Values
|
||||
|
||||
:::note
|
||||
|
|
@ -18,14 +22,40 @@ You must set your device's `lora.region` setting. This will ensure that you are
|
|||
:::
|
||||
|
||||
### Region
|
||||
|
||||
Sets the region for your node. Default is `unset`. As long as this is not set, the node screen will display a message and not transmit any packets.
|
||||
|
||||
<LoRaRegions />
|
||||
|
||||
### Modem Preset
|
||||
Use a sensible default for the modem. Default is `unset` which equates to `LONG_FAST`. Also 'Use Presets' has to be defined, which is the default. If 'Use Presets' is not defined, the modem will be configured manually with Bandwidth, Spread Factor, and Coding Rate.
|
||||
|
||||
Default is `unset` which equates to `LONG_FAST`. Presets are pre-defined modem settings (Bandwidth, Spread Factor, and Coding Rate) which influence both message speed and range. The default will provide a strong mixture of speed and range, for most users.
|
||||
|
||||
The presets are designed to provide further options for optimizing either speed (and reduced network congestion) or range, which can be useful for two real world scenarios:
|
||||
|
||||
1. A high number of devices exist in the mesh, or messages are sent very frequently. Faster speeds (and therefore lower radio time per device) can help with mesh network congestion.
|
||||
2. Maximum range is desired, for long range scenarios where a several second delay in message receipt is acceptable (for instance, attempting to send messages from a town to a distant mountain top).
|
||||
|
||||
The Presets available are as follows, and follow a linear pattern of Fastest <--> Slowest, and Shortest <--> Longest range:
|
||||
|
||||
1. `SHORT_FAST` (Fastest, highest bandwidth, lowest airtime, shortest range)
|
||||
|
||||
2. `SHORT_SLOW`
|
||||
|
||||
3. `MEDIUM_FAST`
|
||||
|
||||
4. `MEDIUM_SLOW`
|
||||
|
||||
5. `LONG_FAST` (Default)
|
||||
|
||||
6. `LONG_MODERATE`
|
||||
|
||||
7. `LONG_SLOW`
|
||||
|
||||
8. `VERY_LONG_SLOW` (Slowest, lowest bandwidth, highest airtime, longest range)
|
||||
|
||||
### Max Hops
|
||||
|
||||
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.**_
|
||||
|
||||
### Transmit Power
|
||||
|
|
@ -61,6 +91,7 @@ Allows you to enable and disable transmit (TX) from the LoRa radio. Useful for h
|
|||
Defaults to true
|
||||
|
||||
### Channel Number
|
||||
|
||||
This is controlling the actual hardware frequency the radio is transmitting on. A channel number between 1 and NUM_CHANNELS (whatever the max is in the current region). If this is ZERO/UNSET then the rule is "use the old channel name hash based algorithm to derive the channel number".
|
||||
|
||||
### Ignore Incoming Array
|
||||
|
|
@ -111,17 +142,26 @@ LoRa config commands are available in the python CLI. Example commands are below
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :----------: | :---------------------------------------------------------------------------: | :---------------: |
|
||||
| :-------------------------: | :-------------------------------------------------------------------------------------------------------------------------: | :---------: |
|
||||
| lora.modem_preset | `LONG_FAST`, `LONG_SLOW`, `VERY_LONG_SLOW`, `MEDIUM_SLOW`, `MEDIUM_FAST`, `SHORT_SLOW`, `SHORT_FAST` | `LONG_FAST` |
|
||||
| lora.region | `UNSET`, `US`, `EU_433`, `EU_868`, `CN`, `JP`, `ANZ`, `KR`, `TW`, `RU` ,`IN`, `NZ_865`, `TH`, `LORA_24` | `UNSET` |
|
||||
| lora.use_preset | `false`, `true` | `false` |
|
||||
| lora.region | `UNSET`, `US`, `EU_433`, `EU_868`, `CN`, `JP`, `ANZ`, `KR`, `TW`, `RU` ,`IN`, `NZ_865`, `TH`, `LORA_24`, `UA_433`, `UA_868` | `UNSET` |
|
||||
| lora.bandwidth | `31`, `62`, `125`, `250`, `500` | `250` |
|
||||
| lora.spread_factor | `7`, `8`, `9`, `10`, `11`, `12` | `12` |
|
||||
| lora.coding_rate | `5`, `6`, `7`, `8` | `8` |
|
||||
| lora.frequency_offset | `0` to `1000000` | `0` |
|
||||
| lora.hop_limit | `1`,`2`,`3`,`4`,`5`,`6`,`7` | `3` |
|
||||
| lora.tx_power | `0` to `30` | `0` |
|
||||
| lora.tx_enabled | `false`, `false` | `true` |
|
||||
| lora.channel_num | `0`, `1` to `NUM_CHANNELS` | `0` |
|
||||
| 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` |
|
||||
|
||||
:::tip
|
||||
|
||||
Because the device will reboot after each command is sent via CLI, it is recommended when setting multiple values in a config section that commands be chained together as one.
|
||||
|
||||
|
||||
```shell title="Example:"
|
||||
meshtastic --set lora.region US --set lora.modem_preset LONG_FAST
|
||||
```
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/config/network
|
|||
sidebar_label: Network
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The Network config options are: WiFi Enabled, WiFi SSID, WiFi PSK, Ethernet Enabled, IPv4 Networking Mode, Static Address and NTP Server. Network config uses an admin message sending a `Config.Network` protobuf.
|
||||
|
||||
|
|
@ -56,7 +56,6 @@ Set to `DHCP` by default. Change to `STATIC` to use a static IP address. Applies
|
|||
|
||||
contains ip, gateway, subnet and dns server in case you want a static configuration.
|
||||
|
||||
|
||||
:::tip
|
||||
The first time your device restarts after enabling WiFi or Ethernet, it will take an additional 20-30 seconds to boot. This is to generate self-signed SSL keys. The keys will be saved for future reuse.
|
||||
:::
|
||||
|
|
@ -104,7 +103,7 @@ All Network config options are available in the python CLI.
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :-----------: | :---------------: | :-----: |
|
||||
| :------------------: | :---------------: | :--------------: |
|
||||
| network.ntp_server | string | `0.pool.ntp.org` |
|
||||
| network.wifi_enabled | `true`, `false` | `false` |
|
||||
| network.wifi_psk | string | `""` |
|
||||
|
|
@ -160,18 +159,6 @@ All Network config options are available in the Web UI.
|
|||
|
||||
With `network.wifi_ssid` & `network.wifi_psk` populated, the device will know to connect to your network. Make sure you are in range of your WiFi. If you have a single Meshtastic device on your local network it's easy to connect to your device with DNS `http://meshtastic.local`. If you have multiple Meshtastic devices you will need to connect using their respective IP addresses.
|
||||
|
||||
If you have a screen attached to your device, the final page will display something similar to the following:
|
||||
|
||||
```
|
||||
WiFi: Software AP (Admin)
|
||||
IP: 192.168.42.1 (0/4)
|
||||
SSID: myNetwork
|
||||
http://meshtastic.local
|
||||
* * * * *
|
||||
```
|
||||
|
||||
You should then be able to connect to the node using either the displayed IP address or the HTTP link.
|
||||
|
||||
### Disable WiFi
|
||||
|
||||
To disable WiFi completely, set `network.wifi_enabled` to `false`.
|
||||
|
|
@ -5,8 +5,8 @@ slug: /settings/config/position
|
|||
sidebar_label: Position
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The position config options are: GPS Enabled, GPS Update Interval, GPS Attempt Time, Fixed Position, Smart Broadcast, Broadcast Interval and Position Packet Flags. Position config uses an admin message sending a `Config.Position` protobuf.
|
||||
|
||||
|
|
@ -15,6 +15,7 @@ Position data from GPS is provided by either the radio or your paired phone. Pos
|
|||
## Position Config Values
|
||||
|
||||
### GPS Disabled
|
||||
|
||||
Acceptable values: `true` or `false`
|
||||
|
||||
Defaults to false. Should the device GPS be disabled for this node?
|
||||
|
|
@ -36,6 +37,7 @@ Off by default
|
|||
If set, this node is at a fixed position. The device will generate GPS updates at the regular GPS update interval, but use whatever the last lat/lon/alt it saved for the node. The lat/lon/alt can be set by an internal GPS or with the help of the mobile device's GPS.
|
||||
|
||||
### Smart Broadcast
|
||||
|
||||
Acceptable values: `true` or `false`
|
||||
|
||||
On by default
|
||||
|
|
@ -59,7 +61,7 @@ The GPS updates will be sent out every Broadcast Interval, with either the actua
|
|||
Bit field of boolean configuration options for POSITION messages (bitwise OR of PositionFlags)
|
||||
|
||||
| Value | Description |
|
||||
| :-----------: | :---------------------------------------------------------: |
|
||||
| :----------------: | :--------------------------------------------------------------: |
|
||||
| UNSET | Required for compilation |
|
||||
| ALTITUDE | Include an altitude value (if available) |
|
||||
| ALTITUDE_MSL | Altitude value is MSL |
|
||||
|
|
@ -72,7 +74,9 @@ The GPS updates will be sent out every Broadcast Interval, with either the actua
|
|||
| HEADING | Include positional heading (from GPS solution) |
|
||||
| SPEED | Include positional speed (from GPS solution) |
|
||||
|
||||
### GPIO RX/TX for GPS Module
|
||||
|
||||
If your device does not have a fixed GPS chip, you can define the GPIO pins for the RX and TX pins of a GPS module.
|
||||
|
||||
## Position Config Client Availability
|
||||
|
||||
|
|
@ -113,7 +117,7 @@ All Position config commands are available in the python CLI. Example commands a
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :----------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------: |
|
||||
| :---------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------: |
|
||||
| position.gps_enabled | `true`, `false` | `true` |
|
||||
| position.gps_update_interval | `integer` (seconds) | Default `0` is 30 Seconds |
|
||||
| position.gps_attempt_time | `integer` (seconds) | Default of `0` is 30 Seconds |
|
||||
|
|
@ -121,6 +125,8 @@ All Position config commands are available in the python CLI. Example commands a
|
|||
| position.position_broadcast_smart_enabled | `true`, `false` | `true` |
|
||||
| position.position_broadcast_secs | `integer` (seconds) | Default of `0` is 15 Minutes |
|
||||
| position.flags | `UNSET`, `ALTITUDE`, `ALTITUDE_MSL`, `GEOIDAL_SEPARATION`, `DOP`, `HVDOP`, `PDOP`, `SATINVIEW`, `SEQ_NO`, `TIMESTAMP`, `HEADING`, `SPEED` | `UNSET` |
|
||||
| position.rx_gpio | `integer` (0-39) | `UNSET` |
|
||||
| position.tx_gpio | `integer` (0-34) | `UNSET` |
|
||||
|
||||
:::tip
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/config/power
|
|||
sidebar_label: Power
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The power config options are: Power Saving, Shutdown after losing power, ADC Multiplier Override Wait Bluetooth Interval, Mesh Super Deep Sleep Timeout, Super Deep Sleep Interval, Light Sleep Interval and Minimum Wake Interval. Power config uses an admin message sending a `Config.Power` protobuf.
|
||||
|
||||
|
|
@ -16,14 +16,13 @@ Power settings are advanced configuration, most users should choose a role under
|
|||
|
||||
### Power Saving
|
||||
|
||||
If set, we are powered from a low-current source (i.e. solar), so even if it looks like we have power flowing in we should try to minimize power consumption as much as possible.
|
||||
If set, Bluetooth, Wifi, and screen (if applicable) are turned off. When using the Router device role, this setting is on by default. The assumption for a Router is that the device will be used in a standalone manner where these features are not needed, and will be shut off to conserve power. This is especially useful when a device is powered from a low-current source (i.e. solar).
|
||||
|
||||
### Shutdown after losing power
|
||||
|
||||
Automatically shut down a device after a defined time period if power is lost.
|
||||
|
||||
### ADC Multiplier Override
|
||||
**Fixes issues on Heltec v2**
|
||||
### ADC Multiplier Override `Fixes issues on Heltec v2`
|
||||
|
||||
Ratio of voltage divider for battery pin e.g. 3.20 (R1=100k, R2=220k)
|
||||
|
||||
|
|
@ -51,9 +50,7 @@ While in Light Sleep if Mesh Super Deep Sleep Timeout Seconds is exceeded we wil
|
|||
|
||||
`0` for default of one year
|
||||
|
||||
### Light Sleep Interval
|
||||
|
||||
**ESP32 Only Setting**
|
||||
### Light Sleep Interval `ESP32 Only Setting`
|
||||
|
||||
In light sleep the CPU is suspended, LoRa radio is on, BLE is off an GPS is on
|
||||
|
||||
|
|
@ -105,7 +102,7 @@ All Power config options are available in the python CLI.
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :----------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------: |
|
||||
| :----------------------------------: | :--------------------------: | :---------------------------------: |
|
||||
| power.is_power_saving | `true`, `false` | `false` |
|
||||
| power.on_battery_shutdown_after_secs | `integer` (seconds) | Default of `0` is off |
|
||||
| power.adc_multiplier_override | `2-4` (floating point value) | Default of `0` uses firmware values |
|
||||
|
|
@ -161,6 +158,7 @@ meshtastic --set power.ls_secs 120
|
|||
meshtastic --set power.min_wake_secs 0
|
||||
meshtastic --set power.min_wake_secs 120
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="web">
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/config/user
|
|||
sidebar_label: User
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The user config options are: Long Name, Short Name, and Is Licensed. User config uses an admin message sending a `User` protobuf.
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,6 @@ slug: /hardware/peripheral/
|
|||
sidebar_position: 6
|
||||
---
|
||||
|
||||
|
||||
## Firmware Versions
|
||||
|
||||
:::warning
|
||||
|
|
@ -47,7 +46,7 @@ The procedure using the python command line tool is:
|
|||
meshtastic --ch-add gpio
|
||||
```
|
||||
3. If doing local testing, you may also want to change the speed of the channel:
|
||||
```sh
|
||||
```shell
|
||||
meshtastic --ch-mediumfast
|
||||
```
|
||||
4. Check the channel has been created and copy the long "Complete URL" that contains all the channels on that device:
|
||||
|
|
@ -144,7 +143,6 @@ By default, the pin may be "off" or "on". (It will most likely "off".) See the s
|
|||
|
||||
|
||||
|
||||
|
||||
## Using GPIOs from the Python CLI
|
||||
|
||||
### Writing a GPIO
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/audio
|
|||
sidebar_label: Audio
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The audio module config options are: Codec2 Enabled, PTT GPIO, Audio Bitrate/Codec Mode, I2S Word Select, I2S Data IN, I2S Data OUT and I2S Clock. Audio Module config uses an admin message sending a `ConfigModule.Audio` protobuf.
|
||||
|
||||
|
|
@ -26,15 +26,15 @@ The GPIO to use for the Push-To-Talk button. The default is GPIO 39 on the ESP32
|
|||
|
||||
The bitrate to use for audio. The default is `CODEC2_700B`. The available options are:
|
||||
|
||||
* CODEC2_DEFAULT
|
||||
* CODEC2_3200
|
||||
* CODEC2_2400
|
||||
* CODEC2_1600
|
||||
* CODEC2_1400
|
||||
* CODEC2_1300
|
||||
* CODEC2_1200
|
||||
* CODEC2_700B
|
||||
* CODEC2_700
|
||||
- CODEC2_DEFAULT
|
||||
- CODEC2_3200
|
||||
- CODEC2_2400
|
||||
- CODEC2_1600
|
||||
- CODEC2_1400
|
||||
- CODEC2_1300
|
||||
- CODEC2_1200
|
||||
- CODEC2_700B
|
||||
- CODEC2_700
|
||||
|
||||
### I2S Word Select
|
||||
|
||||
|
|
@ -53,7 +53,7 @@ The GPIO to use for the DIN signal in the I2S interface.
|
|||
The GPIO to use for the SCK signal in the I2S interface.
|
||||
|
||||
:::info What is this?
|
||||
These Pins comprise an I2S digital audio interface. Meshtastic uses it in monoaural mode. The software will use the logical 'LEFT' Stereo channel for the microphone and the logical 'RIGHT' Stereo channel for the speaker, so configure your breakouts accordingly. Audio is Half-Duplex, so we can re-use part of the pins for a bi-directional configuration. There's __no__ default pin assigment, setting these is mandatory.
|
||||
These Pins comprise an I2S digital audio interface. Meshtastic uses it in monoaural mode. The software will use the logical 'LEFT' Stereo channel for the microphone and the logical 'RIGHT' Stereo channel for the speaker, so configure your breakouts accordingly. Audio is Half-Duplex, so we can re-use part of the pins for a bi-directional configuration. There's **no** default pin assigment, setting these is mandatory.
|
||||
:::
|
||||
|
||||
## Audio Module Config Client Availability
|
||||
|
|
@ -95,7 +95,7 @@ All audio module config options are available in the python CLI. Example command
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :-------------------: | :-----------------: | :-----: |
|
||||
| :-----------: | :-----------------------------------------------------------------------------------------------------------------------------: | :----------------------: |
|
||||
| audio.enabled | `true`, `false` | `false` |
|
||||
| audio.ptt_pin | GPIO Pin Number 1-39 | Default of `39` is Unset |
|
||||
| audio.bitrate | `CODEC2_DEFAULT` `CODEC2_3200` `CODEC2_2400` `CODEC2_1600` `CODEC2_1400` `CODEC2_1300` `CODEC2_1200` `CODEC2_700B` `CODEC2_700` | `CODEC2_DEFAULT` |
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/canned-message
|
|||
sidebar_label: Canned Message
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The Canned Message Module will allow you to send messages to the mesh network from the device without using the phone app. You can predefine text messages to choose from.
|
||||
|
||||
|
|
@ -34,7 +34,7 @@ The list of pre-set messages, up to 200 bytes.
|
|||
Input event sources accepted by the canned message module.
|
||||
|
||||
| Value | Description |
|
||||
| :----------: | :---------------------------------------------------------------------: |
|
||||
| :----------: | :------------------------------------------------------------------: |
|
||||
| `_any` | Default. Allows any peripheral input device connected to the device. |
|
||||
| `rotEnc1` | Basic Rotary Encoder |
|
||||
| `upDownEnc1` | Up Down Encoder (use this also for RAK14006 Rotary Encoder) |
|
||||
|
|
@ -113,7 +113,7 @@ All canned message module config options are available in the python CLI.
|
|||
Example commands are below:
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :--------------------------------------: | :---------------: | :-----------: |
|
||||
| :------------------------------------: | :---------------------------------------: | :-----------: |
|
||||
| canned_message.enabled | `true`, `false` | `false` |
|
||||
| canned_message.send_bell | `true`, `false` | `false` |
|
||||
| canned_message.allow_input_source | `rotEnc1`, `_any`, `upDownEnc1`, `cardkb` | `_any` |
|
||||
|
|
@ -188,6 +188,7 @@ meshtastic --set canned_message.inputbroker_event_ccw ""
|
|||
meshtastic --set canned_message.inputbroker_event_press KEY_SELECT
|
||||
meshtastic --set canned_message.inputbroker_event_press ""
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="web">
|
||||
|
||||
|
|
@ -241,7 +242,7 @@ You will need a generic rotary encoder. The types listed below has five legs whe
|
|||
|
||||
Connect your rotary encoder as follows. The rotary encoder has two rows of legs. One of the rows contains two legs, the other contains three legs. Bottom side view:
|
||||
|
||||
```
|
||||
```text
|
||||
B o --- o PRESS
|
||||
GND o | |
|
||||
A o --- o GND
|
||||
|
|
@ -251,7 +252,7 @@ The two legs is to sense the press action (or push). Connect one of the two to G
|
|||
|
||||
The three legs is to sense the rotation action. Connect the middle leg to GROUND and the ones on the side to GPIO pins. Let's call these ports 'A' and 'B', according to the scheme below.
|
||||
|
||||
```
|
||||
```text
|
||||
A --||
|
||||
GND --||]========
|
||||
B --||
|
||||
|
|
@ -267,7 +268,6 @@ Recommended GPIO pins for connecting a rotary encoder.
|
|||
There is a reference case 3D-design utilizing the rotary encoder for TTGO LoRa V1:
|
||||
[Case for TTGO-ESP32-LORA-OLED-v1.0 with rotary encoder](https://www.thingiverse.com/thing:5178495)
|
||||
|
||||
|
||||
## Examples
|
||||
|
||||
- Attach a compatible peripheral device. Take note of the GPIO numbers you use, as they will be used in the following step.
|
||||
|
|
@ -286,6 +286,4 @@ meshtastic --set canned_message.inputbroker_event_press KEY_SELECT
|
|||
meshtastic --set canned_message.rotary1_enabled True
|
||||
```
|
||||
|
||||
|
||||
That's it! With a functioning and enabled rotary encoder, you're ready to begin configuring the Canned Message Module.
|
||||
|
||||
|
|
|
|||
|
|
@ -5,10 +5,10 @@ slug: /settings/moduleconfig/external-notification
|
|||
sidebar_label: External Notification
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The External Notification Module will allow you to connect a buzzer, speaker, LED, or other device to notify you when a message has been received from the mesh network.
|
||||
The External Notification Module will allow you to connect a buzzer, speaker, LED, or other device to notify you when a message has been received from the mesh network. You can enable up to 3 pins independently from each other.
|
||||
|
||||
## External Notification Module Config Values
|
||||
|
||||
|
|
@ -16,21 +16,22 @@ The External Notification Module will allow you to connect a buzzer, speaker, LE
|
|||
|
||||
Enables the external notification module.
|
||||
|
||||
### Alert when receiving a bell
|
||||
### Alert when receiving a bell (general / LED, Vibra and Buzzer)
|
||||
|
||||
Specifies if an alert should be triggered when receiving an incoming bell.
|
||||
|
||||
### Alert when receiving a message
|
||||
### Alert when receiving a message (general / LED, Vibra and Buzzer)
|
||||
|
||||
Specifies if an alert should be triggered when receiving an incoming message.
|
||||
|
||||
### Active
|
||||
### Active (general / LED only)
|
||||
|
||||
Specifies whether the external circuit is triggered when the device's GPIO is low or high.
|
||||
Specifies whether the external circuit is active when the device's GPIO is low or high.
|
||||
|
||||
### GPIO to monitor
|
||||
### GPIO Pins (general / LED, Vibra and Buzzer)
|
||||
|
||||
Specifies the GPIO that your external circuit is attached to on the device. On devices that have a PWM buzzer, you can use the buzzer for notifications by setting this to the same pin the buzzer uses.
|
||||
Specifies the GPIO that your external circuit is attached to on the device. On devices that have a PWM buzzer, you can use the buzzer for notifications by setting the use_pwm property to TRUE. The Buzzer Pin will be ignored and the device.buzzer_gpio is used instead. If you enable PWM mode, the device will use
|
||||
so-called RTTTL ring tones for notification. You can find examples of RTTTL ring tones [here](https://www.laub-home.de/wiki/RTTTL_Songs) and upload them to the device via a client application.
|
||||
|
||||
:::info
|
||||
On ESP32 based boards, GPIOs 34 to 39 are GPIs – input only pins. These pins do not have internal pull-up or pull-down resistors. They can not be used as outputs, so you can NOT use these pins as outputs.
|
||||
|
|
@ -38,10 +39,14 @@ On ESP32 based boards, GPIOs 34 to 39 are GPIs – input only pins. These pins d
|
|||
|
||||
### How long monitored GPIO is triggered
|
||||
|
||||
Specifies how long in milliseconds you would like your external circuit to be triggered.
|
||||
Specifies how long in milliseconds you would like your GPIOs to be active. In case of the repeat option, this is the duration of every tone and pause.
|
||||
|
||||
Default of 0 is 1000ms
|
||||
|
||||
### Repeat (Nag Timeout) (general / LED, Vibra and Buzzer)
|
||||
|
||||
Specifies if the alert should be repeated. If set to a value greater than zero, the alert will be repeated until the user button is pressed or 'value' number of seconds have past.
|
||||
|
||||
## External Notification Module Config Client Availability
|
||||
|
||||
<Tabs
|
||||
|
|
@ -81,13 +86,21 @@ All external notification module config options are available in the python CLI.
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :----------------------------: | :----------------------: | :-----: |
|
||||
| :----------------------------------------: | :----------------------: | :-----: |
|
||||
| external_notification.enabled | `true`, `false` | `false` |
|
||||
| external_notification.active | `true`, `false` | `false` |
|
||||
| external_notification.alert_bell | `true`, `false` | `false` |
|
||||
| external_notification.alert_bell_vibra | `true`, `false` | `false` |
|
||||
| external_notification.alert_bell_buzzer | `true`, `false` | `false` |
|
||||
| external_notification.alert_message | `true`, `false` | `false` |
|
||||
| external_notification.alert_message_vibra | `true`, `false` | `false` |
|
||||
| external_notification.alert_message_buzzer | `true`, `false` | `false` |
|
||||
| external_notification.output | `integer` | `0` |
|
||||
| external_notification.output_vibra | `integer` | `0` |
|
||||
| external_notification.output_buzzer | `integer` | `0` |
|
||||
| external_notification.output_ms | `integer` (milliseconds) | `0` |
|
||||
| external_notification.use_pwm | `true`, `false` | `false` |
|
||||
| external_notification.nag_timeout | `integer` (seconds) | `0` |
|
||||
|
||||
:::tip
|
||||
|
||||
|
|
@ -127,6 +140,7 @@ meshtastic --set external_notification.output 21
|
|||
meshtastic --set external_notification.output_ms 0
|
||||
meshtastic --set external_notification.output_ms 1500
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="web">
|
||||
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ sidebar_position: 3
|
|||
Modules are included in the firmware and allow users to extend the functionality of their mesh or device.
|
||||
|
||||
| Name | Description |
|
||||
|:----:|:-----------:|
|
||||
| :------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
||||
| [Audio](/docs/settings/moduleconfig/audio) | enable Support for Codec2 Voice Comms on certain devices |
|
||||
| [Canned Message](/docs/settings/moduleconfig/canned-message) | Set a number of predefined messages to send out directly from the device with the use of an input device like a rotary encoder. |
|
||||
| [External Notification](/docs/settings/moduleconfig/external-notification) | Incoming messages are able to alert you using circuits you attach to the device (LEDs, Buzzers, etc) |
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/mqtt
|
|||
sidebar_label: MQTT
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
If your device is connected to Internet via wifi or ethernet, you can enable it to forward packets along to an MQTT server. This allows users on the local mesh to communicate with users on the internet. One or more channels must be enabled as uplink and/or downlink for protobufs to be transmitted from and/or to the mesh (See [channels](/docs/settings/config/channels#downlink-enabled)). Without these settings the node will still connect to MQTT server and send status messages.
|
||||
|
||||
|
|
@ -79,7 +79,7 @@ All MQTT module config options are available in the python CLI. Example commands
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :--------------------------: | :----------------------: | :-----: |
|
||||
| :---------------------: | :---------------: | :-----: |
|
||||
| mqtt.enabled | `true`, `false` | `false` |
|
||||
| mqtt.address | `string` | |
|
||||
| mqtt.username | `string` | |
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/range-test
|
|||
sidebar_label: Range Test
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
This module allows you to test the range of your Meshtastic nodes. It requires at least two nodes, a sender and a receiver. The receiving node then saves the messages along with the GPS coordinates at which they were received into a .csv file. This .csv file can then be integrated into [Google Earth](https://earth.google.com), [Google Maps - My Maps](https://mymaps.google.com), or any other program capable of processing .csv files. This can enable you to visualize your mesh.
|
||||
|
||||
|
|
@ -18,9 +18,7 @@ The range test module config options are: Enabled, Save, and Sender. Range Test
|
|||
|
||||
Enables the range test module.
|
||||
|
||||
### Save CSV File
|
||||
|
||||
**ESP32 Only Setting**
|
||||
### Save CSV File `ESP32 Only Setting`
|
||||
|
||||
If enabled, we will save a log of all received messages to a file named rangetest.csv which you can access from the web server Extensions > File Browser > rangetest.csv. The file will be created after receiving messages. The device will abort writing if there is less than 50k of space on the filesystem to prevent filling up the storage.
|
||||
|
||||
|
|
@ -67,7 +65,7 @@ Range Test module config options are available in the python CLI. Example comman
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :-----------------------: | :-----------------: | :-----: |
|
||||
| :----------------: | :-----------------: | :-----: |
|
||||
| range_test.enabled | `true`, `false` | `false` |
|
||||
| range_test.save | `true`, `false` | `false` |
|
||||
| range_test.sender | `integer` (Seconds) | `0` |
|
||||
|
|
@ -121,7 +119,7 @@ Be sure to turn off either the module configured as a sender or the device where
|
|||
Also be mindful of your space usage on the file system. It has protections from filling up the space but it's best to delete old range test results.
|
||||
|
||||
:::note
|
||||
Leaving this module on can slow down your mesh. Currently, the messages are sent using the same `TEXT_MESSAGE_APP` [port that all other messages](/docs/developers/protobufs/api#portnumsproto) are sent on.
|
||||
Leaving this module on can slow down your mesh. Currently, the messages are sent using the same `TEXT_MESSAGE_APP` [port that all other messages](https://buf.build/meshtastic/protobufs/docs/main:meshtastic#meshtastic.PortNum) are sent on.
|
||||
:::
|
||||
|
||||
### Accessing your CSV
|
||||
|
|
@ -142,8 +140,6 @@ http://198.168.0.15
|
|||
| Medium | 15 |
|
||||
| Short Fast | 15 |
|
||||
|
||||
|
||||
|
||||
## Application Examples
|
||||
|
||||
### Google Earth Integration
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/serial
|
|||
sidebar_label: Serial
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The serial module config options are: Enabled, Echo, Mode, Receive GPIO, Transmit GPIO and Sender. Serial Module config uses an admin message sending a `ConfigModule.Serial` protobuf.
|
||||
|
||||
|
|
@ -14,7 +14,6 @@ This is a simple interface to send messages over the mesh network by sending str
|
|||
|
||||
|
||||
|
||||
|
||||
## Serial Module Config Values
|
||||
|
||||
### Enabled
|
||||
|
|
@ -31,11 +30,11 @@ Defaults to 'Simple'.
|
|||
|
||||
Available Values:
|
||||
|
||||
* `DEFAULT`
|
||||
* `SIMPLE` operate as an dumb UART tunnel. What goes in will come out, Requires a channel named 'serial'.
|
||||
* `PROTO` Exposes the Protobuf Client API on this serial port. You can use this to connect from another device. [API Reference](/docs/development/device/client-api)
|
||||
* `TEXTMSG` Will send the string received over the serial port as a Text Message for Display on the other devices.
|
||||
* `NMEA` Will output a NMEA 0183 Data stream containing the internal GPS or fixed position and other node locations as Waypoints (WPL).
|
||||
- `DEFAULT`
|
||||
- `SIMPLE` operate as an dumb UART tunnel. What goes in will come out, Requires a channel named 'serial'.
|
||||
- `PROTO` Exposes the Protobuf Client API on this serial port. You can use this to connect from another device. [API Reference](/docs/development/device/client-api)
|
||||
- `TEXTMSG` Will send the string received over the serial port as a Text Message for Display on the other devices.
|
||||
- `NMEA` Will output a NMEA 0183 Data stream containing the internal GPS or fixed position and other node locations as Waypoints (WPL).
|
||||
|
||||
### Receive GPIO Pin
|
||||
|
||||
|
|
@ -100,14 +99,14 @@ All serial module config options are available in the python CLI. Example comman
|
|||
:::
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :-------------------: | :-----------------: | :-----: |
|
||||
| :------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------: |
|
||||
| serial.enabled | `true`, `false` | `false` |
|
||||
| serial.echo | `true`, `false` | `false` |
|
||||
| serial.mode | `DEFAULT` `SIMPLE` `PROTO` `TEXTMSG`, `NMEA` | `DEFAULT` |
|
||||
| serial.rxd | GPIO Pin Number 1-39 | Default of `0` is Unset |
|
||||
| serial.txd | GPIO Pin Number 1-33 | Default of `0` is Unset |
|
||||
| serial.baud | `BAUD_DEFAULT` `BAUD_110` `BAUD_300` `BAUD_600` `BAUD_1200` `BAUD_2400` `BAUD_4800` `BAUD_9600` `BAUD_19200` `BAUD_38400` `BAUD_57600` `BAUD_115200` `BAUD_230400` `BAUD_460800` `BAUD_576000` `BAUD_921600` | `BAUD_DEFAULT` |
|
||||
| serial.timeout | `integer` (seconds) | `0` |
|
||||
| serial.timeout | `integer` (milli seconds) | Default of `0` corresponds to 250 ms |
|
||||
|
||||
:::tip
|
||||
|
||||
|
|
@ -147,7 +146,7 @@ meshtastic --set serial.baud BAUD_DEFAULT
|
|||
meshtastic --set serial.baud BAUD_576000
|
||||
```
|
||||
|
||||
```shell title="Set Timeout to 15 seconds"
|
||||
```shell title="Set Timeout to 15 milli seconds"
|
||||
meshtastic --set serial.timeout 15
|
||||
```
|
||||
|
||||
|
|
@ -170,7 +169,8 @@ This module requires attaching a peripheral accessory to your device. It will no
|
|||
## Examples
|
||||
|
||||
Default is to use RX GPIO 16 and TX GPIO 17.
|
||||
### Basic Usage:
|
||||
|
||||
### Basic Usage
|
||||
|
||||
1. Enable the module by setting `serial.enabled` to `1`.
|
||||
2. Set the pins (`serial.rxd` / `serial.txd`) for your preferred RX and TX GPIO pins. On tbeam boards it is recommended to use:
|
||||
|
|
@ -181,23 +181,27 @@ Default is to use RX GPIO 16 and TX GPIO 17.
|
|||
5. Connect to your device over the serial interface at `38400 8N1`.
|
||||
|
||||
With [tio](https://github.com/tio/tio) – `tio -e -b 38400 -f none /dev/myserialport`
|
||||
7. Send a packet up to 237 bytes in length. This will get relayed over the mesh network.
|
||||
8. (Optional) Set `serial.echo` to `1` and any message you send out will be echoed back to your device.
|
||||
|
||||
6. Send a packet up to 237 bytes in length. This will get relayed over the mesh network.
|
||||
7. (Optional) Set `serial.echo` to `1` and any message you send out will be echoed back to your device.
|
||||
|
||||
### Interfacing PIR Sensor With External Microcontroller
|
||||
|
||||
The following is an example of using a Raspberry Pi Pico connected to a PIR sensor to detect motion. When motion is detected, a message is sent via. serial to the T-Beam. The T-Beam transmits the message as text over the default channel by utilizing the serial module in TXTMSG mode.
|
||||
|
||||
#### BOM
|
||||
|
||||
- Raspberry Pi Pico running [CircuitPython](https://learn.adafruit.com/getting-started-with-raspberry-pi-pico-circuitpython)
|
||||
- T-Beam V1.1 running Meshtastic
|
||||
- PIR Sensor ([Adafruit Breadboard Model](https://www.adafruit.com/product/4871))
|
||||
|
||||
#### Meshtastic Software Configuration:
|
||||
#### Meshtastic Software Configuration
|
||||
|
||||
- Serial module enabled, mode: TXTMSG
|
||||
- GPIO Pins (For T-Beam) RX 13, TX 14
|
||||
- 38400 Baud
|
||||
|
||||
#### Wiring:
|
||||
#### Wiring
|
||||
|
||||
|
||||
|
||||
|
|
@ -212,6 +216,7 @@ The following is an example of using a Raspberry Pi Pico connected to a PIR sens
|
|||
- Connect 5V pin on T-Beam to Vbus pin 40 on the Pico
|
||||
|
||||
#### Circuit Python Code
|
||||
|
||||
```python
|
||||
import time
|
||||
import board
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/telemetry
|
|||
sidebar_label: Telemetry
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
The Telemetry Module provides two types of data over the mesh. Device metrics (Battery Level, Voltage, Channel Utilization and Airtime) from your meshtastic device and Environment Metrics from attached I2C sensors.
|
||||
|
||||
|
|
@ -102,7 +102,7 @@ All telemetry module config options are available in the python CLI. Example com
|
|||
## Settings
|
||||
|
||||
| Setting | Acceptable Values | Default |
|
||||
| :-----------------------------------------------------: | :-----------------: | :-----: |
|
||||
| :---------------------------------------: | :-----------------: | :---------------------------------------: |
|
||||
| telemetry.device_update_interval | `integer` (seconds) | Default `0` is 15 minutes(`900` seconds). |
|
||||
| telemetry.environment_display_fahrenheit | `true`, `false` | `false` |
|
||||
| telemetry.environment_measurement_enabled | `true`, `false` | `false` |
|
||||
|
|
@ -125,7 +125,7 @@ meshtastic --set telemetry.device_update_interval 0
|
|||
meshtastic --set telemetry.device_update_interval 0
|
||||
// Environment Metrics Two Minutes
|
||||
meshtastic --set telemetry.environment_update_interval 120
|
||||
````
|
||||
```
|
||||
|
||||
```shell title="Enable/Disable Environment Module"
|
||||
meshtastic --set telemetry.environment_measurement_enabled true
|
||||
|
|
@ -140,7 +140,7 @@ meshtastic --set telemetry.environment_screen_enabled false
|
|||
```shell title="Enable / Disable Display Fahrenheit"
|
||||
meshtastic --set telemetry.environment_display_fahrenheit true
|
||||
meshtastic --set telemetry.environment_display_fahrenheit false
|
||||
````
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="web">
|
||||
|
|
@ -197,12 +197,12 @@ And examine the serial logs for Telemetry diagnostic information.
|
|||
|
||||
The environment metrics in the telemetry module supports a limited amount of fields as they are stored in memory on the device. Support for sensors that provide one or more of the following fields can potentially be added to the main firmware provided there is a GPL licensed library for us to include to support it, and the library size is not prohibitive.
|
||||
|
||||
* Temperature
|
||||
* Relative Humidity
|
||||
* Barometric Pressure
|
||||
* Gas Resistance (AQI)
|
||||
* Voltage
|
||||
* Current
|
||||
- Temperature
|
||||
- Relative Humidity
|
||||
- Barometric Pressure
|
||||
- Gas Resistance (AQI)
|
||||
- Voltage
|
||||
- Current
|
||||
|
||||
### Supporting Other Sensor types
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ slug: /settings/moduleconfig/traceroute
|
|||
sidebar_label: Traceroute
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
Due to the limited bandwidth of LoRa, Meshtastic does not keep track of the nodes a message used to hop to the destination. However, from firmware 2.0.8 on, there is a Traceroute Module that can show you this.
|
||||
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ sidebar_position: 5
|
|||
The RAK4631 uses symbolic labels for its I/O Pins on the module and baseboard silk screens. The following table shows the mapping of the RAK4631 GPIO pins to the corresponding Arduino pins and the MCU Port numbers.
|
||||
|
||||
| RAK Pin | nRF52840 Pin | Arduino GPIO | Remark |
|
||||
| ------- | ------------ | ------------ | ------ |
|
||||
| ------- | ------------ | ------------ | ------------------------------------------------------------------------ |
|
||||
| IO1 | P0.17 | 17 | used for GPS PPM signal if GPS module is connected |
|
||||
| IO2 | P1.02 | 34 | used to power all peripheral modules, not available for user application |
|
||||
| IO3 | P0.21 | 21 |
|
||||
|
|
@ -28,9 +28,9 @@ When configuring GPIO pins in your device settings, the Arduino GPIO numbers sho
|
|||
```shell title="Example"
|
||||
meshtastic --set external_notification.output 10
|
||||
```
|
||||
|
||||
This will use IO6 on a RAK4631
|
||||
|
||||
:::caution Note
|
||||
There is no usable GPIO pin on any RAK base board except the 'big' baseboard RAK19001 without adding a RAK13002 IO module or a third party IO sensor breakout.
|
||||
:::
|
||||
|
||||
|
|
|
|||
|
|
@ -151,7 +151,7 @@ Completed getting preferences
|
|||
For further reading, I recommend starting out with [Meshtastic-python](/docs/software/python/cli/) if you haven't already gone through this (hopefully you have since you are reading this). But for a full reference to the settings you can change, please see:
|
||||
|
||||
[Settings Overview](/docs/settings) and
|
||||
[Complete list of user settings in Protobufs](/docs/developers/protobufs/api#radioconfiguserpreferences)
|
||||
[Complete list of user settings in Protobufs](https://buf.build/meshtastic/protobufs/docs/main:meshtastic#meshtastic.User)
|
||||
|
||||
## Areas for future development
|
||||
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ If you would like to develop this application we'd love your help! These build i
|
|||
1. Use Android Studio to build/debug
|
||||
2. Use `git submodule update --init --recursive` to pull in the various sub-modules we depend on.
|
||||
3. There are a few config files which you'll need to copy from templates included in the project. Run the following commands to do so:
|
||||
```sh
|
||||
```shell
|
||||
rm ./app/google-services.json
|
||||
cp ./app/google-services-example.json ./app/google-services.json
|
||||
rm ./app/src/main/res/values/curfirmwareversion.xml
|
||||
|
|
@ -30,13 +30,14 @@ Analytics are included but can be disabled by the user on the settings screen.
|
|||
|
||||
1. Configure analytics for development device
|
||||
|
||||
```sh
|
||||
```shell
|
||||
adb shell setprop debug.firebase.analytics.app com.geeksville.mesh
|
||||
adb shell setprop log.tag.FirebaseCrashlytics DEBUG
|
||||
```
|
||||
|
||||
2. Set verbose logging
|
||||
|
||||
```sh
|
||||
```shell
|
||||
adb shell setprop log.tag.FA VERBOSE
|
||||
```
|
||||
|
||||
|
|
@ -51,7 +52,7 @@ Only available for core developers that publish releases.
|
|||
- Name of the `.jks`
|
||||
- **KEYSTORE**
|
||||
- Convert the `.jks` to base64:
|
||||
```sh
|
||||
```shell
|
||||
openssl base64 < filename.jks | tr -d '\n' | tee filename.txt
|
||||
```
|
||||
- **KEYSTORE_PROPERTIES**
|
||||
|
|
@ -63,4 +64,3 @@ Only available for core developers that publish releases.
|
|||
3. Go to Actions / Make Release / Run Workflow
|
||||
4. Pick the Releases branch
|
||||
5. Enter the version found in `app/gradle.build`
|
||||
|
||||
|
|
|
|||
|
|
@ -27,7 +27,6 @@ The 4 byte header is constructed to both provide framing and to not look line 'n
|
|||
|
||||
The receiver will validate length and if >512 it will assume the packet is corrupted and return to looking for START1. While looking for START1 any other characters are printed as "debug output". For small example implementation of this reader see the python implementation.
|
||||
|
||||
|
||||
## Bluetooth (MeshBluetoothService)
|
||||
|
||||
This is the main Bluetooth service for the device and provides the API your app should use to get information about the mesh, send packets, or provision the radio.
|
||||
|
|
|
|||
|
|
@ -8,11 +8,11 @@ sidebar_position: 4
|
|||
The device might report these fault codes on the screen, but it will also be outputted on the device serial output. If you encounter a fault code, please post on the forum and we'll try to help.
|
||||
|
||||
:::note
|
||||
This table is derived from the [protobufs](/docs/developers/protobufs/api#criticalerrorcode)
|
||||
This table is derived from the [protobufs](https://buf.build/meshtastic/protobufs/docs/main:meshtastic#meshtastic.CriticalErrorCode)
|
||||
:::
|
||||
|
||||
| Name | Number | Description |
|
||||
|:------------------- :|:------:|:----------------------------------------------------------------------------------------------------------------------- |
|
||||
| :-----------------: | :----: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| TxWatchdog | 1 | A software bug was detected while trying to send LoRa |
|
||||
| SleepEnterWait | 2 | A software bug was detected on entry to sleep |
|
||||
| NoRadio | 3 | No LoRa radio hardware could be found |
|
||||
|
|
|
|||
|
|
@ -61,12 +61,14 @@ The protobufs will be sent in binary as the body for the request.
|
|||
**Parameters**
|
||||
|
||||
##### **/api/v1/fromradio?all**
|
||||
|
||||
- `all=false` (unset default)
|
||||
- Only one protobuf is returned.
|
||||
- `all=true`
|
||||
- All available protobufs are returned.
|
||||
|
||||
##### **/api/v1/fromradio?chunked**
|
||||
|
||||
- `chunked=false` (unset default, not yet implemented)
|
||||
- The request returns all protobufs that can be delivered for the client's session (this would allow the client to poll by doing a series of requests). This is the only option that is supported in the initial release.
|
||||
- `chunked=true` (not yet implemented)
|
||||
|
|
|
|||
|
|
@ -67,7 +67,7 @@ The easiest way to get started is:
|
|||
|
||||
1. [Build the firmware](/docs/development/firmware/build) codebase.
|
||||
2. Copy the [ReplyModule](http://github.com/meshtastic/firmware/tree/master/src/modules/ReplyModule.cpp) as a template into `src/modules/`.
|
||||
```sh
|
||||
```shell
|
||||
cp src/modules/ReplyModule.* src/modules/YourModule.*
|
||||
```
|
||||
3. Change the port number from `PortNum_REPLY_APP` to `PortNum_PRIVATE_APP`.
|
||||
|
|
@ -96,4 +96,3 @@ If you would like to use protocol buffers to define the structures you send over
|
|||
1. Create a new `.proto` file in the protos directory.
|
||||
2. Run `./bin/regen-protos.sh` to regenerate the C code for accessing the protocol buffers. If you don't have the required nanopb tool, follow the instructions printed by the script to get it.
|
||||
3. Done! You can now use your new protobuf just like any of the existing protobufs in Meshtastic.
|
||||
|
||||
|
|
|
|||
|
|
@ -7,14 +7,18 @@ sidebar_label: Publish
|
|||
## Publish Live
|
||||
|
||||
1. Generate protobuf docs
|
||||
|
||||
```shell
|
||||
cd meshtastic
|
||||
./scripts/gen-proto-docs.sh
|
||||
```
|
||||
|
||||
2. Build
|
||||
|
||||
```shell
|
||||
pnpm build
|
||||
```
|
||||
|
||||
3. Submit Pull Request
|
||||
|
||||
## Publish to Vercel
|
||||
|
|
@ -48,4 +52,3 @@ There is a limited number of branch urls that you will be able to view. If you n
|
|||
|
||||
Branch urls are helpful in PRs because they will remain constant, and you won't need to resubmit a new url for review each new commit if changes are requested.
|
||||
:::
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,5 @@
|
|||
|
||||
position: 1 # float position is supported
|
||||
label: 'Style Guides'
|
||||
label: "Style Guides"
|
||||
collapsible: true # make the category collapsible
|
||||
link:
|
||||
slug: /development/docs/style-guide
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ title: Markdown Features
|
|||
sidebar_label: Markdown Features
|
||||
---
|
||||
|
||||
import { Dark, Light } from '/src/components/ColorMode';
|
||||
import { Dark, Light } from "/src/components/ColorMode";
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
@ -14,7 +14,7 @@ We have developed several [React](https://reactjs.org/) components for assisting
|
|||
|
||||
### Light/Dark Mode Switch
|
||||
|
||||
#### Usage:
|
||||
#### Usage
|
||||
|
||||
```jsx
|
||||
import { Dark, Light } from '/src/components/ColorMode';
|
||||
|
|
@ -27,7 +27,7 @@ import { Dark, Light } from '/src/components/ColorMode';
|
|||
|
||||
```
|
||||
|
||||
#### Demo:
|
||||
#### Demo
|
||||
|
||||
<Dark>
|
||||
<div className="not-prose rounded-lg bg-primary shadow-md">
|
||||
|
|
@ -50,7 +50,7 @@ import { Dark, Light } from '/src/components/ColorMode';
|
|||
|
||||
### Code Blocks
|
||||
|
||||
#### Usage:
|
||||
#### Usage
|
||||
|
||||
Always specify the language used directly after the start of the code block (```).
|
||||
|
||||
|
|
@ -71,13 +71,13 @@ export const typedArrayToBuffer = (array: Uint8Array): ArrayBuffer => {
|
|||
```
|
||||
````
|
||||
|
||||
#### Demo:
|
||||
#### Demo
|
||||
|
||||
```ts title="Demo"
|
||||
export const typedArrayToBuffer = (array: Uint8Array): ArrayBuffer => {
|
||||
return array.buffer.slice(
|
||||
array.byteOffset,
|
||||
array.byteLength + array.byteOffset,
|
||||
array.byteLength + array.byteOffset
|
||||
);
|
||||
};
|
||||
```
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ Meshtastic uses [PlatformIO](https://platformio.org), a development environment
|
|||
|
||||
1. [Install PlatformIO](https://platformio.org/platformio-ide)
|
||||
2. Clone the [Meshtastic Firmware](https://github.com/meshtastic/firmware) repository
|
||||
```sh
|
||||
```shell
|
||||
git clone https://github.com/meshtastic/firmware.git
|
||||
```
|
||||
3. Update the repository's [submodules](https://github.com/meshtastic/firmware/blob/master/.gitmodules)
|
||||
|
|
|
|||
|
|
@ -12,6 +12,7 @@ sidebar_label: OLED Localization
|
|||
1. To map the double-byte UTF-8 code to the corresponding extended ASCII character of the desired codepage update the `customFontTableLookup` function in the `Screen.h` file.
|
||||
2. Modify the `switch (last)` statement: use left byte from UTF-8 code in the `case` label to map charachter's right byte to its extended ASCII code by specifying an offset.
|
||||
3. Define language and font in `Screen.cpp`
|
||||
|
||||
```c
|
||||
#ifdef OLED_{LANG_NAME}
|
||||
#include "fonts/OLEDDisplayFonts{LANG_NAME}.h"
|
||||
|
|
@ -25,8 +26,10 @@ sidebar_label: OLED Localization
|
|||
#define FONT_SMALL ArialMT_Plain_10
|
||||
#endif
|
||||
```
|
||||
|
||||
4. Define language in `variant/*/platformio.ini`
|
||||
```
|
||||
|
||||
```text
|
||||
build_flags =
|
||||
${esp32_base.build_flags}
|
||||
-D xxxxx
|
||||
|
|
|
|||
|
|
@ -6,14 +6,14 @@ sidebar_label: Port Numbers
|
|||
|
||||
Any new app that runs on the device or via sister apps on phones/PCs should pick and use a unique "portnum" for their applications use.
|
||||
|
||||
The current list of port numbers can be found listed in the [protobufs](/docs/developers/protobufs/api#portnumsproto)
|
||||
The current list of port numbers can be found listed in the [protobufs](https://buf.build/meshtastic/protobufs/docs/main:meshtastic#meshtastic.CriticalErrorCode)
|
||||
|
||||
## Assignment
|
||||
|
||||
PortNums should be assigned by the following ranges:
|
||||
|
||||
| Portnum | Usage |
|
||||
|:-------:|:---------------------------------------------------------------------------------------------------------------------- |
|
||||
| :-----: | :--------------------------------------------------------------------------------------------------------------------- |
|
||||
| 0-63 | Core Meshtastic use, do not use for third party apps. |
|
||||
| 64-127 | Registered 3rd party apps, send in a pull request that adds a new entry to portnums.proto to register your application |
|
||||
| 256-511 | Use one of these portnums for your private applications that you do not want to register publicly |
|
||||
|
|
|
|||
|
|
@ -15,6 +15,7 @@ This method uses the symbols of the `firmware.elf` file generated from your late
|
|||
:::
|
||||
|
||||
1. Save the backtrace string to a text file:
|
||||
|
||||
```text title="backtrace.txt"
|
||||
Backtrace: 0x....
|
||||
```
|
||||
|
|
@ -27,6 +28,7 @@ This method uses the symbols of the `firmware.elf` file generated from your late
|
|||
### In Real-Time
|
||||
|
||||
In order to decode stack traces in real time, keep the following command (replacing `DEVICE_PORT` with your device's port) running in your terminal with the target device connected:
|
||||
|
||||
```shell
|
||||
pio device monitor --port DEVICE_PORT -f esp32_exception_decoder
|
||||
```
|
||||
|
|
|
|||
|
|
@ -5,17 +5,17 @@ sidebar_label: Connecting
|
|||
---
|
||||
|
||||
```tsx
|
||||
import type React from 'React';
|
||||
import type React from "React";
|
||||
|
||||
import { IHTTPConnection } from '@meshtastic/meshtasticjs';
|
||||
import { IHTTPConnection } from "@meshtastic/meshtasticjs";
|
||||
|
||||
export const Connection = (): JSX.Element => {
|
||||
const connection = new IHTTPConnection();
|
||||
|
||||
const connect = (): void => {
|
||||
void connection.connect({
|
||||
address: '10.0.0.10',
|
||||
fetchInterval: 3000,
|
||||
address: "10.0.0.10",
|
||||
fetchInterval: 3000
|
||||
});
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -13,8 +13,8 @@ import {
|
|||
Client,
|
||||
Types,
|
||||
Protobuf,
|
||||
SettingsManager,
|
||||
} from '@meshtastic/meshtasticjs';
|
||||
SettingsManager
|
||||
} from "@meshtastic/meshtasticjs";
|
||||
|
||||
/**
|
||||
* Connection method
|
||||
|
|
@ -24,7 +24,7 @@ const client = new Client();
|
|||
SettingsManager.setDebugMode(Protobuf.LogLevelEnum.DEBUG);
|
||||
|
||||
const connection = client.createHTTPConnection();
|
||||
connection.connect('192.168.x.x');
|
||||
connection.connect("192.168.x.x");
|
||||
|
||||
const restartDevice: Promise<void> = connection.restartDevice();
|
||||
const getStatistics: Promise<void | Types.WebSPIFFSResponse> =
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ No pre-requisites are needed locally to make a release. All builds are done via
|
|||
|
||||
To test/validate, you will need to run:
|
||||
|
||||
```
|
||||
```shell
|
||||
pip3 install -r requirements.txt
|
||||
pip install .
|
||||
```
|
||||
|
|
@ -25,7 +25,7 @@ pip install .
|
|||
|
||||
connect one device to the serial port and run:
|
||||
|
||||
```
|
||||
```shell
|
||||
pytest -m smoke1
|
||||
```
|
||||
|
||||
|
|
@ -41,8 +41,6 @@ pytest -m smoke1
|
|||
You need permissions in the GitHub project to make a build
|
||||
:::
|
||||
|
||||
|
||||
|
||||
### Meshtastic-flasher
|
||||
|
||||
A `meshtastic-flasher` release consists of publishing the release to PyPi https://pypi.org/project/meshtastic-flasher/ as well as producing single-executable files that are downloadable from Github https://github.com/meshtastic/Meshtastic-gui-installer/releases.
|
||||
|
|
|
|||
|
|
@ -9,41 +9,35 @@ sidebar_label: Python
|
|||
|
||||
We use the Visual Studio Code (VScode) default python formatting conventions (autopep8). So if you use that IDE you should be able to use "Format Document" and not generate unrelated diffs. If you use some other editor, please do not change formatting on lines you have not changed yourself.
|
||||
|
||||
|
||||
### Building
|
||||
|
||||
**To build a new release**
|
||||
|
||||
```sh
|
||||
```shell title="To build a new release"
|
||||
apt install pandoc
|
||||
sudo pip3 install markdown pdoc3 webencodings pyparsing twine autopep8 pylint pytest pytest-cov
|
||||
```
|
||||
|
||||
**For development**
|
||||
|
||||
```sh
|
||||
```shell title="For development"
|
||||
pip3 install -r requirements.txt
|
||||
```
|
||||
|
||||
### Linting
|
||||
|
||||
```sh
|
||||
```shell
|
||||
pylint meshtastic
|
||||
```
|
||||
|
||||
### Testing
|
||||
|
||||
**Install and run pytest**
|
||||
#### Install and run pytest
|
||||
|
||||
- For more verbosity, add `-v` or even `-vv`
|
||||
|
||||
```sh
|
||||
```shell
|
||||
pip3 install .
|
||||
pytest -vv
|
||||
```
|
||||
|
||||
**Run just unit tests**
|
||||
|
||||
```sh
|
||||
```shell title="Run just unit tests"
|
||||
pytest
|
||||
# or (more verbosely)
|
||||
pytest -m unit
|
||||
|
|
@ -51,15 +45,11 @@ pytest -m unit
|
|||
make
|
||||
```
|
||||
|
||||
**Run just integration tests**
|
||||
|
||||
```sh
|
||||
```shell title="Run just integration tests"
|
||||
pytest -m int
|
||||
```
|
||||
|
||||
**Run the smoke test with only one device connected serially (aka smoke1)**
|
||||
|
||||
```sh
|
||||
```shell title="Run the smoke test with only one device connected serially (aka smoke1)"
|
||||
pytest -m smoke1
|
||||
```
|
||||
|
||||
|
|
@ -68,21 +58,15 @@ Running `smoke1` will reset values on the device, including the region to 1 (US)
|
|||
Be sure to hit the reset button on the device after the test is completed.
|
||||
:::
|
||||
|
||||
**Run the smoke test with only two device connected serially (aka smoke2)**
|
||||
|
||||
```sh
|
||||
```shell title="Run the smoke test with only two device connected serially (aka smoke2)"
|
||||
pytest -m smoke2
|
||||
```
|
||||
|
||||
**Run the wifi smoke test**
|
||||
|
||||
```sh
|
||||
```shell title="Run the wifi smoke test"
|
||||
pytest -m smokewifi
|
||||
```
|
||||
|
||||
**Run a specific test**
|
||||
|
||||
```sh
|
||||
```shell title="Run a specific test"
|
||||
pytest -msmoke1 meshtastic/tests/test_smoke1.py::test_smoke1_info
|
||||
|
||||
# or to run a specific smoke2 test
|
||||
|
|
@ -96,9 +80,7 @@ pytest -m smokewifi meshtastic/tests/test_smoke_wifi.py::test_smokewifi_info
|
|||
|
||||
See [pytest.ini](https://github.com/meshtastic/Meshtastic-python/blob/master/pytest.ini).
|
||||
|
||||
**To see the unit test code coverage**
|
||||
|
||||
```sh
|
||||
```shell title="To see the unit test code coverage"
|
||||
pytest --cov=meshtastic
|
||||
# or if want html coverage report
|
||||
pytest --cov-report html --cov=meshtastic
|
||||
|
|
@ -106,9 +88,7 @@ pytest --cov-report html --cov=meshtastic
|
|||
make cov
|
||||
```
|
||||
|
||||
**To see slowest unit tests, you can run**
|
||||
|
||||
```sh
|
||||
```shell title="To see slowest unit tests, you can run"
|
||||
pytest --durations=0
|
||||
# or
|
||||
make slow
|
||||
|
|
@ -118,7 +98,7 @@ make slow
|
|||
|
||||
Pre-generated: [API documentation](https://python.meshtastic.org)
|
||||
|
||||
```sh
|
||||
```shell
|
||||
bin/regen-docs.sh
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -24,6 +24,7 @@ Repobeats images can be generated at [repobeats.axiom.co](https://repobeats.axio
|
|||
|
||||
<!--Project specific badges here-->
|
||||
<!--Crowdin Badge can be generated from https://crowdin.meshtastic.org/u/projects/<project_id>/crowdsource -->
|
||||
|
||||
[](https://crowdin.meshtastic.org/<project>)
|
||||
[](https://github.com/meshtastic/<repo>/actions/workflows/ci.yml)
|
||||
[](https://cla-assistant.io/meshtastic/<repo>)
|
||||
|
|
|
|||
File diff suppressed because it is too large
Load diff
8
docs/development/reference/protobufs.mdx
Normal file
8
docs/development/reference/protobufs.mdx
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
---
|
||||
id: protobufs
|
||||
title: Protobufs
|
||||
---
|
||||
|
||||
Protobufs are used by Meshtastic software to send and receive data between App and Device and Device to Device.
|
||||
|
||||
Documentation on the Meshtastic Protobuf messages can be fund on the [BSR(Buf Schema Registry)](https://buf.build/meshtastic/protobufs).
|
||||
|
|
@ -4,7 +4,6 @@ title: Building
|
|||
sidebar_label: Building
|
||||
---
|
||||
|
||||
|
||||
Releases are automatically generated for every commit as per out [CI](https://github.com/meshtastic/web/blob/master/.github/workflows/main.yml). This performs two actions:
|
||||
|
||||
1. Generates a perpetually updated [GitHub release](https://github.com/meshtastic/web/releases/tag/latest) with an accompanying `build.tar` that a automatically get's pulled by the firmware CI at build time.
|
||||
|
|
|
|||
|
|
@ -1,12 +1,13 @@
|
|||
---
|
||||
id: cli-script
|
||||
title: Flashing with the CLI
|
||||
sidebar_label: CLI Script
|
||||
sidebar_label: CLI Script (Advanced Users)
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
:::caution
|
||||
Make sure not to power the radio on without first attaching the antenna! You could damage the radio chip!
|
||||
|
|
@ -269,8 +270,15 @@ Be very careful to install the correct load for your board. In particular the po
|
|||
|
||||
Select `Flash ESP`. It may take a minute or two. Once complete, "Done! Flashing is complete!" will be shown.
|
||||
|
||||
## Over the Air Update Instructions
|
||||
## Connect and Configure Device
|
||||
|
||||
OTA updates are only currently available on Android.
|
||||
After flashing the Meshtastic firmware to the device, you can proceed with the initial configuration.
|
||||
|
||||
<!--- TODO --->
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/initial-config"}
|
||||
>
|
||||
Connect and Configure Device
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -1,12 +1,13 @@
|
|||
---
|
||||
id: external-serial-adapter
|
||||
title: Flashing with an External Serial Adapter
|
||||
sidebar_label: External Serial Adapter
|
||||
sidebar_label: External Serial Adapter (Advanced Users)
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
:::info
|
||||
This information will likely only be helpful if you've already attempted to go through the prerequisites and processes outlined in [meshtastic flasher](/docs/software/python/flasher) or [manually flashing](/docs/getting-started/flashing-firmware/esp32/cli-script)
|
||||
|
|
@ -19,9 +20,10 @@ Make sure not to power the radio on without first attaching the antenna! You cou
|
|||
## Background
|
||||
|
||||
Situations that may require usage an external USB to Serial Adapter:
|
||||
* Due to the chip shortage, recently purchased devices such as the TTGO T-Beam may come with legacy or non-standard USB to Serial adapter chips that are unreliable in some cases.
|
||||
* Certain devices might have defective USB to Serial chip.
|
||||
* Certain devices, such as the [Hydra](https://github.com/Hydra-Designs/project-hydra-meshtastic-pcb) (Meshtastic-DIY target).
|
||||
|
||||
- Due to the chip shortage, recently purchased devices such as the TTGO T-Beam may come with legacy or non-standard USB to Serial adapter chips that are unreliable in some cases.
|
||||
- Certain devices might have defective USB to Serial chip.
|
||||
- Certain devices, such as the [Hydra](https://github.com/Hydra-Designs/project-hydra-meshtastic-pcb) (Meshtastic-DIY target).
|
||||
|
||||
### USB Serial Adapters
|
||||
|
||||
|
|
@ -62,7 +64,6 @@ After flashing the device is complete, reset your device (via the RST button if
|
|||
If you have the Meshtastic Python CLI installed, you can run `meshtastic --noproto` to connect the device again over the adapter and view the serial output to confirm Meshtastic installed correctly.
|
||||
|
||||
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
In the Meshtastic Flasher, device detection may not work when using the external USB to Serial adapter. You might need to manually select the correct device type from the drop-down.
|
||||
|
|
@ -73,3 +74,16 @@ Sometimes you might receive an error for COM port permission in the Meshtastic F
|
|||
|
||||
You might need to run the process as an administrator, check to ensure software like Cura isn't monopolizing COM ports, or reboot.
|
||||
|
||||
|
||||
## Connect and Configure Device
|
||||
|
||||
After flashing the Meshtastic firmware to the device, you can proceed with the initial configuration.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/initial-config"}
|
||||
>
|
||||
Connect and Configure Device
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ The recommended method for firmware flashing is the [Web-Based Installer.](https
|
|||
|
||||
## Flashing Method for ESP32 Devices
|
||||
|
||||
1. The [Web-Based Installer](https://flasher.meshtastic.org) requires either Chrome or Edge browsers but is an excellent choice for quickly flashing devices. **This is the recommended method for firmware flashing, especially for those new to the project, due to its ease of use.**
|
||||
1. The [Web-Based Installer](/docs/getting-started/flashing-firmware/esp32/web-flasher.mdx) requires either Chrome or Edge browsers but is an excellent choice for quickly flashing devices. **This method is highly recommended for firmware flashing, especially for new users of the project, as it is easy to use.**
|
||||
2. The [Python Flasher](/docs/software/python/flasher) does a lot under the hood to prevent you from needing to use the terminal.
|
||||
3. The [CLI Script](/docs/getting-started/flashing-firmware/esp32/cli-script) is considered the "manual process" for flashing firmware.
|
||||
4. Flashing your device using an [external serial adapter](/docs/getting-started/flashing-firmware/esp32/external-serial-adapter) should only be attempted as a last resort if no other method has been successful.
|
||||
|
|
@ -5,6 +5,7 @@ sidebar_label: Python Flasher
|
|||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import MFlasher from '../../../software/python-flasher.mdx'
|
||||
import MFlasher from "../../../software/python-flasher.mdx";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
<MFlasher components={props.components} />
|
||||
|
|
@ -5,8 +5,23 @@ sidebar_label: Web Flasher (recommended)
|
|||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
## Web Flasher
|
||||
|
||||
1. Plug in your device
|
||||
2. Visit [flasher.meshtastic.org](https://flasher.meshtastic.org) _\*requires Chrome or Edge browser_
|
||||
3. Follow the instructions
|
||||
|
||||
## Connect and Configure Device
|
||||
|
||||
After flashing the Meshtastic firmware to the device, you can proceed with the initial configuration.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/initial-config"}
|
||||
>
|
||||
Connect and Configure Device
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ sidebar_position: 4
|
|||
|
||||
The only difference between the _RAK4631-R_ (RUI3) and the _RAK4631_ (Arduino) is the bootloader it is shipped with - the hardware is the same.
|
||||
|
||||
Meshtastic requires the Arduino bootloader on RAK WisBlock NRF52-based boards. The process of converting the bootloader only needs to be performed once.
|
||||
Meshtastic requires the Arduino bootloader on RAK WisBlock nRF52-based boards. The process of converting the bootloader only needs to be performed once.
|
||||
|
||||
This conversion requires the use of either a [DAPLink](https://daplink.io/) or [J-Link](https://www.segger.com/products/debug-probes/j-link/). The most reasonably priced and available is the [RAKDAP1](https://store.rakwireless.com/products/daplink-tool).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,24 +1,20 @@
|
|||
---
|
||||
id: drag-n-drop
|
||||
title: Drag & Drop NRF52 Firmware Updates
|
||||
title: Drag & Drop nRF52 Firmware Updates
|
||||
sidebar_label: Drag & Drop (recommended)
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
:::info
|
||||
|
||||
Before flashing confirm that you have [RAK4631](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631/) and not a [RAK4631-R](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631-R/) If this is not the case, fear not. The hardware is identical but requires changing the bootloader. Instructions on how to do this are located [here](/docs/getting-started/flashing-firmware/nrf52/convert-rak4631r).
|
||||
|
||||
:::
|
||||
|
||||
## Upgrading from a previous version of Meshtastic
|
||||
|
||||
If you are upgrading your NRF52 device from a previous version of Meshtastic rather than starting from scratch, you may need to do a full factory reset of the internal flash memory. Stale data saved by previous versions of the Meshtastic firmware can cause devices to get stuck in a crash loop at startup.
|
||||
|
||||
Follow the guide to [factory erase your NRF52](/docs/getting-started/flashing-firmware/nrf52/nrf52-erase) device before continuing to [flash firmware](#flash-firmware).
|
||||
|
||||
|
||||
## Flash Firmware
|
||||
|
||||
Download and unzip the latest firmware from [Meshtastic Downloads](https://meshtastic.org/downloads).
|
||||
|
|
@ -30,3 +26,26 @@ Download and unzip the latest firmware from [Meshtastic Downloads](https://mesht
|
|||
5. Drop the appropriate firmware file (`firmware-DEVICE_NAME-vx.x.x-xxxxxxx.uf2`) from the release onto this drive.
|
||||
|
||||
Once the file has finished copying onto the drive, the device will reboot and install the Meshtastic firmware.
|
||||
|
||||
### Issues When Upgrading from A Previous Version of Meshtastic
|
||||
|
||||
:::info
|
||||
|
||||
Previous versions of the Meshtastic firmware may save stale data, causing devices to get stuck in a crash loop during startup. If you experience issues when upgrading your nRF52 device from a previous version of Meshtastic, you may need to perform a full factory reset of the internal flash memory.
|
||||
|
||||
Follow the guide to [factory erase your nRF52](/docs/getting-started/flashing-firmware/nrf52/nrf52-erase) device before continuing to [flash firmware](#flash-firmware).
|
||||
|
||||
:::
|
||||
|
||||
## Connect and Configure Device
|
||||
|
||||
After flashing the Meshtastic firmware to the device, you can proceed with the initial configuration.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/initial-config"}
|
||||
>
|
||||
Connect and Configure Device
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -1,13 +1,13 @@
|
|||
---
|
||||
id: flashing-nrf52-devices
|
||||
title: Flash NRF52 Devices
|
||||
sidebar_label: NRF52 Device
|
||||
title: Flash nRF52 Devices
|
||||
sidebar_label: nRF52 Device
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
## Flashing Methods for NRF52 Devices
|
||||
## Flashing Methods for nRF52 Devices
|
||||
|
||||
The NRF52 based devices have the easiest firmware upgrade process. No driver or software install is required on any platform.
|
||||
The nRF52 based devices have the easiest firmware upgrade process. No driver or software install is required on any platform.
|
||||
|
||||
1. The [drag and drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) firmware installation is considered the "manual process" and recommended as the easiest solution.
|
||||
2. The [Python Flasher](/docs/software/python/flasher) application does a lot under the hood to prevent you from needing to use the terminal. It also allows you to configure your device.
|
||||
1. The [Drag & Drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) firmware installation method is considered the "manual process" and recommended as the easiest solution.
|
||||
2. The [Python Flasher](/docs/software/python/flasher) application does a lot under the hood to prevent you from needing to use the terminal.
|
||||
|
|
|
|||
|
|
@ -1,13 +1,15 @@
|
|||
---
|
||||
id: nrf52-erase
|
||||
title: Flash NRF52 Factory Erase
|
||||
sidebar_label: Factory Erase NRF52
|
||||
title: Flash nRF52 Factory Erase
|
||||
sidebar_label: Factory Erase nRF52
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
Meshtastic uses the [littlefs](https://github.com/littlefs-project/littlefs) library to store configuration, logs, and other data in the internal flash of NRF52 devices. Updating the firmware does _not_ erase this additional data, which can cause issues when the format and location of data changes between releases.
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
To reset the flash storage on your NRF52 board:
|
||||
Meshtastic uses the [littlefs](https://github.com/littlefs-project/littlefs) library to store configuration, logs, and other data in the internal flash of nRF52 devices. Updating the firmware does _not_ erase this additional data, which can cause issues when the format and location of data changes between releases.
|
||||
|
||||
To reset the flash storage on your nRF52 board:
|
||||
|
||||
Download and unzip the latest firmware from [Meshtastic Downloads](https://meshtastic.org/downloads).
|
||||
|
||||
|
|
@ -19,4 +21,13 @@ Download and unzip the latest firmware from [Meshtastic Downloads](https://mesht
|
|||
6. Connect to the device via serial console using the [Meshtastic CLI `--noproto`](/docs/software/python/cli/#--noproto) mode or a standalone serial client like `minicom`.
|
||||
7. Press any key, you should see the message: `Formatting... Done`.
|
||||
|
||||
Once the device has been erased, you can proceed to install the latest Meshtastic firmware on a clean storage filesystem by following the [flash firmware](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop#flash-firmware) steps.
|
||||
Once the device has been erased, you can proceed to install the latest Meshtastic firmware on a clean storage filesystem by clicking the link below.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/nrf52/"}
|
||||
>
|
||||
Flash nRF52 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -5,6 +5,7 @@ sidebar_label: Python Flasher
|
|||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import MFlasher from '../../../software/python-flasher.mdx'
|
||||
import Link from "@docusaurus/Link";
|
||||
import MFlasher from "../../../software/python-flasher.mdx";
|
||||
|
||||
<MFlasher components={props.components} />
|
||||
|
|
@ -6,67 +6,72 @@ slug: /getting-started
|
|||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import Link from '@docusaurus/Link';
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Link from "@docusaurus/Link";
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
## Identify Hardware
|
||||
|
||||
The first order of business in getting started is determining what type of hardware you will be working with. Meshtastic currently supports devices with either of the two Micro-Controller Units (MCU):
|
||||
:::note
|
||||
|
||||
This guide assumes that you have already purchased the devices you will be using with Meshtastic. If you haven't, you can check out our list of [supported hardware](/docs/supported-hardware/)
|
||||
to see your options.
|
||||
:::
|
||||
|
||||
Before you begin, it's important to determine which kind of hardware you're using. Meshtastic works with devices that have either of these two types of Micro-Controller Units (MCU):
|
||||
|
||||
### ESP32
|
||||
|
||||
The ESP32 is older and consumes more power than the nrf52, but is equipped with both WiFi and Bluetooth. Supported ESP32 devices:
|
||||
The ESP32 chip is older and consumes more power than the nRF52 chip, but is equipped with both WiFi and Bluetooth. Supported ESP32 devices:
|
||||
|
||||
- LILYGO® TTGO T-Beam
|
||||
- LILYGO® TTGO Lora
|
||||
- Nano G1
|
||||
- Station G1
|
||||
- Heltec V3 and Wireless Stick Lite V3
|
||||
|
||||
### NRF52
|
||||
### nRF52
|
||||
|
||||
The NRF52 is much more power efficient than the esp32 and easier to update, but is only equipped with Bluetooth. Supported NRF52 devices:
|
||||
The nRF52 chip is much more power efficient than the ESP32 chip and easier to update, but is only equipped with Bluetooth. Supported nRF52 devices:
|
||||
|
||||
- RAK WisBlock
|
||||
- LILYGO® TTGO T-Echo
|
||||
|
||||
:::info
|
||||
|
||||
If your device is not listed above, please review our [supported devices](/docs/supported-hardware) to determine which MCU your device has or contact us in [Discord](https://discord.gg/ktMAKGBnBs) with any questions.
|
||||
|
||||
:::
|
||||
|
||||
## Setup Working Environment
|
||||
:::danger STOP! Put The Power Cable Down!
|
||||
|
||||
Never power on the radio without attaching an antenna! _It_ could damage the radio chip.
|
||||
|
||||
:::danger STOP! Put the power cable down!
|
||||
Never power on the radio without attaching an antenna! _it could damage the radio chip._
|
||||
:::
|
||||
|
||||
Prior to connecting your Meshtastic device to the computer, you should perform the following basic checks.
|
||||
|
||||
### Verify data cable
|
||||
### Verify Data Cable
|
||||
|
||||
Some cables only provide _charging_, verify that your cable is also capable of _transferring data_ before proceeding.
|
||||
Some cables only provide _charging_, verify that your cable is also capable of _transferring data_ before proceeding. To check if your cable can also transfer data, try connecting it to another device (like a phone) and see if you can copy a file to or from it. If the file transfer works, then your cable is also able to transfer data and you can continue.
|
||||
|
||||
There is no definitive way to determine the difference in cables if you aren't willing to pull it apart. Trying out a few cables will be the best way to verify.
|
||||
### Install Serial Drivers
|
||||
|
||||
Once you've located a working data cable, [install the correct serial driver](#install-serial-drivers) and [test for driver installation](#test-driver-installation).
|
||||
|
||||
### Install serial drivers
|
||||
If you don't have serial drivers installed on your computer, please choose one of the options below and install it before continuing.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<div class="split left">
|
||||
<div class="centered">
|
||||
<Link target="_blank"
|
||||
<div className="split-container">
|
||||
<div className="split-item">
|
||||
<Link
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/getting-started/serial-drivers/esp32'}
|
||||
>
|
||||
Install ESP32 Drivers
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="split right">
|
||||
<div class="centered">
|
||||
<Link target="_blank"
|
||||
<div className="split-item">
|
||||
<Link
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/getting-started/serial-drivers/nrf52'}
|
||||
>
|
||||
|
|
@ -76,122 +81,41 @@ Once you've located a working data cable, [install the correct serial driver](#i
|
|||
</div>
|
||||
</div>
|
||||
|
||||
### Test driver installation
|
||||
### Flash Firmware
|
||||
|
||||
You can verify that you have a proper data cable (rather than a charge-only type cable) and that the appropriate drivers for your system are installed by performing the following test:
|
||||
|
||||
<Tabs
|
||||
groupId="operating-system"
|
||||
defaultValue="linux"
|
||||
values={[
|
||||
{label: 'Linux', value: 'linux'},
|
||||
{label: 'macOS', value: 'macos'},
|
||||
{label: 'Windows', value: 'windows'},
|
||||
]}>
|
||||
<TabItem value="linux">
|
||||
|
||||
1. Connect your Meshtastic device to your USB port
|
||||
2. Open a **Terminal** and enter the following command:
|
||||
|
||||
```shell
|
||||
lsusb
|
||||
```
|
||||
3. You should see something like:
|
||||
|
||||
```shell
|
||||
ID xxxx:xxxx Silicon Labs CP210x UART Bridge
|
||||
# or
|
||||
ID xxxx:xxxx QinHeng Electronics USB Single Serial
|
||||
# or
|
||||
FIXME (WISBLOCK OUTPUT)
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="macos">
|
||||
|
||||
1. Navigate to `Apple Menu > About This Mac > System Report... > Hardware > USB`.
|
||||
2. You should see similar to one of the following entries:
|
||||
- `CP210X USB to UART Bridge Controller`
|
||||
- `CH9102 USB to UART Bridge Controller`
|
||||
- `WisCore RAK4631 Board`
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="windows">
|
||||
|
||||
1. Navigate to `Device Manager > Ports (COM & LPT)`
|
||||
2. You should see similar to one of the following entries:
|
||||
- `Silicon Labs CP210X USB to UART Bridge (COM5)`
|
||||
- `Silicon Labs CH9102 USB to UART Bridge (COM5)`
|
||||
- `FIXME (WISBLOCK OUTPUT)`
|
||||
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
:::info
|
||||
If you do not see your device:
|
||||
|
||||
1. You may be using a charging-only cable, [verify your cable](#verify-data-cable).
|
||||
2. You may need to [install the USB serial driver](/docs/getting-started/serial-drivers)).
|
||||
:::
|
||||
|
||||
## Flash Firmware
|
||||
|
||||
:::info
|
||||
If you have a RAK4631-R (the RUI3 bootloader version of the RAK4631), you must [convert the bootloader](/docs/getting-started/flashing-firmware/nrf52/convert-rak4631r) for use with the Arduino before flashing Meshtastic firmware.
|
||||
:::
|
||||
After completing the previous steps, you can now flash the Meshtastic firmware onto your device. To proceed, select the appropriate device type for your device.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<div class="split left">
|
||||
<div class="centered">
|
||||
<Link target="_blank"
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/getting-started/flashing-firmware/esp32/'}
|
||||
<div className="split-container">
|
||||
<div className="split-item">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/esp32/"}
|
||||
>
|
||||
Flash ESP32 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="split right">
|
||||
<div class="centered">
|
||||
<Link target="_blank"
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/getting-started/flashing-firmware/nrf52/'}
|
||||
<div className="split-item">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/nrf52/"}
|
||||
>
|
||||
Flash NRF52 Firmware
|
||||
Flash nRF52 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
### Connect and Configure Device
|
||||
|
||||
## Connect and Configure Device
|
||||
|
||||
After connecting to the device for the first time, you should set the regional settings for the radio as well as other optional settings such as the name of the device.
|
||||
After flashing the Meshtastic firmware onto your device, you can now move on to initial configuration.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link target="_blank"
|
||||
className={'button button--outline button--lg cta--button'}
|
||||
to={'/docs/getting-started/initial-config'}
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/initial-config"}
|
||||
>
|
||||
Connect and Configure Device
|
||||
</Link>
|
||||
</div>
|
||||
|
||||
## Use Meshtastic
|
||||
|
||||
### with Command Line Tools
|
||||
- [Python CLI](/docs/software/python/cli)
|
||||
|
||||
### with mobile apps
|
||||
- [Android](/docs/category/android-app)
|
||||
- [Apple](/docs/category/apple-apps)
|
||||
|
||||
### with a browser
|
||||
- https://client.meshtastic.org
|
||||
- [Meshtastic Web](/docs/software/web-client)
|
||||
|
||||
### over the internet with MQTT
|
||||
- [MQTT](/docs/software/mqtt/)
|
||||
|
||||
There are many ways to interact with and use Meshtastic, please visit the [Software](/docs/software) page for more information.
|
||||
|
|
@ -6,10 +6,10 @@ slug: /getting-started/initial-config
|
|||
sidebar_position: 4
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import LoRaRegions from '../blocks/_lora-regions.mdx';
|
||||
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
import LoRaRegions from "../blocks/_lora-regions.mdx";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
## Supported Clients per Connection Type
|
||||
|
||||
|
|
@ -17,7 +17,7 @@ Depending on your connection, some configuration options are not fully supported
|
|||
|
||||
<Tabs
|
||||
groupId="settings"
|
||||
defaultValue="serial"
|
||||
defaultValue="ble"
|
||||
values={[
|
||||
{label: 'Serial', value: 'serial'},
|
||||
{label: 'Bluetooth', value: 'ble'},
|
||||
|
|
@ -36,7 +36,6 @@ values={[
|
|||
- [Web Client](https://client.meshtastic.org)
|
||||
- [iOS App](/docs/category/apple-apps)
|
||||
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="network">
|
||||
|
||||
|
|
@ -49,7 +48,6 @@ Connecting over network is only supported on ESP32 devices.
|
|||
- [iOS App](/docs/category/apple-apps)
|
||||
- [Python CLI](/docs/software/python/cli/)
|
||||
|
||||
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
|
|
@ -57,7 +55,6 @@ Connecting over network is only supported on ESP32 devices.
|
|||
|
||||
In order to start communicating over the mesh, you must set your region. This setting controls which frequency range your device uses and should be set according to your regional location.
|
||||
|
||||
|
||||
<Tabs
|
||||
groupId="settings"
|
||||
defaultValue="apple"
|
||||
|
|
@ -109,6 +106,15 @@ Configuration of Region, Modem Preset and Hop Limit is available on iOS, iPadOS
|
|||
|
||||
<LoRaRegions />
|
||||
|
||||
## Continue Configuration
|
||||
|
||||
Now that you have set the LoRa region on your device, you can continue with configuring any additional configs to suit your needs.
|
||||
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/settings/"}
|
||||
>
|
||||
Device Configuration
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -5,8 +5,9 @@ sidebar_label: ESP32 Drivers
|
|||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
## Install ESP32 USB to Serial Drivers
|
||||
|
||||
|
|
@ -16,7 +17,7 @@ Some newer boards may require the CH9102 (CH340/CH341) Driver.
|
|||
|
||||
<Tabs
|
||||
groupId="operating-system"
|
||||
defaultValue="linux"
|
||||
defaultValue="windows"
|
||||
values={[
|
||||
{label: 'Linux', value: 'linux'},
|
||||
{label: 'macOS', value: 'macos'},
|
||||
|
|
@ -48,5 +49,22 @@ values={[
|
|||
</Tabs>
|
||||
|
||||
:::important
|
||||
Reboot your computer after you have installed the driver to complete the installation.
|
||||
|
||||
After installing the driver, make sure to reboot your computer to finish the installation process.
|
||||
|
||||
You can also [test your serial driver installation](/docs/getting-started/serial-drivers/test-serial-driver-installation) at this step if required.
|
||||
|
||||
:::
|
||||
|
||||
### Flash Firmware
|
||||
|
||||
After installing the serial drivers, you can now flash the Meshtastic firmware onto your device. To proceed, select the appropriate device type for your device.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/esp32/"}
|
||||
>
|
||||
Flash ESP32 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -1,18 +1,19 @@
|
|||
---
|
||||
id: nrf52
|
||||
title: NRF52 Serial Drivers
|
||||
sidebar_label: NRF52 Drivers
|
||||
title: nRF52 Serial Drivers
|
||||
sidebar_label: nRF52 Drivers
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
import Link from "@docusaurus/Link";
|
||||
|
||||
## Install NRF52 USB to Serial Drivers
|
||||
## Install nRF52 USB to Serial Drivers
|
||||
|
||||
<Tabs
|
||||
groupId="operating-system"
|
||||
defaultValue="linux"
|
||||
defaultValue="windows"
|
||||
values={[
|
||||
{label: 'Linux', value: 'linux'},
|
||||
{label: 'macOS', value: 'macos'},
|
||||
|
|
@ -23,22 +24,16 @@ values={[
|
|||
|
||||
- [CH9102 Driver - Linux Download](http://www.wch-ic.com/downloads/CH341SER_LINUX_ZIP.html)
|
||||
|
||||
:::important
|
||||
Reboot your computer after you have installed the driver to complete the installation.
|
||||
:::
|
||||
|
||||
</TabItem>
|
||||
|
||||
<TabItem value="macos">
|
||||
|
||||
- [CH9102 Driver - macOS Download](https://github.com/WCHSoftGroup/ch34xser_macos)
|
||||
|
||||
:::important
|
||||
Reboot your computer after you have installed the driver to complete the installation.
|
||||
:::
|
||||
|
||||
:::caution
|
||||
|
||||
With the latest versions of MacOS, the USB Serial driver is built-in. Do _NOT_ download the USB device drivers unless required. If you downloaded/installed any already, please remove them.
|
||||
|
||||
:::
|
||||
|
||||
### Remove the CH34x USB Driver (macOS)
|
||||
|
|
@ -58,10 +53,27 @@ Uninstall the kernel extension:
|
|||
|
||||
- [CH9102 Driver - Windows Download](http://www.wch-ic.com/downloads/CH341SER_EXE.html)
|
||||
|
||||
:::important
|
||||
Reboot your computer after you have installed the driver to complete the installation.
|
||||
:::
|
||||
|
||||
</TabItem>
|
||||
|
||||
</Tabs>
|
||||
|
||||
:::important
|
||||
|
||||
After installing the driver, make sure to reboot your computer to finish the installation process.
|
||||
|
||||
You can also [test your serial driver installation](/docs/getting-started/serial-drivers/test-serial-driver-installation) at this step if required.
|
||||
|
||||
:::
|
||||
|
||||
### Flash Firmware
|
||||
|
||||
After installing the serial drivers, you can now flash the Meshtastic firmware onto your device. To proceed, select the appropriate device type for your device.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/nrf52/"}
|
||||
>
|
||||
Flash nRF52 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,99 @@
|
|||
---
|
||||
id: test-serial-driver-installation
|
||||
title: Test Serial Driver Installation
|
||||
sidebar_label: Test Serial Driver Installation
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
import Link from "@docusaurus/Link";
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
### Test Serial Driver Installation
|
||||
|
||||
You can verify that you have a proper data cable (rather than a charge-only type cable) and that the appropriate drivers for your system are installed by performing the following test:
|
||||
|
||||
<Tabs
|
||||
groupId="operating-system"
|
||||
defaultValue="linux"
|
||||
values={[
|
||||
{label: 'Linux', value: 'linux'},
|
||||
{label: 'macOS', value: 'macos'},
|
||||
{label: 'Windows', value: 'windows'},
|
||||
]}>
|
||||
<TabItem value="linux">
|
||||
|
||||
1. Connect your Meshtastic device to your USB port
|
||||
2. Open a **Terminal** and enter the following command:
|
||||
|
||||
```shell
|
||||
lsusb
|
||||
```
|
||||
|
||||
3. You should see something like:
|
||||
|
||||
```shell
|
||||
ID xxxx:xxxx Silicon Labs CP210x UART Bridge
|
||||
# or
|
||||
ID xxxx:xxxx QinHeng Electronics USB Single Serial
|
||||
# or
|
||||
FIXME (WISBLOCK OUTPUT)
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="macos">
|
||||
|
||||
1. Navigate to `Apple Menu > About This Mac > System Report... > Hardware > USB`.
|
||||
2. You should see similar to one of the following entries:
|
||||
|
||||
- `CP210X USB to UART Bridge Controller`
|
||||
- `CH9102 USB to UART Bridge Controller`
|
||||
- `WisCore RAK4631 Board`
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="windows">
|
||||
|
||||
1. Navigate to `Device Manager > Ports (COM & LPT)`
|
||||
2. You should see similar to one of the following entries:
|
||||
|
||||
- `Silicon Labs CP210X USB to UART Bridge (COM5)`
|
||||
- `Silicon Labs CH9102 USB to UART Bridge (COM5)`
|
||||
- `FIXME (WISBLOCK OUTPUT)`
|
||||
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
:::info
|
||||
|
||||
If you are unable to see your device:
|
||||
|
||||
- Make sure that your cable is not only for charging but also for [data transfer](/docs/getting-started/#verify-data-cable).
|
||||
- It's possible that you need to [reinstall the USB serial driver](/docs/getting-started/serial-drivers).
|
||||
|
||||
:::
|
||||
|
||||
## Flash Firmware
|
||||
|
||||
After completing the previous steps, you can now flash the Meshtastic firmware onto your device. To proceed, select the appropriate device type for your device.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
<div className="split-container">
|
||||
<div className="split-item">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/esp32/"}
|
||||
>
|
||||
Flash ESP32 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
|
||||
<div className="split-item">
|
||||
<Link
|
||||
className={"button button--outline button--lg cta--button"}
|
||||
to={"/docs/getting-started/flashing-firmware/nrf52/"}
|
||||
>
|
||||
Flash nRF52 Firmware
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -10,35 +10,32 @@ sidebar_position: 4
|
|||
- [Hackaday's Introduction to Antenna Basics](https://www.youtube.com/playlist?list=PL_tws4AXg7authztKFg5ZN5qWGtq3N_nI)
|
||||
- An excellent series of presentations on the basics of antenna design and function, presented by spacecraft radio engineer Karen Rucker.
|
||||
|
||||
|
||||
### Coverage prediction
|
||||
|
||||
- [Tower Coverage.com](https://www.towercoverage.com)
|
||||
|
||||
- Commercial, but has free options
|
||||
|
||||
|
||||
- [HeyWhat'sThat](http://www.heywhatsthat.com)
|
||||
- Free with path profiling options
|
||||
|
||||
- Free with path profiling options
|
||||
|
||||
- [Radio Mobile Online](https://www.ve2dbe.com/rmonline_s.asp)
|
||||
- Radio Mobile Online is a radio wave propagation prediction tool dedicated to amateur radio
|
||||
|
||||
|
||||
### RF Tools
|
||||
|
||||
- [Times Microwave Systems](https://www.timesmicrowave.com/calculator/?Product=RG-6&RunLength=10&Frequency=868)
|
||||
|
||||
- Coaxial Cable Attenuation & Power Handling Calculator
|
||||
|
||||
|
||||
- [Solwise Link Budget Calculator](https://www.solwise.co.uk/link-budget.htm)
|
||||
- Predict the received signal strength
|
||||
|
||||
- Predict the received signal strength
|
||||
|
||||
- [Amateur Radio Toolkit](https://play.google.com/store/apps/details?id=com.daveyhollenberg.amateurradiotoolkit)
|
||||
- Android app with lots of antenna information
|
||||
|
||||
|
||||
### Antenna designs
|
||||
|
||||
- [1/4 Wave Ground Plane Antenna Calculator](https://m0ukd.com/calculators/quarter-wave-ground-plane-antenna-calculator)
|
||||
|
|
|
|||
|
|
@ -32,7 +32,6 @@ While the LoRa devices we are using for Meshtastic are relatively low power radi
|
|||
|
||||
The information collected here is by no means definitive, and necessarily abbreviated (it's a huge topic).
|
||||
|
||||
|
||||
## Range Testing
|
||||
|
||||
As mentioned, while stating the obvious, the simplest way of performing a test is:
|
||||
|
|
@ -63,7 +62,6 @@ One of the first things to ensure, is that the antenna you have is tuned to the
|
|||
|
||||
Andreas Spiess also gives a great explanation of [how to use Vector Network Analyzers](https://www.youtube.com/watch?v=ZpKoLvqOWyc) to correctly tune your antennas, as well as a more [in depth tutorial of how to use VNAs](https://www.youtube.com/watch?v=_pjcEKQY_Tk). It is important to remember however, that VNAs can only tell you if the antenna is well-matched, not how well it is transmitting. A 50 ohm resistor across the transmitter output would show as ideally matched, but it would be useless at transmitting a signal. There are a number of VNAs now available for less than $100, making this no longer out of reach for most hobbyists, unlike expensive spectrum analyzers.
|
||||
|
||||
|
||||
## Non-aerial Factors Affecting Transmission
|
||||
|
||||
Unless you're using your devices in a vacuum, with clear line of sight between aerials the following will have an effect:
|
||||
|
|
@ -87,11 +85,8 @@ For a bit of light reading on environmental research:
|
|||
|
||||
In summary - wavelengths in Europe fair well in plain sight, curve over not-so-tall obstacles (including trees), and they reflect off surfaces at low angles of incidence. They go through humans without much attenuation; but not brick, stone, or anything with more attenuation than glass / Kevlar. Oh, and don’t sit under an LTE tower and expect it to be plain sailing. RF emissions at adjacent frequencies can interfere at a high enough power.
|
||||
|
||||
|
||||
## Discussion
|
||||
|
||||
To comment on / join in antenna range [Meshtastic discourse](https://meshtastic.discourse.group/t/antenna-improved-range/227/35?u=sens8tion)
|
||||
|
||||
There, you will also find reference to Meshtastic range achievements and aerial recommendations. (Note we've stopped short of making specific supplier aerial recommendations in this wiki.)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ sidebar_label: Enclosures
|
|||
sidebar_position: 3
|
||||
---
|
||||
|
||||
import Tropho from '/img/enclosures/3dp-tropho-heltec32.png';
|
||||
import Tropho from "/img/enclosures/3dp-tropho-heltec32.png";
|
||||
|
||||
## Created by tropho/TonyG
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ sidebar_label: HELTEC® Lora 32
|
|||
sidebar_position: 7
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
<Tabs
|
||||
groupId="heltec"
|
||||
|
|
@ -36,12 +36,14 @@ Not recommended! Very old board with design issues. Support is being phased out.
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- User and Reset switches
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-heltec-v1-X.X.X.xxxxxxx.bin`
|
||||
|
||||
</TabItem>
|
||||
|
|
@ -62,12 +64,14 @@ Not recommended because of design issues! Support is being phased out. Use V3 in
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- User and Reset switches
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-heltec-v2.0-X.X.X.xxxxxxx.bin`
|
||||
|
||||
</TabItem>
|
||||
|
|
@ -89,12 +93,14 @@ Not recommended because of design issues! Support is being phased out. Use V3 in
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- User and Reset switches
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-heltec-v2.1-X.X.X.xxxxxxx.bin`
|
||||
|
||||
</TabItem>
|
||||
|
|
@ -111,12 +117,14 @@ Not recommended because of design issues! Support is being phased out. Use V3 in
|
|||
- USB-C
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- User and Reset switches
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-heltec-v3-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/1005004823000595.html)
|
||||
|
||||
|
|
@ -135,12 +143,14 @@ Not recommended because of design issues! Support is being phased out. Use V3 in
|
|||
- USB-C
|
||||
- Antenna: IPEX/u.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- no display
|
||||
- User and Reset switches
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-heltec-wsl-v3-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/1005004839521502.html)
|
||||
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ sidebar_label: Enclosures
|
|||
sidebar_position: 3
|
||||
---
|
||||
|
||||
import Tropho from '/img/enclosures/3dp-tropho-lora32.png';
|
||||
import Tropho from "/img/enclosures/3dp-tropho-lora32.png";
|
||||
|
||||
## Created by tropho/TonyG
|
||||
|
||||
|
|
|
|||
|
|
@ -11,4 +11,8 @@ For the Lora V2.1-1.6 and V2.1-1.8, Shorting IO12 to ground will progress throug
|
|||
|
||||
<img src="/img/hardware/lora32-v2-1.6-button.jpg" width="400" align="left" />
|
||||
|
||||
<img src="/img/hardware/lora32-v2-1.6-button-example.jpg" width="400" align="left"/>
|
||||
<img
|
||||
src="/img/hardware/lora32-v2-1.6-button-example.jpg"
|
||||
width="400"
|
||||
align="left"
|
||||
/>
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ sidebar_label: LILYGO® Lora
|
|||
sidebar_position: 6
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
Further information on the LILYGO® LoRa devices can be found on LILYGO®'s [GitHub page](https://github.com/Xinyuan-LilyGO/LilyGo-LoRa-Series).
|
||||
|
||||
|
|
@ -42,13 +42,15 @@ This board is still in production but for various reasons not recommended for ne
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tlora-v1-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/32840238513.html)
|
||||
|
||||
- US Distributor - Purchase link: [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)
|
||||
|
||||
|
||||
|
||||
|
|
@ -74,12 +76,15 @@ This board is still in production but for various reasons not recommended for ne
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tlora_v1_3-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/4000628100802.html)
|
||||
- US Distributor - Purchase link: [Rokland](https://store.rokland.com/products/lilygo-lora-v1-3-esp32-sx1276-915mhz-wifi-wireless-bluetooth-module-0-96-inch-oled-screen-support-arduino-development-board-q312?ref=8Bb2mUO5i-jKwt)
|
||||
|
||||
|
||||
|
||||
|
|
@ -107,13 +112,15 @@ This board is still in production but for various reasons not recommended for ne
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- Power and Reset switches
|
||||
- microSD connector
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tlora-v2-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/32846302183.html)
|
||||
|
||||
|
|
@ -122,7 +129,6 @@ This board is still in production but for various reasons not recommended for ne
|
|||
</TabItem>
|
||||
<TabItem value="v2.1">
|
||||
|
||||
|
||||
:::caution
|
||||
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.
|
||||
:::
|
||||
|
|
@ -139,16 +145,18 @@ Early versions of some of these boards contained the wrong component in the LiPo
|
|||
- Micro USB
|
||||
- Antenna: SMA antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- Power and Reset switches
|
||||
- microSD connector
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tlora-v2-1-1.6-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/32915894264.html)
|
||||
|
||||
- US Distributor - Purchase link: [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)
|
||||
|
||||
|
||||
|
||||
|
|
@ -166,18 +174,20 @@ Early versions of some of these boards contained the wrong component in the LiPo
|
|||
- USB-C
|
||||
- Antenna: SMA antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- Power and Reset switches
|
||||
- microSD connector
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tlora-v2-1-1.8-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [Banggood](https://www.banggood.com/LILYGO-LORA-H570-V1_8-SX1280-ESP32-2_4G-Smart-WiFi-bluetooth-Wireless-Module-0_96inch-OLED-Display-Development-Board-with-Antenna-Type-C-p-1969395.html)
|
||||
|
||||
|
||||
|
||||
|
||||
</TabItem>
|
||||
|
||||
<TabItem value="S3-v1">
|
||||
|
|
@ -196,17 +206,20 @@ Early versions of some of these boards contained the wrong component in the LiPo
|
|||
- USB-C
|
||||
- Antenna: SMA antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Built in 0.96 inch OLED display
|
||||
- Power and Reset switches, Boot / User Button
|
||||
- microSD connector
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tlora-t3s3-v1.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/1005004627139838.html)
|
||||
|
||||
|
||||
|
||||
</TabItem>
|
||||
|
||||
</Tabs>
|
||||
|
|
|
|||
|
|
@ -36,7 +36,6 @@ The Nano G1 is the first dedicated hardware device to be designed from scratch p
|
|||
- Firmware file: `firmware-nano-g1-1.x.x.bin`
|
||||
- [Purchase link](https://www.tindie.com/products/neilhao/meshtastic-mesh-device-nano-edition/)
|
||||
|
||||
|
||||
Further information on the Nano G1 can be found on [Unit Engineering's Wiki](https://uniteng.com/wiki/doku.php?id=meshtastic:nano).
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ sidebar_label: Base Boards
|
|||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
## WisBlock Base
|
||||
|
||||
|
|
@ -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"
|
||||
style={{ zoom: '50%' }}
|
||||
style={{ zoom: "50%" }}
|
||||
/>
|
||||
|
||||
</TabItem>
|
||||
|
|
@ -77,10 +77,8 @@ Further information on the RAK5005-O can be found on the [RAK Documentation Cent
|
|||
- **Screen Support**
|
||||
- OLED screen support (OLED screen sold separately)
|
||||
|
||||
|
||||
Further information on the RAK19007 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK19007/Overview/#product-description).
|
||||
|
||||
|
||||
</TabItem>
|
||||
|
||||
<TabItem value="RAK19003">
|
||||
|
|
@ -103,13 +101,12 @@ Further information on the RAK19007 can be found on the [RAK Documentation Cente
|
|||
- **Screen Support**
|
||||
- OLED screen support (OLED screen sold separately)
|
||||
|
||||
|
||||
Further information on the RAK19003 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK19003/Overview/#product-description)
|
||||
|
||||
<img
|
||||
alt="RAK4631 19003"
|
||||
src="/img/hardware/rak4631_19003.png"
|
||||
style={{ zoom: '50%' }}
|
||||
style={{ zoom: "50%" }}
|
||||
/>
|
||||
|
||||
</TabItem>
|
||||
|
|
@ -136,7 +133,6 @@ Further information on the RAK19003 can be found on the [RAK Documentation Cente
|
|||
- **Screen Support**
|
||||
- OLED screen support (OLED screen sold separately)
|
||||
|
||||
|
||||
Further information on the RAK19001 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK19001/Overview/#product-description).
|
||||
|
||||
</TabItem>
|
||||
|
|
|
|||
|
|
@ -20,11 +20,11 @@ Button functionality for RAK devices greatly depends on the device specific conf
|
|||
### RAK19001
|
||||
|
||||
- **Program button**
|
||||
|
||||
- _**Single press**_ changes the page of information displayed on the screen.
|
||||
- _**Double press (nRF52 only)**_ puts the device in bootloader mode and mounts a drive to your computer.
|
||||
- _**Long press**_ signals the device to shutdown.
|
||||
- _**Triple press**_ sends a broadcast message of the device position.
|
||||
|
||||
|
||||
- **User Button**
|
||||
- _Not yet implemented by Meshtastic_
|
||||
|
|
@ -5,8 +5,8 @@ sidebar_label: Core Modules
|
|||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
## WisBlock Core
|
||||
|
||||
|
|
@ -52,13 +52,12 @@ Further information on the RAK4631 can be found on the [RAK Documentation Center
|
|||
<img
|
||||
alt="RAK4631 Core Module"
|
||||
src="/img/hardware/rak4631.png"
|
||||
style={{ zoom: '50%' }}
|
||||
style={{ zoom: "50%" }}
|
||||
/>
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="RAK11200">
|
||||
|
||||
|
||||
### RAK11200 / RAK13300
|
||||
|
||||
:::caution Note
|
||||
|
|
@ -93,13 +92,12 @@ Further information on the RAK11200 can be found on the [RAK Documentation Cente
|
|||
- **Connectors**
|
||||
- U.FL antenna
|
||||
|
||||
|
||||
Further information on the RAK13300 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK13300/Overview/#product-description).
|
||||
|
||||
<img
|
||||
alt="RAK4631 5005 11200"
|
||||
src="/img/hardware/rak11200.jpg"
|
||||
style={{ zoom: '50%' }}
|
||||
style={{ zoom: "50%" }}
|
||||
/>
|
||||
|
||||
</TabItem>
|
||||
|
|
|
|||
|
|
@ -13,7 +13,6 @@ Download from [Printables](https://www.printables.com/model/297089-meshtastic-so
|
|||
|
||||
|
||||
|
||||
|
||||
## Created by tropho/TonyG
|
||||
|
||||
### RAK5005 Case
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ sidebar_label: RAK WisBlock
|
|||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
<!-- RAK LOGO here? -->
|
||||
|
||||
|
|
@ -23,4 +23,5 @@ Please see the RAK documentation for the correct way to connect your hardware to
|
|||
## Resources
|
||||
|
||||
- RAK's Wisblock [Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock)
|
||||
- [American Distributor - Rokland - Purchase Link](https://store.rokland.com/products/rak-wireless-wisblock-meshtastic-starter-kit?ref=8Bb2mUO5i-jKwt)
|
||||
- RAK's [GitHub Page](https://github.com/RAKWireless/WisBlock) for the WisBlock
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ sidebar_label: Peripherals
|
|||
sidebar_position: 3
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
<Tabs
|
||||
groupId="rakmodules"
|
||||
|
|
@ -24,7 +24,6 @@ To add a GPS to the RAK5005-O base board, you need the [RAK1910 GPS sensor](http
|
|||
- uBlox MAX-7Q GPS module
|
||||
- GPS and GLONASS satellite support
|
||||
|
||||
|
||||
Further information on the RAK1910 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1910/Overview/#product-description).
|
||||
|
||||
To add a GPS to the RAK19003 base board, you need the [RAK12500 GPS sensor](https://store.rakwireless.com/products/wisblock-gnss-location-module-rak12500). It is supported via I<sup>2</sup>C on slot B for firmware versions 1.49 and above.
|
||||
|
|
@ -32,7 +31,6 @@ To add a GPS to the RAK19003 base board, you need the [RAK12500 GPS sensor](http
|
|||
- uBlox Zoe-M8Q GNSS receiver
|
||||
- GPS, GLONASS, QZSS and BeiDou satellite support
|
||||
|
||||
|
||||
Further information on the RAK12500 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK12500/Overview/#product-description).
|
||||
|
||||
</TabItem>
|
||||
|
|
@ -54,7 +52,6 @@ The [RAK13002 IO Module](https://store.rakwireless.com/collections/wisblock-inte
|
|||
- 2x ADC interfaces
|
||||
- 3.3v Power rails
|
||||
|
||||
|
||||
There is development activity in progress to get sensors such as this added to the Meshtastic Core.
|
||||
Further information on the RAK13002 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK13002/Overview).
|
||||
|
||||
|
|
|
|||
|
|
@ -5,8 +5,8 @@ sidebar_label: Screens
|
|||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
There are currently two different screens supported by the RAK WisBlock system:
|
||||
|
||||
|
|
@ -25,7 +25,6 @@ The [RAK1921 OLED display](https://store.rakwireless.com/products/rak1921-oled-d
|
|||
- Resolution 128 x 64 pixels
|
||||
- I<sup>2</sup>C interface
|
||||
|
||||
|
||||
This item requires soldering.
|
||||
Further information on the RAK1921 can be found on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK1921/Overview/#product-description).
|
||||
Similar modules are widely available from other suppliers, but do check the boards as some have the VDD and GND pins swapped round. This will prevent directly soldering the display to the baseboard. The preferred order is VDD, GND, SCL, SDA.
|
||||
|
|
@ -43,13 +42,12 @@ The [RAK1400 EPD module](https://store.rakwireless.com/products/wisblock-epd-mod
|
|||
- Resolution 212 x 104 pixels
|
||||
- Occupies the IO Port of a Wisblock Base
|
||||
|
||||
|
||||
- Firmware for 5005 with RAK14000 e-paper: [`firmware-rak4631_eink-1.3.x.uf2`](/downloads)
|
||||
|
||||
<img
|
||||
alt="RAK4631 5005 14000"
|
||||
src="/img/hardware/rak4631_5005_epaper.jpg"
|
||||
style={{ zoom: '50%' }}
|
||||
style={{ zoom: "50%" }}
|
||||
/>
|
||||
|
||||
Please note only the white-black display is supported at this time, the white-black-red display may work, but is not supported.
|
||||
|
|
|
|||
|
|
@ -17,7 +17,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" />
|
||||
|
||||
<!--  -->
|
||||
|
|
|
|||
|
|
@ -5,14 +5,13 @@ sidebar_label: LILYGO® T-Beam
|
|||
sidebar_position: 5
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
All T-beam models have an 18650 size battery holder on the rear of the device. This is designed to the original specification of the 18650 and only fits unprotected flat top 18650 cells. Button top and protected cells are typically longer than 65mm, often approaching 70mm.
|
||||
|
||||
Further information on the LILYGO® T-Beam devices can be found on LILYGO®'s [GitHub page](https://github.com/Xinyuan-LilyGO/LilyGo-LoRa-Series).
|
||||
|
||||
|
||||
<Tabs
|
||||
groupId="t-beam"
|
||||
defaultValue="sx1262"
|
||||
|
|
@ -29,7 +28,6 @@ values={[
|
|||
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.
|
||||
:::
|
||||
|
||||
|
||||
- **MCU**
|
||||
- ESP32 (WiFi & Bluetooth)
|
||||
- **LoRa Transceiver**
|
||||
|
|
@ -44,17 +42,18 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
|
|||
- Micro USB
|
||||
- Antenna: SMA antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Meshtastic preinstalled
|
||||
- Power, Program and Reset switches
|
||||
- Screen sold separately
|
||||
- No GPS
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tbeam0.7-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/4000469332610.html)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -76,14 +75,17 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
|
|||
- Micro USB
|
||||
- Antenna: SMA antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Meshtastic preinstalled
|
||||
- Power, Program and Reset switches
|
||||
- **Comes with 0.96 inch OLED display** (soldering required to assemble)
|
||||
|
||||
**Resources**
|
||||
## 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](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)
|
||||
|
||||
|
||||
|
||||
|
|
@ -107,22 +109,23 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Meshtastic preinstalled
|
||||
- Power, Program and Reset switches
|
||||
- Screen sold separately
|
||||
|
||||
**Resources**
|
||||
## Resources
|
||||
|
||||
- Firmware file: `firmware-tbeam-X.X.X.xxxxxxx.bin`
|
||||
- Purchase link: [AliExpress](https://www.aliexpress.com/item/33047631119.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)
|
||||
|
||||
|
||||
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="sx1262">
|
||||
|
||||
|
||||
- **MCU**
|
||||
- ESP32 (WiFi & Bluetooth)
|
||||
- **LoRa Transceiver**
|
||||
|
|
@ -138,18 +141,19 @@ This is an earlier version of the T-Beam board. Due to changes in the design thi
|
|||
- Micro USB
|
||||
- Antenna: U.FL antenna connector
|
||||
|
||||
**Features**
|
||||
## Features
|
||||
|
||||
- Meshtastic preinstalled
|
||||
- Power, Program and Reset switches
|
||||
- Screen sold separately
|
||||
|
||||
**Resources**
|
||||
## 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)
|
||||
|
||||
|
||||
|
||||
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
|
|
|||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue