Feetech.Error (feetech v0.2.2)

Error handling for Feetech servo responses.

The status byte in response packets contains bit flags indicating various error conditions and the torque enable state.

Status Byte Bits

Bit	Name	Description
0	Voltage	Over/under voltage detected
1	Sensor	Magnetic encoder error
2	Temperature	Over temperature
3	Current	Over current
4	Torque	Torque is enabled (not an error)
5	Overload	Overload protection triggered

Summary

Types

error()

status_info()

Functions

describe(other)

Converts error atoms to human-readable descriptions.

error?(status)

Returns true if the status byte indicates any error.

parse_status(status)

Parses a status byte into a structured result.

Types

error()

@type error() ::
  :voltage_error
  | :sensor_error
  | :temperature_error
  | :current_error
  | :overload_error
  | :no_response
  | :invalid_checksum
  | :invalid_packet
  | :incomplete_packet
  | :invalid_header
  | :unknown_register
  | :timeout

status_info()

@type status_info() :: %{errors: [error()], torque_enabled: boolean()}

Functions

describe(other)

@spec describe(error()) :: String.t()

Converts error atoms to human-readable descriptions.

error?(status)

@spec error?(non_neg_integer()) :: boolean()

Returns true if the status byte indicates any error.

parse_status(status)

@spec parse_status(non_neg_integer()) :: status_info()

Parses a status byte into a structured result.

Returns a map with detected errors and torque state.

Examples

iex> Feetech.Error.parse_status(0x00)
%{errors: [], torque_enabled: false}

iex> Feetech.Error.parse_status(0x10)
%{errors: [], torque_enabled: true}

iex> Feetech.Error.parse_status(0x25)
%{errors: [:voltage_error, :temperature_error, :overload_error], torque_enabled: false}