Small fixes

This commit is contained in:
apt105 2021-05-15 19:36:15 +01:00
parent d878519bc3
commit 7b6deb0473
4 changed files with 72 additions and 4 deletions

View file

@ -105,6 +105,21 @@ brew -v
If it's not installed, follow the instructions on the [Homebrew website](https://brew.sh) before continuing.
:::
Check if you have `python3` and `pip` installed with the following command
```bash
python3 --version
pip3 --version
```
If `python3` is not installed, install with
Install Python3
```bash
brew install python3
```
Confirm `pip3` was installed alongside `python3`
```bash
pip3 -v
```
</TabItem>
<TabItem value="windows">

View file

@ -10,7 +10,7 @@ slug: /hardware/antenna
If you have sufficient range with your existing aerial, skip this section. If you don't, consider either getting more nodes and / or replace the stock aerial with one tuned (to your region transmitter's frequency):
- A quarter quarter wave _tuned_ stubby aerial (<10cm for fit-in-pocket) should have a real-world range of a couple of km without significant obstacles (buildings / hills).
- Aerial criteria: 50 Ohm, appropriate connector (usually SMA male of U.FL), low VSWR (<2) (at tuning frequency - see its datasheet), gain > 0 dbi .
- Aerial criteria: 50 Ohm, appropriate connector (usually SMA male or U.FL), low VSWR (<2) (at tuning frequency - see its datasheet), gain > 0 dbi .
- Caution, avoid suppliers who:
- don't state the aerial's tuned frequency and its specific purpose (LoRa network)
- claim huge gain figures on omni-directional aerials

View file

@ -29,9 +29,11 @@ slug: /hardware/resources
* [Solwise Link Budget Calculator](https://www.solwise.co.uk/link-budget.htm)
* 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/)

View file

@ -3,14 +3,24 @@ id: python-installation
title: Meshtastic-python installation
sidebar_label: Installation
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
This is a python library for using Meshtastic devices. This small library (and example application) provides an easy API for sending and receiving messages over mesh radios. It also provides access to any of the operations/data available in the device user interface or the Android application. Events are delivered using a publish-subscribe model, and you can subscribe to only the message types you are interested in.
[Full documentation](https://meshtastic.github.io/Meshtastic-python) for the library, including examples, is available.
Installation is easily done through the Python package installer pip (note, you must use pip version 20 or later):
Installation is easily done through the [Python package installer pip](https://pypi.org/project/meshtastic/) (note, you must use pip version 20 or later):
## Linux
<Tabs
groupId="operating-system"
defaultValue="linux"
values={[
{label: 'Linux', value: 'linux'},
{label: 'macOS', value: 'macos'},
{label: 'Windows', value: 'windows'},
]}>
<TabItem value="linux">
- Check that your computer has the required serial drivers installed
* Connect your Meshtastic device to your USB port
@ -40,6 +50,45 @@ Installation is easily done through the Python package installer pip (note, you
```bash
sudo pip3 install --upgrade meshtastic
```
</TabItem>
<TabItem value="macos">
- Check that your computer has the required serial drivers installed
* Connect your Meshtastic device to your USB port
* Navigate to `Apple Menu  > About This Mac > System Report... > Hardware > USB`
* You should see something like `CP210X USB to UART Bridge Controller`
* If not download the drivers from [Silicon Labs](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers).
- Check that your computer has Python 3 installed.
* Use the command
```bash
python3 -V
```
* If this does not return a version, install [python](https://www.python.org)
* The following uses Homebrew to install `python3` which includes `pip3`.
* Check if you have Homebrew installed with the following command
```bash
brew -v
```
If it's not installed, follow the instructions on the [Homebrew website](https://brew.sh) before continuing.
* Install Python3
```bash
brew install python3
```
- Pip is typically installed if you are using python 3 version >= 3.4
* Check that pip is installed using this command
```bash
pip3 -V
```
* If this does not return a version, install [pip](https://pip.pypa.io/en/stable/installing/)
- Install pytap2
```bash
sudo pip3 install --upgrade pytap2
```
- Install meshtastic:
```bash
sudo pip3 install --upgrade meshtastic
```
</TabItem>
<TabItem value="windows">
## Windows
- Check that your computer has the required serial drivers installed
@ -66,4 +115,6 @@ Installation is easily done through the Python package installer pip (note, you
- Install meshtastic:
```powershell
pip3 install --upgrade meshtastic
```
```
</TabItem>
</Tabs>