Skip to content

Commit

Permalink
Docs overhaul. This is much more reasonable now
Browse files Browse the repository at this point in the history
  • Loading branch information
ShakataGaNai committed Jun 8, 2024
1 parent 71a54a2 commit 1f59b69
Show file tree
Hide file tree
Showing 5 changed files with 49 additions and 13 deletions.
2 changes: 1 addition & 1 deletion content/docs/community-docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ weight: 100
tags: [PowerPoint, Google Slides, Presentations, Videos]
---

* [What's so fantastic about Meshtastic?](https://docs.google.com/presentation/d/17UMcNsIFdy1bjO0HMZsgbeayS4z1hq89ZyWkyKpdAew/edit#slide=id.p) by KO6CNT - Presented to [PAARA](https://www.paara.org/) on June 6, 2024
* [What's so fantastic about Meshtastic?](https://docs.google.com/presentation/d/17UMcNsIFdy1bjO0HMZsgbeayS4z1hq89ZyWkyKpdAew/edit#slide=id.p) by KO6CNT - Presented to [PAARA](https://www.paara.org/) on [June 6, 2024](https://www.paara.org/pages/meetings.html)
18 changes: 7 additions & 11 deletions content/docs/getting-started/_index.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,17 @@
---
title: Getting Started
description: If you've never used Meshtastic before this is a great place to start
# categories: [Examples, Placeholders]
tags: [Newbie, Config Settings, Client Config, MQTT]
tags: [Newbie]
weight: 20
---

{{% pageinfo %}}
If you haven't checked the [Offical Meshtastic Getting Started Guide](https://meshtastic.org/docs/getting-started/) we'd reccomend you start there first.
{{% /pageinfo %}}

In the Bay Area we have a few reccomendations for configuration

* Long/Fast
* Frequency 0
* Client
* Client Mute - Default reccomendation for all handheld units. It will not relay messages
* Client - Its ok to use, especially when there are few other nodes around. This will relay messages.
* Client Router / Router - Use router ONLY if you have a powerful and permanently installed node that can see a large amount of area.
* If you want to be internet connected, see [MQTT](MQTT)
## Getting started in 5 easy steps
- Get a supported device ( our [reccomendation]({{< ref "recommended-hardware" >}}) )
- Wipe and flash firmware using the [Meshtastic Web Flasher](https://flash.meshtastic.org/)
- Connect to the node via serial or bluetooth to your phone or computer
- Follow the [reccomended settings]({{< ref "recommended-settings" >}})
- Send messages!
2 changes: 1 addition & 1 deletion content/docs/getting-started/recommended-hardware.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Recommended Hardware
description: General suggestions on hardware
tags: [Hardware]
tags: [Newbie, Hardware]
---

See also [Discord #resources thread](https://discord.com/channels/1215705285159817236/1239383881698902036/1239393319566442596)
Expand Down
30 changes: 30 additions & 0 deletions content/docs/getting-started/recommended-settings.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: Recommended Settings
description: We have some sane default settings that we strongly reccomend you follow
tags: [Newbie, Config Settings, Client Config, MQTT]
---


In the Bay Area we have a few reccomendations for configuration

* LORA
* Set region to United States
* **Preset**: Long Range - Fast (Default)
* **Number of hops**: 3 (Default)
* Channels
* 0 Primary Channel
* **Name**: Blank (Default)
* **Key**: AQ== (Default)
* You may wish to turn off Positions & Location if you're not interested in broadcasting your location
* User
* **Long Name**: Something descriptive. Ex: Your name, Discord Handle, or Ham Callsign
* **Short Name**: Max of 4 characters, something unique for you and that particular radio. This will be what's displayed in chat.
* **Licensed Operator**: Do not enable unless you are a licensed [Amateur Radio operators](https://en.wikipedia.org/wiki/Amateur_radio) and have read [Licensed Operations]({{< ref "/docs/licensed-operations" >}}).
* Device Config
* **Device Role**
* Client Mute - Default reccomendation for all handheld units. It will not relay messages
* Client - Its ok to use, especially when there are few other nodes around. This will relay messages.
* Client Router / Router - Use router ONLY if you have a powerful and permanently installed node that can see a large amount of area.
* See [offical docs for full breakdown](https://meshtastic.org/docs/configuration/radio/device/)
* MQTT
* If you want to be internet connected, see [MQTT](MQTT)
10 changes: 10 additions & 0 deletions content/docs/licensed-operations.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: Licensed Operations
description: For those with an Amateur Radio License there is another side to Meshtastic
weight: 50
tags: [Ham, Amateur Radio]
---

See the [offical docs on Amateur Radio](https://meshtastic.org/docs/faq/#amateur-radio-ham)

In short, you can transmit up to 10W with high gain antennas. On the flip side you cannot join the default mesh and encryption must be disabled.

0 comments on commit 1f59b69

Please sign in to comment.