The AntRadioInterface class library defines interfaces and classes that implementations support and clients utilize. Implementations will derive and implement the interfaces appropriate to the underlying hardware that supports the ANT radio protocol. Clients will interact with an implementation of the AntRadioInterface to communicate with ANT devices.
Implementations at a minimum implement the IAntRadio and IAntChannel interfaces and derive concrete classes from AntResponse and DeviceCapabilities. Implementations may optionally support IAntConfiguration, IAntControl, IAntUsbRadio, ICrypto, and IFitSettings interfaces.
Tip
Implementations are free to implement the interfaces the underlying hardware supports. Even specific methods of required interfaces can and should throw NotImplementedException() if hardware doesn't support a particular method. This informs the application developer that the client and implementation are not aligned regarding expected functionality.
These interfaces/classes largely mirror the Garmin/Dynastream ANT Message Protocol and Usage specification.
Mandatory. Implementations will derive from these classes and provide constructors that take the underlying hardware data as an argument to populate the properties exposed by these classes.
Mandatory. Methods that must be implemented are InitializeContinuousScanMode(), GetChannel(), GetDeviceCapabilities(), RequestMessageAndResponse() and the properties NumChannels, ProductDescription, SerialNumber and Version.
Mandatory. SendExtAcknowledgedData/SendExtAcknowledgedDataAsync methods must be implemented; they are integral to working with ANT devices. The only property is ChannelNumber which should be assigned a value relevent to the implementation.
Tip
Implementors: Consider using locks for methods that transmit data to ANT devices. The intent is to prevent overwriting the channel ID and data until the transmission succeeds or times out.
Optional. Implementors will provide methods to configure the ANT radio.
Optional. Implementors will provide methods to control general operation of the ANT radio.
Optional. Implementors will provide methods and properties specific to ANT radios connected to USB ports.
Optional. Implementors will provide methods to configure cryptographic functions used by the ANT radio.
Optional. Implementors will provide methods to manage the ANT radio fitness equipment state.