redux::canand::CanandAddress Class Reference

#include <CanandAddress.h>

Public Member Functions
	CanandAddress (CANBus &bus, uint8_t devType, uint8_t prodId, uint8_t devId)
	CanandAddress (uint8_t devType, uint8_t prodId, uint8_t devId)
bool	MsgMatches (CanandMessage &msg)
bool	SendCANMessage (uint8_t apiIndex, uint8_t *data, uint8_t length)
uint8_t	GetDeviceType ()
uint8_t	GetProductId ()
uint8_t	GetDeviceId ()

Detailed Description

Class representing the exact combination of CAN bus, product IDs, and device IDs that uniquely correspond to a Redux CAN device on a robot.

The full 29-bit CAN ID that actually gets put on the bus can be broken down into four components:

1. A 5 bit device type (devType) that is product specific (the Canandcoder is 7 for "gear tooth sensor")
2. an 8-bit manufacturer code unique to each vendor (the Redux code is 14)
3. 10 bits of API identifier
4. a 6-bit device number (devId) that is user-configurable so you can have multiple of a device on a bus (this is what the "CAN Id" in robot code and vendor tuners usually refer to)

The WPILib docs elaborate on this in a bit more detail. Of note is that it breaks down the 10-bit API identifier into a 6-bit API class and 4-bit API index. Redux products, however, break it down into a 5 bit product API ID (prodID) that is generally product specific (the Canandcoder prodId is 0) and a 5 bit API index (apiIndex), which actually gets used for a device's CAN API.

The breakdown can be seen in the diagram provided below:

+-------------------+-------------------------------+-------------------+-----------------------+-------------------+
|      devType      | manufacturer ID   (redux=0xE) | apiclass (prodId) |        apiIndex       | Device ID (devID) |
+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
| 28| 27| 26| 25| 24| 23| 22| 21| 20| 19| 18| 17| 16| 15| 14| 13| 12| 11| 10|  9|  8|  7|  6|  5|  4|  3|  2|  1|  0|
+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Documentation on what each apiIndex value does as well as DBCs for Redux devices is available at https://docs.reduxrobotics.com/

In summary, to check if an incoming CAN message is from the device the CanandAddress represents, it needs to check:

• the devType
• the prodId
• the devId
• and the CAN bus the message was sent from, as different devices on different buses can share identical IDs

to ensure they all match, leaving the apiIndex to be parsed by device class code. (The manufacturer ID is filtered for in the native driver portion of ReduxLib.)

Subclasses of CanandDevice will use this class for CAN i/o to a device, as this class provides a method to send CAN packets to the device it describes, and the internal event loop uses it to determine which messages to give to CanandDevice::HandleMessage by checking them against MsgMatches, yielding an asynchronous method of receiving packets.

Constructor & Destructor Documentation

CanandAddress() [1/2]

redux::canand::CanandAddress::CanandAddress ( CANBus &  bus, uint8_t  devType, uint8_t  prodId, uint8_t  devId  )

inline

Constructor with explicit CAN bus.

Parameters

bus	the CANBus the address is associated with.
devType	the device type
prodId	the product id
devId	the device CAN id

CanandAddress() [2/2]

redux::canand::CanandAddress::CanandAddress ( uint8_t  devType, uint8_t  prodId, uint8_t  devId  )

inline

Constructor with implicit Rio CAN bus.

Parameters

devType	the device type
prodId	the product id
devId	the device CAN id

Member Function Documentation

GetDeviceId()

uint8_t redux::canand::CanandAddress::GetDeviceId ( )

inline

Returns the user-settable device ID.

Returns

the device ID

GetDeviceType()

uint8_t redux::canand::CanandAddress::GetDeviceType ( )

inline

Returns the 5-bit device type.

Returns

the device type

GetProductId()

uint8_t redux::canand::CanandAddress::GetProductId ( )

inline

Returns the 5-bit product ID section of the API index.

Returns

the product ID

MsgMatches()

bool redux::canand::CanandAddress::MsgMatches ( CanandMessage &  msg )

inline

Checks if a CAN message matches against the device type, product id, and device can id

Parameters

msg	a CanandMessage matching

Returns

if there is a match

SendCANMessage()

bool redux::canand::CanandAddress::SendCANMessage	(	uint8_t	apiIndex,
		uint8_t *	data,
		uint8_t	length
	)

Sends a CAN message to the CanandAddress.

Parameters

apiIndex	the API index the message should have (between 0-31 inclusive)
data	1-8 bytes of payload, as an array or pointer
length	the length of the the payload buffer

Returns

if the operation was successful

---

The documentation for this class was generated from the following file:

• src/main/native/include/redux/canand/CanandAddress.h