rfbcSendButtonPress (Function)

 Top  Previous  Next

Architecture:

X32 / NX32L

Device support:

AX9 pro, CX1 pro/pro-c/warp/warp-c, SX1, AX9 turbo, NX-900, LX5

Firmware version:

2.60 / 1.51.00

This function will send a remote button press notification.

Most devices will only accept button press requests when paired with the RTCU device.

 

Note: on some devices, the button number may also be referred to as a channel.

 

 

Input:

id  : DINT [0 .. 16_777_215] (default 0)

The ID of the device to receive the notification.

If the ID is 0 (zero), the notification will be broadcast.

 

button : SINT [0 .. 63] (default 1)

The index of the button that is pressed.

 

long : BOOL (default FALSE)

TRUE

-

The button is pressed and held down.

FALSE

-

The button is pressed.

 

low : BOOL (default FALSE)

TRUE

-

Report that the RTCU battery level is low.

FALSE

-

Report that the RTCU battery level is normal.

 

Output:

None.

 

Returns: INT

0

-

The notification is sent.

-1

-

Interface is not open (see rfbcOpen).

-4

-

RF communication is not available.

-5

-

Communication error - addressed message sent but not confirmed

-6

-

Error in parameter.

 

Declaration:

FUNCTION rfbcSendButtonPress : INT;
VAR_INPUT
  id          : DINT := 0;
  button      : SINT := 1;
  long        : BOOL := FALSE;
  low         : BOOL := FALSE;
END_VAR;

 

Example:

INCLUDE rtcu.inc
 
PROGRAM example;
rfbcOpen();
BEGIN
 ...
 rfbcSendButtonPress(id := 0, button := 1);
 ...
END;
END_PROGRAM;