diff --git a/docs/getting-started/flashing-firmware/4631-R-to-4631.mdx b/docs/getting-started/flashing-firmware/4631-R-to-4631.mdx new file mode 100644 index 00000000..d7ec9148 --- /dev/null +++ b/docs/getting-started/flashing-firmware/4631-R-to-4631.mdx @@ -0,0 +1,33 @@ +--- +id: 4631-r-to-4631 +title: Convert RAK4631-R to RAK4631 +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +Running Meshtastic on RAK WisBlock NRF52 based boards relies on the avaliability of the Arduono bootloader. + +This process only needs to be performed once + +This conversion requires the use of either a [DAPLink](https://daplink.io/) or [J-Link](https://www.segger.com/products/debug-probes/j-link/). The most reasonably priced and avaliable is the [RAKDAP1](https://store.rakwireless.com/products/daplink-tool). + +1. Install [Python](https://www.python.org/downloads/) +2. Install [pyOCD](https://pyocd.io/) + +```shell +pip3 install pyocd +``` + +3. Download the required bootloader: [WisCore_RAK4631_Board_Bootloader.hex](https://github.com/RAKWireless/WisBlock/releases/download/0.4.2/WisCore_RAK4631_Board_Bootloader.hex) +4. Connect the RAKDAP as follows: + [](/img/rak4631-rakdap1.png) +5. Flash the bootloader + +```shell +pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex +``` + +6. Continue with the [normal instructions](/docs/getting-started/flashing-firmware/flashing-nrf52) + +Alternate methods of flashing are outlined [here](https://github.com/RAKWireless/WisBlock/tree/master/bootloader/RAK4630). diff --git a/docs/getting-started/flashing-firmware/flashing-nrf52.mdx b/docs/getting-started/flashing-firmware/flashing-nrf52.mdx index d683c7c2..56a73737 100644 --- a/docs/getting-started/flashing-firmware/flashing-nrf52.mdx +++ b/docs/getting-started/flashing-firmware/flashing-nrf52.mdx @@ -10,12 +10,14 @@ sidebar_position: 1 import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +:::info +Before flashing confirm that you have [RAK4631](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631/) and not a [RAK4631-R](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631-R/) If this is not the case, fear not. The hardware is identical but requires changing the bootloader. Instructions on how to do this are located [here](/docs/getting-started/flashing-firmware/4631-r-to-4631). +::: -The NRF52 based devices (LilyGO T-Echo, RAK Wisblock 4631) have the easiest firmware upgrade process. (No driver or software install is required on any platform) +The NRF52 based devices (LilyGO T-Echo, RAK Wisblock 4631) have the easiest firmware upgrade process. (No driver or software install is required on any platform) Connect your device to your computer with a data USB cable. Double click the reset button on your device, this will put it into bootloader mode and and a drive will appear on Windows, Mac and Linux. A new drive will be mounted on your computer. Open this drive and you should see three files: `CURRENT.UF2`, `INDEX.HTM`, and `INFO_UF2.TXT` -Drop the appropriate appropriate `firmware-xxxxx-1.3.x.uf2` file from the release you want to install onto this drive and the meshtastic firmware will be installed on the device. Once the file has finished copying onto the drive the device will reboot and load Meshtastic. - +Drop the appropriate appropriate `firmware-DEVICE_NAME-vx.x.x-xxxxxxx.uf2` file from the release you want to install onto this drive and the meshtastic firmware will be installed on the device. Once the file has finished copying onto the drive the device will reboot and load Meshtastic. diff --git a/docs/getting-started/flashing-firmware/index.mdx b/docs/getting-started/flashing-firmware/index.mdx index 438815a9..1b7cd880 100644 --- a/docs/getting-started/flashing-firmware/index.mdx +++ b/docs/getting-started/flashing-firmware/index.mdx @@ -15,7 +15,7 @@ Make sure not to power the radio on without first attaching the antenna! You cou ## Easiest Firmware install options -If you have RAK NRF based devices or a LilyGO T-Echo, [the drag and drop firmware installation process](/docs/getting-started/flashing-firmware/flashing-esp32) is the easiest solution. +If you have RAK NRF based devices or a LilyGO T-Echo, [the drag and drop firmware installation process](/docs/getting-started/flashing-firmware/flashing-nrf52) is the easiest solution. For ESP32 based device users (TBEAM, TLORA, Heltec etc.) we recommend using the [Meshtastic Flasher application](/docs/getting-started/flashing-firmware/meshtastic-flasher). It does a lot under the hood to prevent you from needing to use the terminal. It also allows you to configure your device. diff --git a/static/img/rak4631-rakdap1.png b/static/img/rak4631-rakdap1.png new file mode 100644 index 00000000..52ad01ff Binary files /dev/null and b/static/img/rak4631-rakdap1.png differ