Skip to content

Commit 42d3362

Browse files
author
Cornelius Krupp
committed
Add a few comments for proto files
1 parent d3b7b4f commit 42d3362

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

src/bitbots_lowlevel/bitbots_x02_joint_control/proto/droid_msg.proto

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,14 @@ message Empty {
66

77
message DroidConfigs {
88
repeated string joint_name = 1;
9+
// Purpose unclear; is always all 0 currently.
910
repeated float pzero = 2;
11+
// Values in degree; Currently hand configured
1012
repeated float pmin = 3;
1113
repeated float pmax = 4;
14+
// max torque
1215
repeated float imax = 5;
16+
// Pre configured kp/kd values. Should be resend via the commands, but could be changed if needed.
1317
repeated float kp = 11;
1418
repeated float kd = 12;
1519
};
@@ -50,11 +54,24 @@ message DroidArmResponse {
5054
};
5155

5256
message DroidCommandRequest {
57+
// Turns on of each individual motor, at least for leg. mode=0 means the motor doesn't exert any torque
5358
repeated int32 mode = 1;
5459
repeated float position = 2;
60+
// Not used for BodyLower
61+
// Seems to be used for something by BodyUpper
5562
repeated float velocity = 3;
63+
// used by BodyLower
64+
// is added to the result of normal PDI
5665
repeated float torque = 4;
66+
// cmd_enable can be 0, 1, 2.
67+
// - What exactly 0 is supposed to do is unclear. might disable the command being processed
68+
// - 1 enables "motor mode", i.e. control of the motors directly. Used for the arms
69+
// - 2 enables "joint mode", i.e. control of the more abstract joints, which don't necessarily directly map to motors.
70+
// used by the legs because of the pullies
71+
// Only relevant for the legs, the UpperBody completely ignores this value
5772
optional int32 cmd_enable = 5;
73+
// Not used by BodyLower
74+
// Used by BodyUpper. Might be a disable
5875
repeated int32 ens = 6;
5976
repeated float kp = 10;
6077
repeated float kd = 11;

0 commit comments

Comments
 (0)