Merge branch 'master' into pico

This commit is contained in:
rcarteraz 2024-01-23 13:18:19 -07:00 committed by GitHub
commit 97da932b3f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
24 changed files with 121 additions and 21 deletions

View file

@ -9,7 +9,6 @@ import Link from "@docusaurus/Link";
Meshtastic® is a project that enables you to use inexpensive LoRa radios as a long range off-grid communication platform in areas without existing or reliable communications infrastructure. This project is 100% community driven and open source!
![LoRa Topology](/img/introduction/lora-topology-2.png)
### Features
@ -25,11 +24,11 @@ Meshtastic® is a project that enables you to use inexpensive LoRa radios as a l
## How it works
The underlying technology, LoRa, is a long range radio protocol available to most regions without requiring additional licensing or certification, like HAM operators.
Meshtastic utilizes LoRa, a long-range radio protocol, which is widely accessible in most regions without the need for additional licenses or certifications, unlike HAM radio operations.
The radios automatically rebroadcast messages they receive in order to create a mesh network so that everyone in the group can receive messages - even from the furthest member. Depending on settings used, the Meshtastic mesh can sustain up to 80 device nodes.
These radios are designed to rebroadcast messages they receive, forming a mesh network. This setup ensures that every group member, including those at the furthest distance, can receive messages. Depending on the settings employed, the Meshtastic mesh network can support up to 100 devices concurrently.
Meshtastic radios can be paired to a single phone so that your friends and family are able to address a message to your specific radio. Each device supports a connection from a single user at a time.
Additionally, Meshtastic radios can be paired with a single phone, allowing friends and family to send messages directly to your specific radio. It's important to note that each device is capable of supporting a connection from only one user at a time."
If you are interested in a more technical overview of how Meshtastic works, visit the overview section below:

View file

@ -0,0 +1,7 @@
position: 7
label: Community
collapsible: true # make the category collapsible
link:
type: generated-index
title: Meshtastic Community
slug: /community

View file

