Duckiebot Handling Cheatsheet (DB21)#

This chapter describes how to handle your Duckiebot.

What you will need

What you will get

  • A “cheatsheet” for common Duckiebot operations

How to update the software on a Duckiebot#

To update the software on your Duckiebot, run:

dts duckiebot update ROBOT_NAME

How to SSH into your Duckiebot#

To ssh into your Duckiebot, using the SSH (Secure Shell) protocol, run the following command and enter the password (the default password is quackquack):

ssh duckie@DUCKIEBOT_NAME.local

How to see what your Duckiebot sees#

To see what your Duckiebot sees, follow Operations - Image Streaming (Make it See).

How to make your Duckiebot move#

To make your Duckiebot move, follow Operations - Keyboard Control (Make it move).

How to control your Duckiebot’s LEDs#

To control your Duckiebot’s LEDs, follow Operations - LED control (Make it Shine).

How to update the Duckiebattery#

To update the Duckiebattery, follow Duckiebattery software update.

How to check the charging efficiency of your Duckiebot#

Once your Duckiebattery is up to date and your Duckiebot is connected, run:

dts duckiebot battery info ROBOT_NAME

battery:
  cell_voltage: 3.59
  charging: true
  current: 0.84
  cycle_count: 20
  input_voltage: 4.82
  percentage: 12
  present: true
  temperature: 39.85
  time_to_empty: 3932100
  usb_out_1_voltage: 4.73
  usb_out_2_voltage: 5.01

How to update the HUT#

To update the HUT, follow Debug - Re-flash HUT.

How to connect to your Duckiebot over the Internet#

To connect to your Duckiebot over the Internet, follow Remote Duckiebot control with ZeroTier.

Troubleshooting#

Troubleshooting

SYMPTOM

I have pressed the top button down as far as it will go for 5 s but it does not turn my Duckiebot off.

RESOLUTION

Run:

dts duckiebot update DUCKIEBOT_NAME

dts duckiebot reboot DUCKIEBOT_NAME

Troubleshooting

SYMPTOM

I have updated and rebooted my Duckiebot but the top button still does not turn it off.

RESOLUTION

Update the HUT.

Troubleshooting

SYMPTOM

My Duckiebot is stuck in a boot cycle and the Duckiebattery has a very low charge.

RESOLUTION

Unplug the cables connected to the 5VRASPI and 5VEXT ports on the HUT, and allow the Duckiebattery to charge for at least 5 h before plugging them back in.