Skip to main content

Deploying Meadow.OS

When you receive your Meadow board, it will need to have the latest Meadow.OS uploaded, or flashed, to it.

Step 1 - Create a Wilderness Labs Account

In order to download the latest version of Meadow.OS, you will need to register for a Wilderness Labs Account.

Step 2 - Install .NET SDK

Download and install version 8 .NET SDK.

Step 3 - Install Meadow.CLI

The way we flash Meadow boards (among other things) is via our command-line-interface tool called Meadow.CLI. Make sure you have it installed to continue.

Step 4 - Install dfu-util

From a console with admin rights, execute following command:

meadow dfu install

Step 5 - Put the device into DFU Bootloader mode

To flash your board with the latest OS, Meadow must be in DFU bootloader mode. To enter this mode, the BOOT button needs to be held down while the board boots up. This can be accomplished one of two ways.

  • If the board is disconnected: hold the BOOT button down and connect the board to your computer via a Micro USB Cable.

  • If the board is connected: hold the BOOT button down, and then press and release the RST (Reset) button. Then release the BOOT button.

Meadow board with boot button labeled at the end of the header on the battery JST side of the board.

Step 6 - Install Meadow USB drivers

Checking Meadow USB drivers

Before flashing a Meadow board, open the Device Manager and check:

  • When the board is in Bootloader mode it should show up as a STM32 BOOTLOADER device under Universal Serial Bus Devices section.

  • When the board is connected normally it should show up as a USB Serial Device (COMX) under the Ports (COM & LPT) section

    Meadow drivers shown in Bootloader and regular mode

If the board is in this state you can head over to the next step.

Updating Meadow USB drivers

If Meadow shows as Meadow F7 Micro (COMX) in regular mode, right-click on it and select Uninstall Device, and make sure to select Attempt to remove the driver for this device like so:

Uninstall wrong Meadow Driver

Now to flash Meadow OS, dfu-util is recommended. However, the default Windows USB driver for ST devices is not compatible with dfu-util, so it needs to be replaced. For more in-depth information on this, check out Scott Hanselman's post. Follow these steps:

  1. Download and run Zadig

  2. Connect the Meadow device holding the BOOT button pressed to power it on in Bootloader mode.

  3. In Zadig, click Options > List All Devices

  4. Select STM32 BOOTLOADER in the dropdown

  5. Click Replace Driver

    Zadig showing STM32 Bootloader device selected and WinUSB driver chosen with a Replace Driver button.

  6. After the installation is complete, driver should be WinUSB

    Zadig showing the replaced driver as WinUSB with a Reinstall Driver button.

Your board is now ready to flash it with latest Meadow.OS version.

Step 7 - Log in to your Wilderness Labs account

Use the following command to log into your Wilderness Labs Account:

meadow login

This will open a web browser where you'll need to enter your account credentials. If successful, you'll receive a confirmation on the CLI.

Step 8 - Download Meadow.OS

Now we can download the latest Meadow.OS binary files with the command:

meadow firmware download

Step 9 - Flash Meadow.OS

Once connected the Meadow device via the USB cable and having put the device into DFU Bootloader mode, execute the following command in your console:

meadow firmware write

When the flashing process has completed with no errors, disconnect and reconnect the Meadow board to give it a full restart.

Your board is now ready to have a Meadow application deployed to it!