PDO

class ingeniamotion.pdo.PDOPoller(mc, servo, refresh_time, watchdog_timeout, buffer_size)

Poll register values using PDOs.

start()

Start the poller.

Return type:: None

stop()

Stop the poller.

Return type:: None

property data: tuple[list[float], list[list[int | float | bytes]]]

Get the poller data. After the data is retrieved, the data buffers are cleared.

Return type:: tuple[list[float], list[list[Union[int, float, bytes]]]]
Returns:: A tuple with a list of the readings timestamps and a list of lists with the readings values.

add_channels(registers)

Configure the PDOs with the registers to be read.

Parameters:: registers (list[dict[str, Union[int, str]]]) – list of registers to add to the Poller.
Return type:: None

subscribe_to_exceptions(callback)

Get notified when an exception occurs on the PDO thread.

Parameters:: callback (Callable[[IMError], None]) – Function to be called when an exception occurs.
Return type:: None

property available_samples: int

Number of samples in the buffer.

Return type:: int

class ingeniamotion.pdo.PDONetworkManager(motion_controller)

Manage all the PDO functionalities.

Parameters:: mc – The MotionController.

class ProcessDataThread(net, refresh_rate, watchdog_timeout, notify_send_process_data, notify_receive_process_data, notify_exceptions)

Manage the PDO exchange.

Parameters:

net (EthercatNetwork) – The EthercatNetwork instance where the PDOs will be active.
refresh_rate (Optional[float]) – Determines how often (seconds) the PDO values will be updated.
watchdog_timeout (Optional[float]) – The PDO watchdog time. If not provided it will be set proportional to the refresh rate.
notify_send_process_data (Callable[[], None]) – Callback to notify when process data is about to be sent.
notify_receive_process_data (Callable[[], None]) – Callback to notify when process data is received.
notify_exceptions (Callable[[IMError], None]) – Callback to notify when an exception is raised.

Raises:

ValueError – If the provided refresh rate is unfeasible.

run()

Start the PDO exchange.

Return type:: None

stop()

Stop the PDO exchange.

Return type:: None

static high_precision_sleep(duration)

Replaces the time.sleep() method.

This is done in order to obtain more precise sleeping times.

Return type:: None

create_pdo_item(register_uid, axis=1, servo='default', value=None)

Create a PDOMapItem by specifying a register UID.

Parameters:

register_uid (str) – Register to be mapped.
axis (int) – servo axis. 1 by default.
servo (str) – servo alias to reference it. default by default.
value (Union[float, int, None]) – Initial value for an RPDO register.

Return type:

Union[RPDOMapItem, TPDOMapItem]

Returns:

Mappable PDO item.

Raises:

ValueError – If there is a type mismatch retrieving the register object.
AttributeError – If an initial value is not provided for an RPDO register.

create_pdo_maps(rpdo_map_items, tpdo_map_items)

Create the RPDO and TPDO maps from PDOMapItems.

Parameters:

rpdo_map_items (Union[RPDOMapItem, list[RPDOMapItem]]) – The RPDOMapItems to be added to a RPDOMap.
tpdo_map_items (Union[TPDOMapItem, list[TPDOMapItem]]) – The TDOMapItems to be added to a TPDOMap.

Return type:

tuple[RPDOMap, TPDOMap]

Returns:

RPDO and TPDO maps.

static add_pdo_item_to_map(pdo_map_item, pdo_map)

Add a PDOMapItem to a PDOMap.

Parameters:

pdo_map_item (Union[RPDOMapItem, TPDOMapItem]) – The PDOMapItem.
pdo_map (Union[RPDOMap, TPDOMap]) – The PDOMap to add the PDOMapItem.

Raises:

ValueError – If an RPDOItem is tried to be added to a TPDOMap.
ValueError – If an TPDOItem is tried to be added to a RPDOMap.

Return type:

None

static create_empty_rpdo_map()

Create an empty RPDOMap.

Return type:: RPDOMap
Returns:: The empty RPDOMap.

static create_empty_tpdo_map()

Create an empty TPDOMap.

Return type:: TPDOMap
Returns:: The empty TPDOMap.

set_pdo_maps_to_slave(rpdo_maps, tpdo_maps, servo='default')

Map the PDOMaps to the slave.

Parameters:

rpdo_maps (Union[RPDOMap, list[RPDOMap]]) – The RPDOMaps to be mapped.
tpdo_maps (Union[TPDOMap, list[TPDOMap]]) – he TPDOMaps to be mapped.
servo (str) – servo alias to reference it. default by default.

Raises:

ValueError – If there is a type mismatch retrieving the drive object.
ValueError – If not all elements of the RPDO map list are instances of a RPDO map.
ValueError – If not all elements of the TPDO map list are instances of a TPDO map.

Return type:

None

clear_pdo_mapping(servo='default')

Clear the PDO mapping within the servo.

Parameters:: servo (str) – servo alias to reference it. default by default.
Raises:: ValueError – If there is a type mismatch retrieving the drive object.
Return type:: None

remove_rpdo_map(servo='default', rpdo_map=None, rpdo_map_index=None)

Remove a RPDOMap from the RPDOMap list.

The RPDOMap instance or the index of the map in the RPDOMap list: should be provided.

Parameters:

servo (str) – servo alias to reference it. default by default.
rpdo_map (Optional[RPDOMap]) – The RPDOMap instance to be removed.
rpdo_map_index (Optional[int]) – The index of the RPDOMap list to be removed.

Raises:

ValueError – If the RPDOMap instance is not in the RPDOMap list.
IndexError – If the index is out of range.

Return type:

None

remove_tpdo_map(servo='default', tpdo_map=None, tpdo_map_index=None)

Remove a TPDOMap from the TPDOMap list.

The TPDOMap instance or the index of the map in the TPDOMap list should be provided.

Parameters:

servo (str) – servo alias to reference it. default by default.
tpdo_map (Optional[TPDOMap]) – The TPDOMap instance to be removed.
tpdo_map_index (Optional[int]) – The index of the TPDOMap list to be removed.

Raises:

ValueError – If the TPDOMap instance is not in the TPDOMap list.
IndexError – If the index is out of range.

Return type:

None

start_pdos(network_type=None, refresh_rate=None, watchdog_timeout=None)

Start the PDO exchange process.

Parameters:

network_type (Optional[CommunicationType]) – Network type (EtherCAT or CANopen) on which to start the PDO exchange.
refresh_rate (Optional[float]) – Determines how often (seconds) the PDO values will be updated.
watchdog_timeout (Optional[float]) – The PDO watchdog time. If not provided it will be set proportional to the refresh rate.

Raises:

ValueError – If the refresh rate is too high.
ValueError – If the MotionController is connected to more than one Network.
ValueError – If network_type argument is invalid.
IMError – If the MotionController is connected to more than one Network.
ValueError – If there is a type mismatch retrieving the network object.
IMError – If the PDOs are already active.

Return type:

None

stop_pdos()

Stop the PDO exchange process.

Raises:: IMError – If the PDOs are not active yet.
Return type:: None

property is_active: bool

Check if the PDO thread is active.

Return type:: bool
Returns:: True if the PDO thread is active. False otherwise.

subscribe_to_send_process_data(callback)

Subscribe be notified when the RPDO values will be sent.

Parameters:: callback (Callable[[], None]) – Callback function.
Return type:: None

subscribe_to_receive_process_data(callback)

Subscribe be notified when the TPDO values are received.

Parameters:: callback (Callable[[], None]) – Callback function.
Return type:: None

subscribe_to_exceptions(callback)

Subscribe be notified when there is an exception in the PDO process data thread.

If a callback is subscribed, the PDO exchange process is paused when an exception is raised. It can be resumed using the resume_pdos method.

Parameters:: callback (Callable[[IMError], None]) – Callback function.
Return type:: None

unsubscribe_to_send_process_data(callback)

Unsubscribe from the send process data notifications.

Parameters:: callback (Callable[[], None]) – Subscribed callback function.
Return type:: None

unsubscribe_to_receive_process_data(callback)

Unsubscribe from the receive process data notifications.

Parameters:: callback (Callable[[], None]) – Subscribed callback function.
Return type:: None

create_poller(registers, servo='default', sampling_time=0.125, buffer_size=100, watchdog_timeout=None, start=True)

Create a register Poller using PDOs.

Parameters:

registers (list[dict[str, Union[int, str]]]) –

list of registers to add to the Poller. Dicts should have the follow format:

[
    { # Poller register one
        "name": "CL_POS_FBK_VALUE",  # Register name.
        "axis": 1  # Register axis.
        # If it has no axis field, by default axis 1.
    },
    { # Poller register two
        "name": "CL_VEL_FBK_VALUE",  # Register name.
        "axis": 1  # Register axis.
        # If it has no axis field, by default axis 1.
    }
]

servo (str) – servo alias to reference it. default by default.
sampling_time (float) – period of the sampling in seconds. By default 0.125 seconds.
watchdog_timeout (Optional[float]) – The PDO watchdog time. If not provided it will be set proportional to the refresh rate.
buffer_size (int) – number maximum of sample for each data read. 100 by default.
start (bool) – if True, function starts poller, if False poller should be started after. True by default.

Return type:

PDOPoller

Returns:

The poller instance.

unsubscribe_to_exceptions(callback)

Unsubscribe from the exceptions in the process data notifications.

Parameters:: callback (Callable[[IMError], None]) – Subscribed callback function.
Return type:: None