User Manual

GAMMA instabus
Release: December 2011
API-Reference for Bus Interface Modules M130, M131, M132, M135
KNX-Processors 184/01, 184/11, 184/21
Technical Manual pages 28 Siemens AG
Infrastructure and Cities Sector,
Building Technologies
page 4 © Siemens AG 2011 Control Products and Systems
Subject to change without further notice. P. O. Box 10 09 53,
D-93009 Regensburg
DEBOUNCEKIT* kit:
A pointer to a structure of type DEBOUNCEKIT
USHORT debouncetime:
The minimum number of ticks the value must remain unchanged. One tick is
equal to
6.416
µs.
Return values
:
none
Callable in / at:
main
Stack used:
22 bytes
Comment:
The mask must always be the same for a specific DEBOUNCEKIT.
The maximum debounce time is 10 seconds (24,000 ticks).
2.2 Object-Handling
The following functions are used to get and set flags on communication objects.
2.2.1 Function TestAndCopyObject
Prototype:
BOOL TestAndCopyObject(USHORT objectNr, void* dst, BYTE len)
Description
:
This function tests if there was an update for an object given by ‘objectNr’. If this is
the case ‘len’ bytes of the object value are copied to ‘dst’.
Parameters:
USHORT objectNr:
The object number
void* dst:
A pointer to RAM where the object data should be copied
BYTE len:
The number of bytes that should be copied from the object data to ‘dst’
Return values
:
true: there was an update and the object data was copied to 'dst’
false: there was no update
Callable in / at:
interrupts, main
Stack used:
24 bytes
Comment:
This function handles the lock of the task switch in the critical sections automatically.