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 16 © Siemens AG 2011 Control Products and Systems
Subject to change without further notice. P. O. Box 10 09 53,
D-93009 Regensburg
Description
:
Copies ‘len’ bytes from ‘src’ to the send buffer if it is empty. After sending the result is
stored in ‘result’.
Parameters
:
BYTE* src:
A pointer to data that should be transmitted
BYTE len:
The number of bytes that should be transmitted
BYTE* result:
A pointer to a byte where the result of the FT12 transmit will be stored
Return values
:
true: the data was copied to send buffer
false: the send buffer was not free, so no data has been copied
Callable in / at:
main
Stack used: 8 bytes
Comment:
---
2.6.3 Function FT12Get
Prototype:
BOOL FT12Get(BYTE* dst, BYTE* len)
Description
:
Tests if there was a frame received over FT12. If this is the case the received data is
copied to ‘dst’ and the length is written to ‘len’.
Parameters
:
BYTE* dst:
A pointer to a data buffer where the received data should be copied
BYTE* len:
A pointer to a byte where the number of copied bytes is written
Return values
:
true: there was a frame received over FT12 and the data has been copied to ‘dst’
false: no data was received over FT12
Callable in / at:
main
Stack used: 8 bytes
Comment:
---
2.7 Handshake
The following functions are used to send and receive frames via handshake protocol. It is not
recommend using these functions for new implementations.