Sensoray 2600 - Manual (Page 27)

Sensoray 2600 Programming Guide
23
Gateway Action Scheduling
Returns: Error code as described in section 5.5. Zero is returned if the operation was successful.
Benchmark: 0.8 ms.
Notes: Some IOM types have provision for installing address shunts. These shunts enable the system integrator to specify
an address for the module, with a value in the range 0 to 15 decimal. This function can be used to read the address
shunts from IOMs that include this hardware feature.
Example: // Fetch the address shunt settings from MM number 0, IOM port 6.
u8 shunts;
void *x = S26_SchedOpen( 0, 1 );
S26_Sched2600_GetAddress( x, 6, &shunts );
S26_SchedExecute( x, 1000, 0 );
printf( "Shunts = %d\n", shunts );
7.2.4 S26_Sched2600_GetFirmwareVersion()
Function: Schedules the fetching of the firmware version number from an IOM or the gateway.
Prototype: u32 S26_Sched2600_GetFirmwareVersion( XACT x, IOMPORT IomPort, u16 *Version );
Returns: Error code as described in section 5.5. Zero is returned if the operation was successful.
Benchmark: 0.9 ms for IOMs, or 0.1 ms for the gateway.
Example: // Fetch the IOM firmware version number from MM number 0, IOM port 6.
u8 vers[2];
void *x = S26_SchedOpen( 0, 1 );
S26_Sched2600_GetFirmwareVersion( x, 6, &vers );
S26_SchedExecute( x, 1000, 0 );
printf( "IOM version number = %d.%d\n", vers[0], vers[1] );
Example: // Fetch the firmware version number from MM number 0.
u8 vers[2];
void *x = S26_SchedOpen( 0, 1 );
S26_Sched2600_GetFirmwareVersion( x, MODID_GATEWAY, &vers );
S26_SchedExecute( x, 1000, 0 );
printf( "MM version number = %d.%d\n", vers[0], vers[1] );
7.2.5 S26_Sched2600_IomGetProductID()
Function: Schedules the fetching of the model number from an IOM or the gateway.
Prototype: u32 S26_Sched2600_IomGetProductID( XACT x, IOMPORT IomPort, u16 *ProductID );
Parameter Type Description
x void * Transaction handle obtained from S26_SchedOpen().
IomPort u8 The IOM port number (on the MM) to which the target IOM is connected, or 0xFF if
the gateway is the target.
Version u16 * Pointer to a 16-bit application buffer that will receive the target IOM’s version number
as two decimal values. The first byte is the major version number. The second byte is
the minor version number.
Parameter Type Description
x void * Transaction handle obtained from S26_SchedOpen().
IomPort u8 The IOM port number (on the MM) to which the target IOM is connected, or 0xFF if
the gateway is the target.
ProductID u16 * Pointer to a 16-bit application buffer that is to receive the product identifier. The
product identifier is always expressed as a decimal value.