dh4d:consolecommands

This is an old revision of the document!


This is a comprehensive list of all commands supported by the SR-DH4D console. These commands can be used through the USB console or through the Bluetooth interface (if installed).

hlp - display list of available commands
This command is especially useful to learn about all the commands supported your firmware version.

did - List Hand Configuration and Internal Status
This should be your first go-to command for troubleshooting. It will display a comprehensive list including Dynamixel IDs, connection settings, servo status (including overload errors, etc.) and additional board information including model, Serial Number, Position Resolution and presence of Bluetooth module.

ope - Open Hand
Opens the hand completely.

clo - Close Hand
Closes the hand completely.

pos - Set servo position
pos [servo_nr 1-4] [position value]

The position value should be provided in the range of 0~1023 or 0~4095 depending how your Hand is configured for Position Resolution.

pwr - Reset the unit and Power cycle actuators

These commands let you configure the inner workings and settings for your hand. They should be used with caution as they typically manipulate settings that will be save din permanent storage (EEPROM).

ree 1 - Resets Baud Rate, Return Delay Time and Status Return Level of the Dynamixel communication to factory defaults
Defaults are Baud Rate = 1Mbps, Return Delay time = 250 [500 microsecs], Status Return Level = 2 [always return]

ree 2 - Resets the Dynamixel IDs to factory defaults for a Left hand
IDs are reset to: Virtual ID=22/Wrist Rotation=24/Wrist Flexion=26/Thumb finger=28/Index fingers=30

ree 3 - Resets the Dynamixel IDs to factory defaults for a Right hand
IDs are reset to: Virtual ID=21/Wrist Rotation=23/Wrist Flexion=25/Thumb finger=27/Index fingers=29

ree 4 [value~255] - Changes the Baud Rate to a user selected Setting
Value has the same meaning used in the Dynaixel Wizard/Robotis control tables for setting speed (common Settings are: 34=57600bps, 1=1Mbit/s, 252=3Mbps).

ree 5 [0|1] - Configure the Position resolution
0=10 bit resolution (0~1023); 1=12bit resolution (0~4095)

bti - Shows Bluetooth Module Information (if installed)

bwn [name] - Change the Bluetooth Module Broadcasting Name
Sets the Broadcast name for the Bluetooth module of the hand.

bwp [code] - Change the Bluetooth Module Pairing Code
Sets the paring code for the Bluetooth module of the hand.
Any code lower than 1000 will be padded with leading zeros, to make a 4 digit code, required for pairing.

This functionality has been implemented to ensure a 1:1 match in manipulating the Dynamixel Control tables through any of the interfaces in the Hand.

Please note that the console syntax does not follow the Dynamixel protocol format: Instead, commands are provided to let you target a Control Table position and read or write a byte or word directly to it. It has the same effect as sending a READ or WRITE command to the hand, except here, we do it in a console environment and console syntax.

Another very important difference is that, when addressing the Actuator control tables, in the console commands we identify them from 1-4 (5 for the Virtual ID) and this is fixed. We do not use the Dynamixel ID in the syntax of these commands.

wrb - write BYTE on Dynamixel table
wrb [Actuator Nr] [mempos] [value~255]

Return
[byte: Dynamixel error flag]\n

wrw - write WORD on Dynamixel table\
wrw [Actuator Nr] [mempos] [value~65536]

Return
[byte: Dynamixel error flag]\n

reb - read BYTE from Dynamixel Table
reb [Actuator Nr] [mempos]

Return
[byte: Dynamixel error flag]\t[byte:value]\n

rew - read WORD from Dynamixel Table
rew [Actuator Nr] [mempos]

Return
[byte: Dynamixel error flag]\t[word:value]\n

Actuator Numbers are:

  • 1=Wrist Rotation
  • 2=Wrist Flexion
  • 3=Thumb
  • 4=Index fingers
  • 5=Virtual ID

To learn about the Control tables see here.

Copyright © 2015-2023 Seed Robotics Ltd

  • dh4d/consolecommands.1459193938.txt.gz
  • Last modified: 2016/03/28 19:38
  • by wadmin