Merge branch 'master' into master

This commit is contained in:
pdxlocations 2024-01-22 15:10:20 -08:00 committed by GitHub
commit e50259f732
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
15 changed files with 75 additions and 13 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

@ -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

@ -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"
},
{