boardSetPassword (Function)

Top  Previous  Next

Architecture:

X32 / NX32 / NX32L

Device support:

All

Firmware version:

1.00 / 1.00.00


boardSetPassword sets the primary password that is used by the RTCU IDE (or any other RACP1/RACP2) client that will authenticate itself to the device.

If the primary password is empty, the RTCU device will not require a password for authentication.

 

It is also possible to use an alternative password in addition to the primary password with the boardSetPasswordAlt function

The primary password can be cleared by calling boardClearPassword.

 

Input:

curpsw : STRING (Max 20 characters)

The current password. Must be correct to set new password.

 

newpsw : STRING (Max 20 characters)

The new password.

An empty string will disable the password of the device.

 

Returns: BOOL

TRUE:

New password has been set.

FALSE:

Password is not set. Wrong or invalid password specified.

 

Declaration:

FUNCTION boardSetPassword : BOOL;
VAR_INPUT
  curpsw : STRING;
  newpsw : STRING;
END_VAR;

 

 

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
 
// Change password
boardSetPassword(curpsw:="12345",newpsw:="54321");
 
END_PROGRAM;