Merge branch 'master' into patch-1

This commit is contained in:
pdxlocations 2024-05-15 10:40:05 -07:00 committed by GitHub
commit 21f0bee2c5
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
13 changed files with 106 additions and 43 deletions

View file

@ -25,6 +25,14 @@ export const Faq = {
title: "Can I update my node's firmware over the mesh?",
content: `No, Meshtastic does not support OTA updates over LoRa. Please visit [Flash Firmware](/docs/getting-started/flashing-firmware/) for update options.`,
},
{
title: "Which version of firmware should I use?",
content: `Currently, there are two types of Meshtastic firmware releases, "Alpha" and "Beta". Firmware releases are labeled with the version number, commit hash and the type. Installing the latest beta release recommended for most cases. Alpha release are geared towards users interested in testing the new features, fixes or enhancements with the understanding there are additional risks and potential for instability compared to running a beta release.`,
},
{
title: "How often should I update firmware?",
content: `Firmware should be kept up to date. While it is not necessary to update whenever a new release comes out it's a good idea to follow the Discord Server and Forums linked in the [Introduction](/docs/introduction/#contributors) where developers may advise the community about important updates. The Meshtastic [firmware releases page](https://github.com/meshtastic/firmware/releases) on Github has a summary of what has changed in each release.`,
},
],
"android": [
{

View file

@ -64,6 +64,7 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
- [Antelope Valley Mesh](https://www.avmesh.org/)
- [AltaMesh](https://altamesh.net/)
- [Central Valley](https://centralvalleymesh.net/)
- [Sac Valley Mesh](http://www.sacvalleymesh.com)
### Colorado
- [Denver Mesh](https://denvermesh.org)
@ -111,3 +112,9 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
## The Netherlands
- [Meshtastic Netherlands](https://t.me/meshtastic_nl)
## Taiwan
- [Meshtastic Taiwan Community 臺灣鏈網 - Facebook](https://www.facebook.com/groups/413628121046386)
- [Meshtastic Taiwan Community 臺灣鏈網 - Discord](https://discord.gg/2vZkuckp8E)

View file

@ -29,7 +29,7 @@ The range test module config options are: Enabled, Sender, and Save. Range Test
### Enabled
Enables the range test module. **Both Sender and Receiver must have the module enabled. ** On the Apple and Android apps to receive any range test messages the module must be enabled. The device screen may continue to show range test packets from older firmware versions even if the module is disabled.
Enables the range test module. **Both Sender and Receiver must have the module enabled.** On the Apple and Android apps to receive any range test messages the module must be enabled. The device screen may continue to show range test packets from older firmware versions even if the module is disabled.
### Sender Interval

View file

@ -8,26 +8,24 @@ description: GPS position configuration settings for your Meshtastic device incl
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, Smart Broadcast Minimum Distance, Smart Broadcast Minimum Interval, Broadcast Interval, Position Packet Flags, and GPS RX/TX Pins. Position config uses an admin message sending a `Config.Position` protobuf.
Position data from GPS is provided by either the radio or your paired phone. It is not required to use Meshtastic, but time calculations require at least one device on the mesh to have either a GPS, RTC, or internet connection for NTP.
Position data from GPS is provided by either the radio or your paired phone. Position data is not required to use Meshtastic but time calculations require at least one device on the mesh have either a GPS or internet connection for time.
The position config uses an admin message to send a `Config.Position` protobuf. The position config options are: GPS Mode, GPS Update Interval, Fixed Position, Smart Broadcast, Smart Broadcast Minimum Distance, Smart Broadcast Minimum Interval, Broadcast Interval, Position Packet Flags, and GPS RX/TX Pins.
## Position Config Values
### GPS Enabled
### GPS Mode
Acceptable values: `true` or `false`
Configures whether the GPS functionality is enabled, disabled, or not present on the node.
Defaults to true. Enables GPS on the node.
Acceptable values: `Disabled`, `Enabled`, and `Not_Present`.
Generally, depending on the device and its configuration, this value will default to either `Enabled` or `Not Present`.
### GPS Update Interval
How often we should try to get GPS position (in seconds), or zero for the default of once every 2 minutes, or a very large value (maxint) to update only once at boot.
### GPS Attempt Time
How long should we try to get our position during each GPS update interval attempt? (in seconds) Or if zero, use the default of 15 minutes.
### Fixed Position
Acceptable values: `true` or `false`
@ -64,9 +62,9 @@ The minimum number of seconds (since the last send) before we can send a positio
Default of `0` is 15 minutes
If smart broadcast is off we should send our position this often (but only if it has changed significantly)
If smart broadcast is off we should send our position this often.
The GPS updates will be sent out every Broadcast Interval, with either the actual GPS location, or an empty location if no GPS fix was achieved.
The GPS updates will be sent out every broadcast interval, either with the actual GPS location or an empty location if no GPS fix was achieved.
### Position Flags
@ -136,9 +134,8 @@ 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_mode | `enabled`, `disabled`, `not_present` | `Enabled` or `Not Present` |
| position.gps_update_interval | `integer` (seconds) | Default `0` is 2 Minutes |
| position.gps_attempt_time | `integer` (seconds) | Default of `0` is 15 Minutes |
| position.fixed_position | `true`, `false` | `false` |
| position.position_broadcast_smart_enabled | `true`, `false` | `true` |
| position.broadcast_smart_minimum_distance | `integer` (meters) | Default of `0` is 100 Meters |
@ -163,11 +160,6 @@ meshtastic --set position.gps_update_interval 0
meshtastic --set position.gps_update_interval 45
```
```shell title="Set GPS attempt time (Default of 0 is 30 seconds)"
meshtastic --set position.gps_attempt_time 0
meshtastic --set position.gps_attempt_time 45
```
```shell title="Set Fixed Position - Current Location"
meshtastic --set position.fixed_position true
```
@ -214,7 +206,3 @@ All position config options are available in the Web UI.
</TabItem>
</Tabs>
:::caution
Altering/disabling the GPS functionality does not mean that you will be unable to be found. Via triangulation of your radio, location may be given up to someone if they are determined enough.
:::

View file

@ -14,12 +14,19 @@ If you'd like to contribute information for your country, click the "Edit this p
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Albania | EU_868<br />EU_433 | |
| Australia | ANZ | |
| Austria | EU_868<br />EU_433 | |
### B
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Belgium | EU_868<br />EU_433 | |
| Bosnia-Herzegowina | EU_868<br />EU_433 | |
| Brazil | ANZ | https://www.gov.br/anatel/pt-br/regulado/radiofrequencia/radiacao-restrita |
| Bulgaria | EU_868<br />EU_433 | |
### C
@ -27,38 +34,48 @@ If you'd like to contribute information for your country, click the "Edit this p
| --- | --- | --- |
| Canada | US | |
| China | CN | |
| Cyprus | EU_868<br />EU_433 | |
| Czech Republic | EU_868<br />EU_433 | |
### D
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Denmark | EU_868<br />EU_433 | |
### E
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Estonia | EU_868<br />EU_433 | |
### F
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| France | EU_868<br />EU_433 | |
| Finland | EU_868<br />EU_433 | |
### G
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Germany | EU_868<br />EU_433 | |
| Greece | EU_868<br />EU_433 | |
### H
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Hungary | EU_868<br />EU_433 | |
### I
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| India | IN | |
| Ireland | EU_868<br />EU_433 | |
| Italy | EU_868<br />EU_433 | |
### J
@ -71,23 +88,31 @@ If you'd like to contribute information for your country, click the "Edit this p
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Korea | KR | |
| Kroatia | EU_868<br />EU_433 | |
### L
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Latvia | EU_868<br />EU_433 | |
| Lithauania | EU_868<br />EU_433 | |
| Luxembourg | EU_868<br />EU_433 | |
### M
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Malaysia | MY_919<br />MY_433 | |
| Montenegro | EU_868<br />EU_433 | |
### N
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Netherlands | EU_868<br />EU_433 | |
| New Zealand | ANZ<br />NZ_865 | |
| North Macedonia | EU_868<br />EU_433 | |
| Norway | EU_868<br />EU_433 | |
### O
@ -98,6 +123,8 @@ If you'd like to contribute information for your country, click the "Edit this p
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Poland | EU_868<br />EU_433 | |
| Portugal | EU_868<br />EU_433 | |
### Q
@ -108,13 +135,20 @@ If you'd like to contribute information for your country, click the "Edit this p
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Romania | EU_868<br />EU_433 | |
| Russia | RU | |
### S
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Serbia | EU_868<br />EU_433 | |
| Singapore | SG_923 | |
| Slowakia | EU_868<br />EU_433 | |
| Slowenia | EU_868<br />EU_433 | |
| Spain | EU_868<br />EU_433 | |
| Sweden | EU_868<br />EU_433 | |
| Switzerland | EU_868<br />EU_433 | |
### T
@ -135,6 +169,7 @@ If you'd like to contribute information for your country, click the "Edit this p
| Country | LoRa Region | Regulatory document |
| --- | --- | --- |
| Vatican City | EU_868<br />EU_433 | |
### Y

View file

@ -120,6 +120,8 @@ Configuration of Region, Modem Preset and Hop Limit is available on iOS, iPadOS
<LoRaRegions />
Refer to [LoRa Region by Country](/docs/configuration/region-by-country) for a more comprehensive list.
## 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.

View file

@ -24,22 +24,23 @@ Antenna designs, tools, and coverage simulators.
These antennas have garnered positive feedback and frequent recommendations within our community. However, we encourage you to conduct your own research to ensure the best choice for your needs. We are not responsible for individual experiences or results.
### Compact / Handheld
| Frequency | Model | Purchase Links |
| :--: | :--: | :--: |
| 915 or 868 | GIZONT 17cm | [AliExpress](https://www.aliexpress.us/item/3256804421300249.html) |
| 915 or 868 | GIZONT 20cm | [AliExpress](https://www.aliexpress.us/item/3256804397374144.html) |
| 915 | LINX ANT-916-CW-HW-SMA | [Mouser](https://www.mouser.com/ProductDetail/TE-Connectivity-Linx-Technologies/ANT-916-CW-HW-SMA?qs=PKuFCuYbGOfeZQiEfd4fWA%3D%3D) [DigiKey](https://www.digikey.com/en/products/detail/te-connectivity-linx/ANT-916-CW-HW-SMA/2694126) |
| 915 | ZIISOR TX915-JKS-20 | [AliExpress](https://www.aliexpress.us/item/3256801688016561.html) |
| 915 | CDEBYTE TX915-JKD-20 (5-pack)| [AliExpress](https://www.aliexpress.us/item/3256803106771365.html) |
| Frequency | Model | Purchase Links |
|:----------:|:-----------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
| 915 or 868 | GIZONT 17cm | [AliExpress](https://www.aliexpress.us/item/3256804421300249.html) |
| 915 | LINX ANT-916-CW-HW-SMA | [Mouser](https://www.mouser.com/ProductDetail/TE-Connectivity-Linx-Technologies/ANT-916-CW-HW-SMA?qs=PKuFCuYbGOfeZQiEfd4fWA%3D%3D) [DigiKey](https://www.digikey.com/en/products/detail/te-connectivity-linx/ANT-916-CW-HW-SMA/2694126) |
| 915 | ZIISOR TX915-JKS-20 | [AliExpress](https://www.aliexpress.us/item/3256801688016561.html) |
| 915 | CDEBYTE TX915-JKD-20 (5-pack) | [AliExpress](https://www.aliexpress.us/item/3256803106771365.html) |
| 915 | Rabbit Labs / ZIISOR | [Amazon US](https://www.amazon.com/gp/product/B0D19JJBKZ) |
| 433 | Rabbit Labs / ZIISOR | [Amazon US](https://www.amazon.com/dp/B0D1MSPVQ5) |
### Base Station / Repeater
| Frequency | Model | Purchase Links |
| :--: | :--: | :--: |
| 915 | Alfa AOA-915-5ACM | [Rokland](https://store.rokland.com/products/alfa-aoa-915-5acm-5-dbi-omni-outdoor-915mhz-802-11ah-mini-antenna-for-lora-halow-application) |
| 915 | Rokland 32" 5.8 dBi | [Rokland](https://store.rokland.com/collections/802-11ah-wi-fi-halow/products/5-8-dbi-n-male-omni-outdoor-915-mhz-antenna-large-profile-32-height-for-helium-rak-miner-2-nebra-indoor-bobcat) |
| Frequency | Model | Purchase Links |
|:---------:|:-------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
| 915 | Alfa AOA-915-5ACM | [Rokland](https://store.rokland.com/products/alfa-aoa-915-5acm-5-dbi-omni-outdoor-915mhz-802-11ah-mini-antenna-for-lora-halow-application) |
| 915 | Rokland 32" 5.8 dBi | [Rokland](https://store.rokland.com/collections/802-11ah-wi-fi-halow/products/5-8-dbi-n-male-omni-outdoor-915-mhz-antenna-large-profile-32-height-for-helium-rak-miner-2-nebra-indoor-bobcat) |
### Automotive
| Frequency | Model | Purchase Links |
| :--: | :--: | :--: |
| 915 | Laird MA9-5N | [DigiKey](https://www.digikey.com/en/products/detail/te-connectivity-laird/MA9-5N/3486940) |
| 915 | Taoglas TI.16.5F11 | [DigiKey](https://www.digikey.com/en/products/detail/taoglas-limited/TI-16-5F11/3724558) |
| Frequency | Model | Purchase Links |
|:---------:|:------------------:|:------------------------------------------------------------------------------------------:|
| 915 | Laird MA9-5N | [DigiKey](https://www.digikey.com/en/products/detail/te-connectivity-laird/MA9-5N/3486940) |
| 915 | Taoglas TI.16.5F11 | [DigiKey](https://www.digikey.com/en/products/detail/taoglas-limited/TI-16-5F11/3724558) |

View file

@ -29,3 +29,4 @@ Please see the RAK documentation for the correct way to connect your hardware to
- China RAK Direct [RAK Wireless Starter Kit w/ Gen2 Base board](https://store.rakwireless.com/products/wisblock-meshtastic-starter-kit)
- US Distributor Rokland [RAK Wireless Starter Kit w/ Gen2 Base board](https://store.rokland.com/products/rak-wireless-wisblock-meshtastic-starter-kit)
- US Distributor Rokland [RAK Wireless Starter Kit w/ Gen1 Base board](https://store.rokland.com/products/rakwireless-meshtastic-starter-kit-alternative-with-rak5005-o-base)
- UK/EU Distributor ConnectedThings [RAK Wireless Starter Kit w/ Gen2 Base board](https://connectedthings.store/gb/meshtastic/rak-wisblock-meshtastic-starter-kit.html)

View file

@ -31,9 +31,19 @@ The T-Deck is a compact device featuring a 2.8-inch IPS LCD touch screen with a
## Keyboard Shortcuts
| Shortcut | Function |
|-------------|-----------------------------------|
| `alt` + `b` | Toggle keyboard backlight on/off. |
| Shortcut | Function |
|-------------------|-----------------------------------------------------|
| `alt` & `b` | Toggle keyboard backlight on/off. |
| `alt` & `c` | Toggle modifier function. `Fn` displayed on screen. |
| `alt` & `c` + `m` | Disable/Enable notifications. |
| `alt` & `c` + `q` | Quit/Cancel (message, canned message, etc.) |
| `alt` & `c` + `t` | Tab Key (select channel/dm recipient) |
| `alt` & `c` + `i` | Decrease screen brightness. |
| `alt` & `c` + `o` | Increase screen brightness. |
| `alt` & `c` + `g` | Toggle GPS. |
| `alt` & `c` + `⎵` | Send network ping. |
As of firmware version 2.3.9, there is a newly added modifier function key combo which allows additional shortcuts to be added. To enable the function key, you will press `alt` and `c` together; a small `Fn` will be displayed in the lower right of the screen. After the function key is enabled, you can press the key for the function you wish to execute. For example, to disable/enable notifications, you would press `alt` and `c` followed by `m`.
## Flashing

View file

@ -8,7 +8,6 @@ sidebar_position: 1
## Functionality
- **Capacitive Touch Button (Top):**<br />
*If "Wake on Tap or Motion" setting enabled:*
- **Touch:**
- Update the display
- *(at screensaver)* Wake the display.

View file

@ -16,7 +16,7 @@ Please ensure the inclusion of the following statement in your support documenta
> Meshtastic® is a registered trademark of Meshtastic LLC. Meshtastic software components are released under various licenses, see GitHub for details. No warranty is provided - use at your own risk.
Alternatively, if you prefer, you can use our community project logos, "M-Powered" and "M-PWRD", which are specifically designed for projects that utilize Meshtastic technology. These logos offer a straightforward way to show compatibility with our platform without needing a trademark grant. For more information on these logos, including usage guidelines and design files, please refer to [Community Project Logos: M-Powered & M-PWRD](/docs/legal/licensing-and-trademark#community-project-logos-m-powered--m-pwrd).
Alternatively, if you prefer, you can use our community project logos, nicknamed "M-Powered" and "M-PWRD", which are specifically designed for projects that utilize Meshtastic technology. These logos offer a straightforward way to show compatibility with our platform without needing a trademark grant. For more information on these logos, including usage guidelines and design files, please refer to [Community Project Logos: M-Powered & M-PWRD](/docs/legal/licensing-and-trademark#community-project-logos-m-powered--m-pwrd).
## Meshtastic Trademark Policy & Brand Guidelines

View file

@ -87,6 +87,17 @@ const SocialCards: SocialCardProps[] = [
/>
),
},
{
color: "bg-[#24A1DE]",
link: "https://t.me/+hmKN0xOR73ExOTU6",
children: (
<img
alt="telegram"
className="m-auto h-14"
src="/img/homepage/telegram-single-path-240px.svg"
/>
),
},
];
function Home() {

View file

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 240 240"><path d="M222.51 19.53c-2.674.083-5.354.78-7.783 1.872-4.433 1.702-51.103 19.78-97.79 37.834C93.576 68.27 70.25 77.28 52.292 84.2 34.333 91.12 21.27 96.114 19.98 96.565c-4.28 1.502-10.448 3.905-14.582 8.76-2.066 2.428-3.617 6.794-1.804 10.53 1.812 3.74 5.303 5.804 10.244 7.69l.152.058.156.048c17.998 5.55 45.162 14.065 48.823 15.213.95 3.134 12.412 40.865 18.65 61.285 1.602 4.226 6.357 7.058 10.773 6.46.794.027 2.264.014 3.898-.378 2.383-.57 5.454-1.924 8.374-4.667l.002-.002c4.153-3.9 18.925-18.373 23.332-22.693l48.27 35.643.18.11s4.368 2.894 10.134 3.284c2.883.195 6.406-.33 9.455-2.556 3.05-2.228 5.25-5.91 6.352-10.71 3.764-16.395 29.428-138.487 33.83-158.837 2.742-10.348 1.442-18.38-3.7-22.872-2.59-2.26-5.675-3.275-8.827-3.395-.394-.015-.788-.016-1.183-.004zm.545 10.02c1.254.02 2.26.365 2.886.91 1.252 1.093 2.878 4.386.574 12.944-12.437 55.246-23.276 111.71-33.87 158.994-.73 3.168-1.752 4.323-2.505 4.873-.754.552-1.613.744-2.884.658-2.487-.17-5.36-1.72-5.488-1.79l-78.207-57.745c7.685-7.266 59.17-55.912 87.352-81.63 3.064-2.95.584-8.278-3.53-8.214-5.294 1.07-9.64 4.85-14.437 7.212-34.79 20.36-100.58 60.213-106.402 63.742-3.04-.954-30.89-9.686-49.197-15.332-2.925-1.128-3.962-2.02-4.344-2.36.007-.01.002.004.01-.005 1.362-1.6 6.97-4.646 10.277-5.807 2.503-.878 14.633-5.544 32.6-12.467 17.965-6.922 41.294-15.938 64.653-24.97 32.706-12.647 65.46-25.32 98.137-37.98 1.617-.75 3.12-1.052 4.375-1.032zM100.293 158.41l19.555 14.44c-5.433 5.32-18.327 17.937-21.924 21.322l2.37-35.762z" fill="#fff" color="#fff"/></svg>

After

Width:  |  Height:  |  Size: 1.6 KiB