hebi::Command Class Reference

Command objects have various fields that can be set; when sent to the module, these fields control internal properties and setpoints. More...

#include <command.hpp>

Classes
class	Actuator
	Actuator-specific commands. More...
class	BoolField
	A message field representable by a bool value. More...
class	EnumField
	A message field representable by an enum of a given type. More...
class	FlagField
	A two-state message field (either set/true or cleared/false). More...
class	FloatField
	A message field representable by a single-precision floating point value. More...
class	HighResAngleField
	A message field for an angle measurement which does not lose precision at very high angles. More...
class	Io
	Any available digital or analog output pins on the device. More...
class	IoBank
	A message field for interfacing with a bank of I/O pins. More...
class	LedField
	A message field for interfacing with an LED. More...
class	NumberedFloatField
	A message field containing a numbered set of single-precision floating point values. More...
class	Settings
	Module settings that are typically changed at a slower rate. More...
class	StringField
	A message field representable by a std::string. More...

Public Types
enum	ControlStrategy {   ControlStrategy::Off, ControlStrategy::DirectPWM, ControlStrategy::Strategy2, ControlStrategy::Strategy3,   ControlStrategy::Strategy4 }

Public Member Functions
	Command (Command &&other)
	Move constructor (necessary for containment in STL template classes) More...
	~Command () noexcept
	Cleans up command object as necessary. More...
Io &	io ()
	Any available digital or analog output pins on the device. More...
const Io &	io () const
	Any available digital or analog output pins on the device. More...
Settings &	settings ()
	Module settings that are typically changed at a slower rate. More...
const Settings &	settings () const
	Module settings that are typically changed at a slower rate. More...
Actuator &	actuator ()
	Actuator-specific commands. More...
const Actuator &	actuator () const
	Actuator-specific commands. More...
LedField &	led ()
	The module's LED. More...
const LedField &	led () const
	The module's LED. More...

Protected Types
using	CommandGains = Gains< HebiCommandPtr, FloatField, BoolField, HebiCommandFloatField, HebiCommandBoolField >

Detailed Description

Command objects have various fields that can be set; when sent to the module, these fields control internal properties and setpoints.

This object has a hierarchical structure – there are some direct general-purpose fields at the top level, and many more specific fields contained in different nested subobjects.

The subobjects contain references to the parent command object, and so should not be used after the parent object has been destroyed.

The fields in the command object are typed; generally, these are optional-style read/write fields (i.e., have the concept of get/set/has/clear), although the return types and exact interface vary slightly between fields. Where appropriate, the explicit bool operator has been overridden so that you can shortcut if(field.has()) by calling if(field).

Although this header file can be used to look at the hierarchy of the messages, in general the online documentation at apidocs.hebi.us presents this information. in a more readable form.

Member Typedef Documentation

using hebi::Command::CommandGains = Gains<HebiCommandPtr, FloatField, BoolField, HebiCommandFloatField, HebiCommandBoolField>

protected

Member Enumeration Documentation

enum hebi::Command::ControlStrategy

strong

Enumerator
Off	The motor is not given power (equivalent to a 0 PWM value)
DirectPWM	A direct PWM value (-1 to 1) can be sent to the motor (subject to onboard safety limiting).
Strategy2	A combination of the position, velocity, and effort loops with P and V feeding to T; documented on docs.hebi.us under "Control Modes".
Strategy3	A combination of the position, velocity, and effort loops with P, V, and T feeding to PWM; documented on docs.hebi.us under "Control Modes".
Strategy4	A combination of the position, velocity, and effort loops with P feeding to T and V feeding to PWM; documented on docs.hebi.us under "Control Modes".

Constructor & Destructor Documentation

hebi::Command::Command

(

Command &&

other

)

Move constructor (necessary for containment in STL template classes)

hebi::Command::~Command ( )

noexcept

Cleans up command object as necessary.

Member Function Documentation

Io& hebi::Command::io ( )

inline

Any available digital or analog output pins on the device.

const Io& hebi::Command::io ( ) const

inline

Any available digital or analog output pins on the device.

Settings& hebi::Command::settings ( )

inline

Module settings that are typically changed at a slower rate.

const Settings& hebi::Command::settings ( ) const

inline

Module settings that are typically changed at a slower rate.

Actuator& hebi::Command::actuator ( )

inline

Actuator-specific commands.

const Actuator& hebi::Command::actuator ( ) const

inline

Actuator-specific commands.

Command::LedField & hebi::Command::led

(

)

The module's LED.

const LedField& hebi::Command::led

(

)

const

The module's LED.

---

The documentation for this class was generated from the following files:

• src/command.hpp
• src/command.cpp