DB21
DB21M
DB21
,DB21M
start_gui_tools
, ROS tools and no-vnc
DB17
DB18
DB19
DB21
,DB21M
Modified 2021-09-26 by tanij
An assembled DB21
or DB21M
. Find the assembly instructions here.
An initialized DB21
or DB21M
with image version at least 1.2.2. Find the initialization instructions here. Check your current firmware version before proceeding.
Knowledge on standard protocols to turn on, turn off, charge, and update the Duckiebattery software version on a DB21
or DB21M
.
the above box contains important information on the requirements. Make sure to read and follow them before proceeding.
DB21M
handling tutorial videoModified 2021-03-22 by Andrea F. Daniele
DB21M
Modified 2021-09-26 by tanij
To charge your Duckiebot, follow these steps:
HUT
.to minimize mechanical stress on the HUT
we recommend plugging in the charging cable once, and leaving the USB port end free to plug and unplug from charging instead. You can arrange the cable under the DB21M
top plate during operations for cable management.
the battery can draw up to 2A. Feeding a higher amperage will not be a problem, but wrong voltage will send the battery in protection mode.
HUT
near the charger port will turn green, indicating incoming power.DB21M
Modified 2021-09-26 by tanij
The proper shutdown protocol for a DB21M
requires having the Duckiebattery software version 2.0.0 or later. To check the version of your battery, follow the instruction to “Verify current battery version” on How to update a Duckiebattery.
Make sure the Duckiebot has completed the booting process. You can verify this by checking the “Status” after running dts fleet discover
on your laptop: a green Ready
message will indicate that the Duckiebot has completed the booting process.
There are three methods to power off a DB21M (recommended method: “With the top button”):
duckietown-shell
:dts duckiebot shutdown hostname
http://hostname.local
Power
options, and choose “Shutdown
”. Then confirm the action.duckietown-shell
” method.The following “hard” power shutdown should be only be used if the three methods above failed to shut down the Duckiebot, because it might lead to software and hardware issues.
As a last resort, one could still perform a “hard” power shutdown of the DB21M
:
- ssh duckie@hostname.local sudo poweroff
- unplugging the micro USB cable from the port marked as 5Vraspi
on the HUT
.
DB21M
Modified 2021-09-26 by tanij
To power on a Founder Edition Duckiebot, press the button on the battery once.
The Duckiebot LEDs, as well as the Jetson Nano board booting LED will turn on.
After a few seconds, the Wi-Fi dongle will start blinking. The Duckiebot LEDs will then turn to a steady white color, followed by the button and screen on the top plate powering on, as shown in the tutorial video.
Modified 2021-09-26 by tanij
To update the software running on the micro-controller in the Duckiebattery, or just checking the current version of it, follow this procedure.
When reporting issues on Stack Overflow, please include the step number, e.g. Step 4.i.b, the actions performed, and a description of the unexpected/unknown outcome.
Important:
Make sure the Duckiebot is powered on and connected to the network. You can verify the latter by launching, e.g., dts fleet discover
and finding that your Duckiebot is on the list.
All following hostname
refers to the name of the Duckiebot to which the battery is plugged in.
duckietown-shell
utility:pip3 install --user --upgrade --no-cache-dir duckietown-shell
dts update
dts desktop update
dts duckiebot update hostname
ssh duckie@hostname.local sudo reboot
dts duckiebot battery upgrade hostname
SAM-BA operation failed INFO:UpgradeHelper:An error occurred while flashing the battery. ERROR:dts:The battery reported the status 'GENERIC_ERROR'
, please try flashing again with: dts duckiebot battery upgrade --force hostname
NoBT
” (No battery detected), then single press the battery button, and run:ssh duckie@hostname.local sudo reboot
dts duckiebot battery check_firmware hostname
"2.0.2"
http://hostname.local/health/battery/info
"2.0.2"
HUT
Modified 2021-09-26 by tanij
Instructions on how to flash a Duckietown HUT
board can be found here.
(re)flashing a HUT
is typically not needed. A notable exception is for HUT
version 3.15 which comes with DB21
s. The HUT
version can be read on the board itself.