boardRequestOption (Function)

The boardRequestOption function makes it possible to request options from the Option Server directly from the RTCU device. The functionality is equal to the RTCU IDE Request Option functionality.

When an option is requested, the option server at Logic IO is contacted through the internet by using the supplied account credentials. If there are sufficient credits for the requested option(s), the transaction will be made and the options activated on the device.

To use the request option functionality, it is therefore necessary to have an account with a positive credit established at Logic IO with a given user name/password.

Note that the device must be reset before the changes take effect (for example by using boardReset).

Note: using this function will deduct the credit on the account used and constitutes a non-refundable purchase.

Input:

user : STRING

The user name used to connect to the option server. Case sensitive.

pass : STRING

The password used to connect to the option server. Case sensitive.

options : STRING

The list of options to apply. The options are case sensitive and multiple options must be separated with spaces.

To find an up-to-date list of the possible options and prices for a specific target, use the IDs from Request Options in the RTCU IDE.

The following devices currently supports the options listed below:

CX1 series

CX1 flex / CX1i flex

CX1 warp

CX1 warp-c

DX4 Series

DX4 flex / DX4i warp

MX2 Series

MX2 warp

MX2 encore

MX2 eco+

AX9 Series

AX9 pro / AX9 pro-x / AX9i pro / AX9 turbo

AX9 encore

Returns:

Declaration:

FUNCTION boardRequestOption : INT;
VAR_INPUT
  user   : STRING;
  pass   : STRING;
  options : STRING;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  rc:INT;
END_VAR;
  ...
  ...
  IF boardGetProfileX(index := 13) = 0 THEN
    gsmPower(power:=ON);
    gprsOpen();    
    WHILE NOT gprsConnected() DO  
        Sleep(delay:=2500);  
    END_WHILE;  
     rc:= boardRequestOption(user:="user", pass:="pass",options:="FMI");
    IF rc >= 0 THEN
        DebugMsg(message := "Options enabled");
        // Make the RTCU device reset
        boardReset();
    END_IF;
  END_IF;
BEGIN
  ...
END;
END_PROGRAM;