Logo
UNICENS V2.3.0-4567
User Manual and API Reference
Ucs_Return_t Ucs_Supv_ProgramNode ( Ucs_Inst_t self,
uint16_t  node_pos_addr,
Ucs_Signature_t signature_ptr,
Ucs_Prg_Command_t commands_ptr,
Ucs_Prg_ReportCb_t  result_fptr 
)

Starts the programming sequence for a remote node.

Attention
This function can only be executed in supervisor mode UCS_SUPV_MODE_PROGRAMMING.
Parameters
selfThe UNICENS instance pointer.
node_pos_addrThe node position address of the target node. The application must take care that the signature of all nodes are unique and that node_pos_addr is the same as specified withing the provided signature.
signature_ptrReference to the signature of the node to be programmed.
commands_ptrReference to the programming commands.
result_fptrUser defined callback function notifying the programming result.
Returns
Possible return values are shown in the table below.
Value Description
UCS_RET_SUCCESS No error
UCS_RET_ERR_PARAM The parameter self is NULL.
UCS_RET_ERR_ALREADY_SET The new operation mode is already set.
UCS_RET_ERR_NOT_SUPPORTED API is not supported in the current Network Supervisor Mode.
UCS_RET_ERR_NOT_INITIALIZED UNICENS is not initialized.