From 8535548f5877ed31d6584c46346349a8ca73e720 Mon Sep 17 00:00:00 2001 From: apt105 <73254487+apt105@users.noreply.github.com> Date: Sat, 15 May 2021 19:40:24 +0100 Subject: [PATCH] Update installation.md --- website/docs/software/python/installation.md | 150 +++++++++---------- 1 file changed, 74 insertions(+), 76 deletions(-) diff --git a/website/docs/software/python/installation.md b/website/docs/software/python/installation.md index dc489f43..b58cfe71 100644 --- a/website/docs/software/python/installation.md +++ b/website/docs/software/python/installation.md @@ -22,99 +22,97 @@ Installation is easily done through the [Python package installer pip](https://p ]}> -- Check that your computer has the required serial drivers installed - * Connect your Meshtastic device to your USB port - * Use the command + - Check that your computer has the required serial drivers installed + * Connect your Meshtastic device to your USB port + * Use the command + ```bash + lsusb + ``` + * 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) + - 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 - lsusb + sudo pip3 install --upgrade pytap2 ``` - * 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 + - Install meshtastic: ```bash - python3 -V + sudo pip3 install --upgrade meshtastic ``` - * If this does not return a version, install [python](https://www.python.org) -- 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 - ``` -- 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 + - 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 - brew -v + python3 -V ``` - If it's not installed, follow the instructions on the [Homebrew website](https://brew.sh) before continuing. - * Install Python3 + * 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 - brew install python3 + pip3 -V ``` -- Pip is typically installed if you are using python 3 version >= 3.4 - * Check that pip is installed using this command + * If this does not return a version, install [pip](https://pip.pypa.io/en/stable/installing/) + - Install pytap2 ```bash - pip3 -V + sudo pip3 install --upgrade pytap2 + ``` + - Install meshtastic: + ```bash + sudo pip3 install --upgrade meshtastic ``` - * 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 - ``` -## Windows - -- Check that your computer has the required serial drivers installed - * Connect your Meshtastic device to your USB port - * Open Device Manager - * Under `Ports (COM & LPT)` you should see something like `Silicon Labs CP210X USB to UART Bridge (COM5)` - * 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 + - Check that your computer has the required serial drivers installed + * Connect your Meshtastic device to your USB port + * Open Device Manager + * Under `Ports (COM & LPT)` you should see something like `Silicon Labs CP210X USB to UART Bridge (COM5)` + * 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 + ```powershell + py -V + ``` + * If this does not return a version, install [python](https://www.python.org) + - Pip is typically installed if you are using python 3 version >= 3.4 + * Check that pip is installed using this command + ```powershell + pip3 -V + ``` + * If this does not return a version, install [pip](https://pip.pypa.io/en/stable/installing/) + - Install pytap2 ```powershell - py -V + pip3 install --upgrade pytap2 ``` - * If this does not return a version, install [python](https://www.python.org) -- Pip is typically installed if you are using python 3 version >= 3.4 - * Check that pip is installed using this command + - Install meshtastic: ```powershell - pip3 -V + pip3 install --upgrade meshtastic ``` - * If this does not return a version, install [pip](https://pip.pypa.io/en/stable/installing/) -- Install pytap2 - ```powershell - pip3 install --upgrade pytap2 - ``` -- Install meshtastic: - ```powershell - pip3 install --upgrade meshtastic - ``` \ No newline at end of file