Rabbit RabbitCore RCM3309 User Manual page 175

Distributor of Digi International: Excellent Integrated System Limited
Datasheet of 20-101-1194 - MODULE RABBITCORE RCM3309 ROHS
Contact us: sales@integrated-circuit.com Website: www.integrated-circuit.com
int rn_find(rn_search *srch);
DESCRIPTION
Locates the first active device that matches the search criteria.
PARAMETER
srch
unsigned int flags;
unsigned int ports;
char productid;
char productrev;
char coderev;
long serialnum;
Use a maximum of 3 macros for the search criteria:
RN_MATCH_PORT
RN_MATCH_PNA
RN_MATCH_HANDLE
RN_MATCH_PRDID
RN_MATCH_PRDREV
RN_MATCH_CODEREV
RN_MATCH_SN
For example:
rn_search newdev;
newdev.flags = RN_MATCH_PORT|RN_MATCH_SN;
newdev.ports = 0x03; //search ports 0 and 1
newdev.serialnum = E3446C01L;
handle = rn_find(&newdev);
RETURN VALUE
Returns the handle of the first device matching the criteria.
0 indicates no such devices were found.
SEE ALSO
rn_device
168
rn_find
the search criteria structure
// status flags see MATCH macros below
// port bitmask
// product id
// product rev
// code rev
// serial number
// match port bitmask
// match physical node address
// match instance (reg 3)
// match id/version (reg 1)
// match product revision
// match code revision
// match serial number
rn_search:
RabbitCore RCM3309/RCM3319