This class controls an ArbotiX, USBDynamixel, or similar board through a serial connection. More...

Inheritance diagram for arbotix_python.arbotix.ArbotiX:

Public Member Functions
def	__init__
	Constructs an ArbotiX instance and opens the serial connection.
def	disableTorque
	Turn on the torque of a servo.
def	disableWheelMode
	Put a servo into servo mode.
def	enableTorque
	Turn on the torque of a servo.
def	enableWheelMode
	Put a servo into wheel mode (continuous rotation).
def	execute
	Send an instruction to the device.
def	getAnalog
	Get the value of an analog input pin.
def	getDigital
	Get the value of an digital input pin.
def	getPacket
	Read a dynamixel return packet in an iterative attempt.
def	getPosition
	Get the position of a servo.
def	getReturnLevel
	Get the return level of a device.
def	getTemperature
	Get the temperature of a device.
def	getVoltage
	Get the voltage of a device.
def	isMoving
	Determine if a device is moving.
def	read
	Read values of registers.
def	rescan
	Force the ArbotiX2 to rescan the Dynamixel busses.
def	setBaud
	Set baud rate of a device.
def	setDigital
	Get the value of an digital input pin.
def	setLed
	Set the status of the LED on a servo.
def	setPosition
	Set the position of a servo.
def	setReturnLevel
	Set the return level of a device.
def	setServo
	Set the position of a hobby servo.
def	setSpeed
	Set the speed of a servo.
def	setWheelSpeed
	Set the speed and direction of a servo which is in wheel mode (continuous rotation).
def	syncRead
	Read values of registers on many servos.
def	syncWrite
	Write values to registers on many servos.
def	write
	Write values to registers.
Public Attributes
	error
	The last error level read back.
Static Public Attributes
int	ANA_BASE = 18
	Register address of first analog port (read only).
int	BACKWARD = 1
	Direction definition for setWheelSpeed.
int	FORWARD = 0
	Direction definition for setWheelSpeed.
int	HIGH = 0xff
	Helper definition for analog and digital access.
int	INPUT = 0
	Helper definition for analog and digital access.
int	LOW = 0
	Extended ArbotiX Driver.
int	OUTPUT = 0xff
	Helper definition for analog and digital access.
int	REG_DIGITAL_IN0 = 5
	Register base address for reading digital ports.
int	REG_DIGITAL_IN1 = 6
int	REG_DIGITAL_IN2 = 7
int	REG_DIGITAL_IN3 = 8
int	REG_DIGITAL_OUT0 = 47
int	REG_RESCAN = 15
	Register address for triggering rescan.
int	SERVO_BASE = 26
	Register address of analog servos.
Private Attributes
	_mutex
	_ser

Detailed Description

This class controls an ArbotiX, USBDynamixel, or similar board through a serial connection.

Definition at line 38 of file arbotix.py.

Constructor & Destructor Documentation

def arbotix_python.arbotix.ArbotiX.__init__	(	self,
		port = `"/dev/ttyUSB0"`,
		baud = `115200`,
		timeout = `0.1`
	)

Constructs an ArbotiX instance and opens the serial connection.

Parameters:

port	The name of the serial port to open.
baud	The baud rate to run the port at.
timeout	The timeout to use for the port. When operating over a wireless link, you may need to increase this.

Definition at line 48 of file arbotix.py.

Member Function Documentation

def arbotix_python.arbotix.ArbotiX.disableTorque	(	self,
		index
	)

Turn on the torque of a servo.

Parameters:

index The ID of the device to disable.

Returns:: The error level.

Definition at line 268 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.disableWheelMode	(	self,
		index,
		resolution = `10`
	)

Put a servo into servo mode.

Parameters:

index	The ID of the device to write.
resolution	The resolution of the encoder on the servo. NOTE: if using 12-bit resolution servos (EX-106, MX-28, etc), you must pass resolution = 12.

Returns:

Definition at line 361 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.enableTorque	(	self,
		index
	)

Turn on the torque of a servo.

Parameters:

index The ID of the device to enable.

Returns:: The error level.

Definition at line 260 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.enableWheelMode	(	self,
		index
	)

Put a servo into wheel mode (continuous rotation).

Parameters:

index The ID of the device to write.

Definition at line 350 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.execute	(	self,
		index,
		ins,
		params,
		ret = `True`
	)

Send an instruction to the device.

Parameters:

index	The ID of the servo to write.
ins	The instruction to send.
params	A list of the params to send.
ret	Whether to read a return packet.

Returns:: The return packet, if read.

Definition at line 124 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.getAnalog	(	self,
		index
	)

Get the value of an analog input pin.

Parameters:

index The ID of the pin to read (0 to 7).

Returns:: 8-bit analog value of the pin, -1 if error.

Definition at line 430 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.getDigital	(	self,
		index
	)

Get the value of an digital input pin.

Parameters:

index The ID of the pin to read (0 to 31).

Returns:: 0 for low, 255 for high, -1 if error.

Definition at line 441 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.getPacket	(	self,
		mode,
		id = `-1`,
		leng = `-1`,
		error = `-1`,
		params = `None`
	)

Read a dynamixel return packet in an iterative attempt.

Parameters:

mode	This should be 0 to start reading packet.

Returns:: The error level returned by the device.

Definition at line 65 of file arbotix.py.

def arbotix_python.arbotix.ArbotiX.getPosition	(	self,
		index
	)

Get the position of a servo.

Parameters: