Previous

Next

Function USBAX172Init

USBAX172Init must be called by the network driver at program startup for each interface to be supported:

int USBAX172Init(int DeviceIndex, void * DriverID);

Parameters

DeviceIndex

Zero-based index of the AX172 interface. The default configuration of the driver accepts values in the range 0 to 7. The first AX172 device to be attached can be addressed with index 0, the second with 1, etc.

DriverID

The value the AX172 driver should pass to system driver functions RTUSYSNewEthernetDevice and RTUSYSPostEthernetFrame. This parameter has no meaning to the AX172 driver itself. It can be used by the network stack driver to identify an interface. If this parameter is NULL, the AX172 driver will no longer call RTUSYSNewEthernetDevice or RTUSYSPostEthernetFrame for this device index.

return value

RTU_SUCCESS or a negative error code on failure. Code RTU_DISCONNECTED means that no AX172 device is currently connected on the given index, but the interface can be used if one is attached at a later time.

No packets are sent or received as long as this function has not been called with a non-NULL DeviceID. If an AX172 device is available at the time USBAX172Init is called, USBAX172Init calls system driver function RTUSYSNewEthernetDevice. Otherwise RTUSYSNewEthernetDevice may be called at a later time when a device is attached.

At program shutdown, it is recommended to call this function with parameter DriverID set to NULL.

Function USBAX172

Function USBAX172Status