XF Ports
Introduction
A XF (execution framework) consists of a view classes which some need to be adjusted when used on another platform.
Following you will find a list of classes which may be adjusted/reimplemented when changing to another platform/environment:
XFTimeoutManagerDispatcherEventQueueMutex
These classes are also named port classes because they can be ported to another
platform. All port classes can be found in the port folder whereas every port is
located in a separate folder.
Every port may pick some default implementation classes from the common folder also located in the port folder.
Common Port Classes
There are already some common port class implementations present. You can find
them in the common folder and may suit your needs for a first version
of your XF. These default port classes are platform independent and can be
used by any port implementation.
Note
Be carefull when changing the code of a class in the common folder. It may affect other ports and cause them to no more work correctly!
Port Folder Structure
In case you want to add support for another platform to the XF, you need to add a subfolder to the port folder and put the port class files in there. Best is, to take an already present port which is most similar to what you need, rename it and start adaption of these files.
You may also mix-up your port with classes from the common folder and your custom folder (or even reference classes from other ports).
Available Ports
Here is a list of currently available ports:
| Port Name | OS | Platform | Folder Name | Description |
|---|---|---|---|---|
| PORT_IDF_QT | Qt (IDF) | Qt library based implementation | idf-qt | XF support for macOS, Linux and Windows |
| PORT_IDF_STM32 | Bare-Metal (IDF) | STM32CubeIDE/STM32CubeMX based port | idf-stm32 | XF for ARM Cortex based microcontrollers from STMicroelectronics |