Updating an existing SD card#

What you will need

  • Functional DTS installation

  • A previously flashed Duckietown SD card

  • An SD card adapter appropriate for the computer you are using to flash the SD card

  • A broadband internet connection

  • 20 - 40 mins, depending on internet connection speed

What you will get

An updated SD card for your Duckietown robot.

Updating an initialized SD card#

To update an initialized SD card, run the following command, where TYPE and CONFIGURATION are the values used to initialize the SD card, HOSTNAME is the new robot name, WIFI is the new comma-separated list of Wi-Fi networks, and COUNTRY is the new two-letter Wi-Fi country code:

dts sd_card update --type TYPE --configuration CONFIGURATION [--hostname HOSTNAME] [--wifi WIFI] [--country COUNTRY] [--password]

Note

If you are using a Duckietown Workspace and dts is installed on the host machine, you can run this command inside or outside the Duckietown Workspace. When the command is run inside the Duckietown Workspace, it is automatically delegated to the host machine so that it can access the SD card.

At least one of --hostname, --wifi, --country, or --password is required; only the supplied settings are changed. Some disk images store Wi-Fi and country settings together, in which case you must provide both --wifi and --country in the same command.

--password prompts you to enter and confirm a new password for the duckie account. It must contain at least eight characters and cannot contain colons or line breaks. The characters you enter are not displayed. The password is applied the next time the robot boots. If DTS reports that the selected disk image does not support password updates, use a current supported image version.

Attention

Updating the WIFI configuration will replace existing data.

If you omit --device DEVICE, DTS prompts you to select the physical SD-card device. Specify it to select the device directly.

To see all available options, run:

dts sd_card update --help