@ -0,0 +1,30 @@
---
id: local-groups
title: Local Groups
sidebar_label: Local Groups
slug: /community/local-groups
sidebar_position: 1
---
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import LoRaRegions from "../blocks/_lora-regions.mdx";
import Link from "@docusaurus/Link";
Below is a list of groups that have been actively organizing Meshtastic networks in their regions. Feel free to contact
them for assistance in getting started or if you're interested in contributing to the network. If you're a group
organizer with an online presence and wish to be included in this list, please edit this page directly or reach out to
us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
## Canada
### Alberta
- [YYC Mesh](https://yycmesh.com/)
## United States
### California
- [SoCal Mesh](https://socalmesh.org)
- [Laguna Mesh](https://lagunamesh.com)
- [Mission Viejo Mesh](https://missionviejomesh.org/)
### Hawaii
- [Hawaii Meshnet](https://www.hawaiimesh.net/)

View file

@ -1,16 +1,16 @@
---
title: Community Apps
slug: /software/community
slug: /community/software
sidebar_label: Community Apps
sidebar_position: 10
sidebar_position: 2
---
The Meshtastic ecosystem is highly extensible, and a number of community projects have been made to fit different people's needs. If you wish to create your own application or module, please read the information in the developers section, and tell us about your project on the forum.
Current community projects:
- [ATAK (Android Team Awareness Kit) Forwarder](/docs/software/community/community-atak) - An ATAK plugin for forwarding CoT messages via a hardware layer which supports Meshtastic devices.
- [Meshtasticator (Simulator)](/docs/software/community/community-meshtasticator) - Meshtasticator is a discrete-event and interactive simulator that mimics the radio section of the device software.
- [Meshtastic Web API](/docs/software/community/meshtastic-web-api) - Meshtastic Web API provides a RESTful interface to interact with a Meshtastic node via a serial connection.
- [ATAK (Android Team Awareness Kit) Forwarder](/docs/community/software/community-atak) - An ATAK plugin for forwarding CoT messages via a hardware layer which supports Meshtastic devices.
- [Meshtasticator (Simulator)](/docs/community/software/community-meshtasticator) - Meshtasticator is a discrete-event and interactive simulator that mimics the radio section of the device software.
- [Meshtastic Web API](/docs/community/software/meshtastic-web-api) - Meshtastic Web API provides a RESTful interface to interact with a Meshtastic node via a serial connection.
Support for these projects should be sought from their respective authors.

View file

@ -1,6 +1,6 @@
label: Development
collapsible: true
position: 7
position: 8
link:
type: generated-index
title: Developers

View file

@ -22,7 +22,9 @@ The [T-Beam 0.7](/docs/hardware/devices/tbeam#t-beam---v07) board is an earlier
:::
## Command Line Interface Instructions
### Install Prerequisite Software
<Tabs
groupId="operating-system"
defaultValue="linux"
@ -33,7 +35,6 @@ values={[
]}>
<TabItem value="linux">
Check if you have `python3` and `pip` installed with the following command
```shell
@ -57,8 +58,6 @@ sudo apt-get install python3-pip
</TabItem>
<TabItem value="macos">
OS X comes with `Python 2.7` installed, but not `pip`. The following uses Homebrew to install `python3` which includes `pip3`. On MacOS you will use `pip3` instead > of `pip`.
:::note
@ -110,7 +109,6 @@ pip --version
:::
</TabItem>
</Tabs>
@ -120,7 +118,6 @@ pip --version
pip3 install --upgrade esptool
```
### Confirm Communication With Chip
<Tabs
@ -131,7 +128,13 @@ values={[
{label: 'macOS', value: 'macos'},
{label: 'Windows', value: 'windows'},
]}>
<TabItem value="linux"></TabItem>
<TabItem value="linux">
:::important
On Linux, you may need to explicitly declare esptool as a .py script. Use `esptool.py chip_id`.
:::
</TabItem>
<TabItem value="macos">
:::important
@ -244,7 +247,6 @@ device-update.bat -f firmware-BOARD-VERSION.bin
</TabItem>
</Tabs>
## Connect and Configure Device
After flashing the Meshtastic firmware to the device, you can proceed with the initial configuration.

View file

@ -8,7 +8,7 @@ sidebar_position: 2
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
nRF52 devices from RAK are able to accept OTA firmware updates from a mobile device over bluetooth. The T-Echo bootloader does not have OTA support.
nRF52 devices from RAK are able to accept OTA firmware updates from a mobile device over bluetooth. Older T-Echo bootloaders do not have OTA support.
<Tabs
groupId="settings"

View file

@ -55,6 +55,7 @@ RAK12002 RTC<br/>
[RAK1902](./rak/peripherals?rakmodules=Sensors&sensors=RAK1902) Barometric Pressure Sensor<br/>
[RAK1906](./rak/peripherals?rakmodules=Sensors&sensors=RAK1906) Environment Sensor<br/>
RAK12013 Radar Sensor<br/>
RAK13800 Ethernet Module<br/>
### [LILYGO® T-Beam](./tbeam/)
Boards complete with GPS, 18650 battery holder, and optional screen.
@ -136,4 +137,4 @@ Fast versatile boards using the RP2040.
[**Pico Peripherals**](./raspberry-pi/peripherals/)<br/>
SSD1306 OLED Display<br/>
SH1106 OLED Display<br/>
CardKB Keyboard<br/>
CardKB Keyboard<br/>

View file

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

View file

@ -38,3 +38,10 @@ Download from [Printables](https://www.printables.com/model/286662-rak19003-case
Download from [Printables](https://www.printables.com/model/286664-rak19003-micro-case-for-meshtastic) or purchase from the creator's [Etsy Store](https://www.etsy.com/listing/1302260756/meshtastic-rak19003-micro-case).
![rak19003-micro](/img/enclosures/3dp-tropho-rak19003-micro.png)
## Created by tavdog/Tavis Gustafson
### [Harbor Breeze Meshtastic Hack](./harbor_breeze_solar_enclosure.mdx)
![Harbor Breeze Solar LED Meshtastic Hack Complete](/img/enclosures/hbmh_complete.png)

View file

@ -171,6 +171,8 @@ Radio Configuration opens a list of all radio and module configuration settings.
Allows you to save all your network's position data with GPS coordinates into a .csv (comma separated value) file on your phone. This file can be imported into the spreadsheet application of your choice for easy viewing. This feature is similar but independent from the device [range test module](/docs/configuration/module/range-test), and results may differ.
To reset the values go to the Debug Panel and press the "Clear" button.
### Theme
[![Meshtastic theme](/img/android/android-settings-theme-c.png)](/img/android/android-settings-theme.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 984 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 647 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 688 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 519 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 374 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 494 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 509 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 957 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 MiB

View file

@ -41,11 +41,11 @@
"destination": "/docs/hardware/devices/rak/core-module#gpio"
},
{
"source": "/software/android-too-old",
"source": "/software/android-too-old(.*)",
"destination": "/docs/software/android/installation"
},
{
"source": "/docs/software/android/android-installation",
"source": "/docs/software/android/android-installation(.*)",
"destination": "/docs/software/android/installation"
},
{