ParaLib 2.0.15-master SHA: 2e03d68caa
Grouping of parameters

All parameters are shown on PC in groups. These are defined on device with the Group structure. To create a new group, a global const variable with the datatype Group is defined. Normally this is done in file PARA_Main.c to have a central place for all parameter-groups.

  • The GroupID identifiers must be unique and are defined in the file "PARA_ID_Device.h".
  • The ParentGroupID refers to the base group. If the new group should be placed in the root use 0 as ParentGroupId.
  • The group name is shown in the PC-Tool.

Example with three groups:

static const Group G_Sys = { GROUP_ID_System, 0, "System"};
static const Group G_Hwid = { GROUP_ID_HWID, GROUP_ID_System, "Hardware Information"};
static const Group G_Fwid = { GROUP_ID_FWID, GROUP_ID_System, "Firmware Information"};
ParameterU16 FlashData1 ParameterU32 FlashData1 GROUP_ID_System
Definition: PARA_Flash_STM32H7.c:902
#define GROUP_ID_FWID
Definition: PARA_ID_System.h:20
#define GROUP_ID_HWID
Definition: PARA_ID_System.h:19
Parameter-group.
Definition: PARA_Lib.h:835

The groups must be added to the global const variable GruppenListe. This is done on initialization of this variable in the file PARA_Main.c.

const Group* GruppenListe[] =
{
&G_Sys,
&G_Hwid,
&G_Fwid,
}
const Group * GruppenListe[]
List of all existent parameter-groups in device. The list is filled by the paraInit function.