STMicroelectronics STEVAL-IHP005V1 - Page 31

DocID024383 Rev 1 31/56
UM1619 Firmware description
At this level are available all the communication APIs and all the APIs for the application
engine interfacing.
In the main file, the following code is implemented for running the state machine engines:
main(void)
{
/* System initialization */
APP_ApplicationInit();
/* Infinite loop */
while (1)
{
/* USER program execution, defined in “user.c” and “user.h” files */
USER_Program();
/* Application stack engine */
APP_StackUpdate();
}
}
After the initialization the infinite loop calls two main functions: the USER_Program() and the
APP_StackUpdate() routine. The latter is the application engine state machine which inside
runs the PLM stack state machine, while the first one calls the user program.
The user program implemented in this user manual implements a bridge between the power
line communication and the COM port: each data received from the COM port addressed to
another PLM module is sent via PLM, and vice-versa each data received from PLM is sent
back to the COM port. It is necessary that the user program does not stop the core
operations (looping instructions) without calling the application engine.
All the firmware configurations are contained in the interfaceconfig.h file. Here the user can
define the default working mode and all the default values of the module parameters.
The following paragraphs list all the data types and the APIs used in the application engine,
that can be modified by the user if different needs arise.