Updated console

Console/build.py

@@ -4,9 +4,9 @@ import sys
 import shutil
 
 packages = {
-    "rns": "rns-0.4.7-py3-none-any.whl",
-    "nomadnet": "nomadnet-0.3.2-py3-none-any.whl",
-    "lxmf": "lxmf-0.2.9-py3-none-any.whl",
+    "rns": "rns-0.4.8-py3-none-any.whl",
+    "nomadnet": "nomadnet-0.3.3-py3-none-any.whl",
+    "lxmf": "lxmf-0.3.0-py3-none-any.whl",
 }
 
 DEFAULT_TITLE = "RNode Bootstrap Console"

Console/source/builds/handheld.md

@@ -22,6 +22,9 @@ This build recipe will help you create an RNode that is suitable for mobile and
 
 
 ### <a name="prep"></a>Step 1: Preparation
+
+When you have completed this recipe, you will end up with a fully-featured RNode device, similar to the one pictured above. To make it as easy as possible to complete this guide, make sure to read it all in its entirity *before* starting. I also recommend you familiarise yourself with the required materials, and the software tools needed for the setup.
+
 To complete this build recipe, you will need access to the following items:
 
 - A computer with a functional operating system, such as Linux, BSD or macOS
@@ -29,21 +32,40 @@ To complete this build recipe, you will need access to the following items:
 - A suitable USB cable for connecting the development board to your computer
 - A 3D printer and the necessary amount of material for printing the [device parts](#parts)
 - 6 pieces of M2x6mm screws to assemble the case
-- A suitable [antenna](#antenna)
+- A suitable antenna
 - An optional NeoPixel RGB LED
 - An optional [battery](#battery)
+    - This build can use any single-cell (3.7v) lithium battery with a 1.25mm JST connector, provided it will fit in the case. Please see [this section](#battery) for details on battery sizes.
 
 ### <a name="devboard"></a>Step 2: Supported Development Boards
 
-This RNode design is using a **LilyGO LoRa32 v2.1** board, in either the 433 MHz, 868 MHz, 915 MHz or 923 MHz variants. It is easiest to obtain the version of the board with an *u.FL* (sometimes also labeled *IPEX*) antenna connector, instead of the *SMA* connector. This version comes with an SMA to u.FL pigtail, which is installed into the 3D-printed case.
+This RNode design is using a **LilyGO LoRa32 v2.1** board, in either the **433 MHz**, **868 MHz**, **915 MHz** or **923 MHz** variants. It seems that the 868, 915 and 923 MHz variants are in fact completely identical, and all offer a frequency range between 820 and 1020 MHz. The 433MHz variants offer a frequency range between 420 and 520 MHz.
 
-If you have the version with an *SMA* connector, you will have to desolder it, and activate the *u.FL* connector instead, by moving a resistor on the board.
+These boards are also sold under many different "brand" names other than LilyGO, but using the images below, you should be able to identify the correct ones.
 
-You will also need to demount the OLED display from the small acrylic riser on the board, and unscrew and discard the riser, since the OLED display will be mounted directly into a matching slot in the 3D-printed case.
+It is easiest to obtain the version of the board with an **u.FL** (sometimes also labeled *IPX* or *IPEX*) antenna connector, instead of the **SMA** connector. This version comes with an SMA to u.FL pigtail, which is installed into the 3D-printed case. If it is not possible to obtain this version, you can use the one with an **SMA** connector, either as is, or by removing the **SMA** connector, and using the on-board **u.FL** connector instead.
+
+If you do not wish to use the 3D-printable case included in this guide, it does not matter which version you get. There is **no functional difference** between the boards with **SMA** and **u.FL** connectors.
 
 <img alt="Compatible board" src="{ASSET_PATH}images/bg_h_2.webp" style="width: 100%;"/>
 <center>*The correct board version for this RNode build recipe*</center>
 
+If you want to use the case provided for this build guide, and you have the version with an *SMA* connector, you will have to desolder the **SMA** connector, and activate the *u.FL* connector instead (it's already installed on all the boards, just not activated on the **SMA** connector versions).
+
+To activate the **u.FL** connector, you will just have to "rotate" the small resistor next to the antenna connectors by 90 degrees, so it "points" at the connector you wish to use.
+
+Please note that the "resistor" is actually just a zero-ohm jumper. If you don't feel like fiddling around with small components, you can simply remove it, and bridge the relevant gap with a blob of solder.
+
+Refer to the following two pictures to locate the resistor that needs moving:
+
+<img alt="Before desoldering" src="{ASSET_PATH}images/bg1ds1.webp" style="display: inline-block;width: 48.7%; margin-right:1%;"/>
+<img alt="After desoldering" src="{ASSET_PATH}images/bg1ds2.webp" style="display: inline-block;width: 48.7%; margin-left: 1%;"/>
+<center>*Before and after removing the SMA connector and moving the resistor*</center>
+
+You will also need to dismount the OLED display from the small acrylic riser on the board, and unscrew and discard the riser. Be careful not to damage the display or ribbon cable while doing this. The OLED display will be mounted directly into a matching slot in the 3D-printed case.
+
+As before, if you do not want to use the 3D printed case supplied here, it's probably much easier to keep the display on the board, and you can simply skip this step.
+
 ### <a name="materials"></a>Step 3: Obtain Materials
 
 In addition to the board, you will need a few other components to build this RNode.