User Manual

GAMMA instabus
Release: 12/2015
Application Program Bus Interface Modules M130, M131, M132 and M135
Runtime Environment for KNX-Processors 184/11 and 184/21
Technical Manual pages 17 Siemens AG
Building Technologies
Control Products and Systems
page 10 © Siemens AG 2015 P. O. Box 10 09 53,
Subject to change without further notice. D-93009 Regensburg
4 Communication object handling
All communication objects of the application program are defined in table ‘EE_CommsTab’.
The table starts with a byte that specifies the number of communication objects. The next
byte is only implemented for compatibility and should be 0x00. After this per communication
object three bytes are defined. For the first byte ‘VALID_BCU2ADR’ is always used. This is
done for compatibility. The second byte specifies the communication object flags and the
third byte the size of the communication object. See ‘ConfigByte’ and ‘Typebyte’ in
‘BIM_M13x.h’ for the possible values.
The interface between the user application program and the operating system are the ram
flags. The user application program must provide one nibble of ram for each communication
object. This is done by defining the following array:
BYTE RAMFlags[(NUM_OF_COM_OBJ / 2) + 1];
That means an array is created that has half byte of the number of communication objects.
The pointer to this array must be specified in the application info block. The API functions
that are described in the API-Reference at the point “Object-Handling” act on the ram flags.
Each time an update for a communication object was received the operating system sets the
ram flags and stores the new value in the user application ram. Therefore the user
application program has to specify a table with pointers for each communication object
(name: CObjects). The first pointer must point to a byte that contains the number of entries in
the table. The number of entries must be the same as in ‘EE_CommsTab’. The next pointer
is the pointer to a ram variable for communication object 0, the next pointer for
communication object 1 and so on.
The address of this table has to be specified in the application info block.