ParaLib 2.0.28-master SHA: b4a0dafd73
PARA_ParaAccess.c File Reference
#include <string.h>
#include "../lib/PARA/PARA_Lib.h"
#include "../lib/PARA/PARA_ID_System.h"
#include "project_Config.h"

Macros

#define DEFAULT_ACCESSCODE_USER   0x7B30378C
 
#define DEFAULT_ACCESSCODE_PROFESSIONAL   0x824B49AF
 
#define DEFAULT_ACCESSCODE_DEVELOPER   0x23EA7C12
 
#define PARA_STRING_MAX_LENGTH   16380
 Maximum length of the parameter strings (name, description, format, ...). The length is transfered as 2 byte 7BitEncodedInt (< 16384). More...
 

Enumerations

enum  ParameterStringType {
  STRING_TYPE_NAME , STRING_TYPE_DESCRIPTION , STRING_TYPE_FORMAT , STRING_TYPE_GROUP_NAME ,
  STRING_TYPE_SUBSTITUTION_TEXTS
}
 String type of a parameter or group, which is read by ReadParameterString() More...
 

Functions

int32_t ReadFunction_PARA_ParaId (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_GroupId (Parameter *ptThis, const ParameterRequest *ptRequest)
 
static int32_t ReadParameterString (Parameter *ptThis, const ParameterRequest *ptRequest, ParameterStringType tType)
 
int32_t ReadFunction_PARA_ParaName (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_ParaDescription (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_ParaFormat (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_Access (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_DataType (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_SubIdCount (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_GroupGroupId (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_GroupParent (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_GroupName (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_MinValue (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_MaxValue (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_DefaultValue (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_SubstText (Parameter *ptThis, const ParameterRequest *ptRequest)
 
int32_t ReadFunction_PARA_Flags (Parameter *ptThis, const ParameterRequest *ptRequest)
 
static int32_t ReadFunction_AccessPasscode (Parameter *ptThis, const ParameterRequest *ptRequest)
 
static int32_t WriteFunction_AccessPasscode (Parameter *ptThis, const ParameterRequest *ptRequest)
 

Variables

uint8_t g_ui8ActualAccessLevel =1
 Actual access-level (see Access restrictions). More...
 
uint8_t * g_pui8ActualAccessLevelPointer = &g_ui8ActualAccessLevel
 Pointer to the Actual access-level (see Access restrictions). More...
 
const ParaData_I32 ParaData_ParaCount
 
const Parameter PARA_ParaCount
 
const Parameter PARA_ParaId
 
const Parameter PARA_GroupId
 
const ParaData_STR ParaData_ParaName
 
const Parameter PARA_ParaName
 
const Parameter PARA_ParaDescription
 
const Parameter PARA_ParaFormat
 
const Parameter PARA_Access
 
const Parameter PARA_DataType
 
const Parameter PARA_SubIdCount
 
const ParaData_I32 ParaData_GroupCount
 
const Parameter PARA_GroupCount
 
const Parameter PARA_GroupGroupId
 
const Parameter PARA_GroupParent
 
const Parameter PARA_GroupName
 
const ParaData_F32 ParaData_MinValue
 
const Parameter PARA_MinValue
 
const Parameter PARA_MaxValue
 
const Parameter PARA_DefaultValue
 
const Parameter PARA_ParaSubstText
 
const Parameter PARA_Flags
 
const ParaData_U32 ParaData_AccessPasscode
 
const Parameter PARA_AccessCode
 

Macro Definition Documentation

◆ DEFAULT_ACCESSCODE_DEVELOPER

#define DEFAULT_ACCESSCODE_DEVELOPER   0x23EA7C12

◆ DEFAULT_ACCESSCODE_PROFESSIONAL

#define DEFAULT_ACCESSCODE_PROFESSIONAL   0x824B49AF

◆ DEFAULT_ACCESSCODE_USER

#define DEFAULT_ACCESSCODE_USER   0x7B30378C

◆ PARA_STRING_MAX_LENGTH

#define PARA_STRING_MAX_LENGTH   16380

Maximum length of the parameter strings (name, description, format, ...). The length is transfered as 2 byte 7BitEncodedInt (< 16384).

Enumeration Type Documentation

◆ ParameterStringType

String type of a parameter or group, which is read by ReadParameterString()

Enumerator
STRING_TYPE_NAME 
STRING_TYPE_DESCRIPTION 
STRING_TYPE_FORMAT 
STRING_TYPE_GROUP_NAME 
STRING_TYPE_SUBSTITUTION_TEXTS 

Function Documentation

◆ ReadFunction_AccessPasscode()

static int32_t ReadFunction_AccessPasscode ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)
static

◆ ReadFunction_PARA_Access()

int32_t ReadFunction_PARA_Access ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_DataType()

int32_t ReadFunction_PARA_DataType ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_DefaultValue()

int32_t ReadFunction_PARA_DefaultValue ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_Flags()

int32_t ReadFunction_PARA_Flags ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_GroupGroupId()

int32_t ReadFunction_PARA_GroupGroupId ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_GroupId()

int32_t ReadFunction_PARA_GroupId ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_GroupName()

int32_t ReadFunction_PARA_GroupName ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_GroupParent()

int32_t ReadFunction_PARA_GroupParent ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_MaxValue()

int32_t ReadFunction_PARA_MaxValue ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_MinValue()

int32_t ReadFunction_PARA_MinValue ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_ParaDescription()

int32_t ReadFunction_PARA_ParaDescription ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_ParaFormat()

int32_t ReadFunction_PARA_ParaFormat ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_ParaId()

int32_t ReadFunction_PARA_ParaId ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_ParaName()

int32_t ReadFunction_PARA_ParaName ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_SubIdCount()

int32_t ReadFunction_PARA_SubIdCount ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadFunction_PARA_SubstText()

int32_t ReadFunction_PARA_SubstText ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)

◆ ReadParameterString()

static int32_t ReadParameterString ( Parameter *  ptThis,
const ParameterRequest *  ptRequest,
ParameterStringType  tType 
)
static

◆ WriteFunction_AccessPasscode()

static int32_t WriteFunction_AccessPasscode ( Parameter *  ptThis,
const ParameterRequest *  ptRequest 
)
static

Variable Documentation

◆ g_pui8ActualAccessLevelPointer

uint8_t* g_pui8ActualAccessLevelPointer = &g_ui8ActualAccessLevel

Pointer to the Actual access-level (see Access restrictions).

◆ g_ui8ActualAccessLevel

uint8_t g_ui8ActualAccessLevel =1

Actual access-level (see Access restrictions).

◆ PARA_Access

const Parameter PARA_Access
Initial value:
=
{
"Access",
"",
"{0}",
(ReadFunction*)ReadFunction_PARA_Access,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define GROUP_ID_Internal
Definition: PARA_ID_System.h:26
#define PARA_ID_Access
Definition: PARA_ID_System.h:79
@ NOT_STORED
Definition: PARA_Lib.h:878
WriteFunction_Generic WriteFunction_STD_Const
Definition: PARA_Lib.h:1190
RestoreDefaultFunction_Generic SetToDefaultFunction_STD_Const
Definition: PARA_Lib.h:1203
@ PROFESSIONAL_READ
Definition: PARA_Lib.h:845
@ USER_READ
Definition: PARA_Lib.h:843
@ VIEWER_READ
Definition: PARA_Lib.h:841
@ DEVELOPER_READ
Definition: PARA_Lib.h:847
@ FLAG_SYSTEM
Parameter is added to Parametereditor and only necessary for parametereditor to work properly.
Definition: PARA_Lib.h:910
int32_t ReadFunction_PARA_Access(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:417
const ParaData_STR ParaData_ParaName
Definition: PARA_ParaAccess.c:311
@ TYPE_uint16
Definition: SYS_Type.h:78
#define MAX_uint16
Definition: SYS_Type.h:32

◆ PARA_AccessCode

const Parameter PARA_AccessCode
Initial value:
=
{
1,
"Parameter Access Level",
"Actual Access-Level. To change write the correct code to this parameter",
"{0}",
(ReadFunction*)ReadFunction_AccessPasscode,
(WriteFunction*)WriteFunction_AccessPasscode,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"0=None;1=Viewer;2=User;3=Professional;4=Developer",
}
ParameterU16 FlashData1 ParameterU32 FlashData1 GROUP_ID_System
Definition: PARA_Flash_STM32H7.c:913
#define PARA_ID_AccessPasscode
Definition: PARA_ID_System.h:37
@ PROFESSIONAL_WRITE
Definition: PARA_Lib.h:846
@ VIEWER_WRITE
Definition: PARA_Lib.h:842
@ DEVELOPER_WRITE
Definition: PARA_Lib.h:848
@ USER_WRITE
Definition: PARA_Lib.h:844
@ FLAG_SCOPEABLE
Parameter can be scoped.
Definition: PARA_Lib.h:912
@ FLAG_VOLATILE
Value is modified by uC, must be polled regularly.
Definition: PARA_Lib.h:913
@ FLAG_NO_FILE_OVERWRITE
Value is not written on write from Parameterfile Operation. It can only modified manually by user.
Definition: PARA_Lib.h:914
static int32_t WriteFunction_AccessPasscode(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:917
static int32_t ReadFunction_AccessPasscode(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:910
const ParaData_U32 ParaData_AccessPasscode
Definition: PARA_ParaAccess.c:900
@ TYPE_uint32
Definition: SYS_Type.h:80

◆ PARA_DataType

const Parameter PARA_DataType
Initial value:
=
{
"DataType",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_DataType
Definition: PARA_ID_System.h:80
int32_t ReadFunction_PARA_DataType(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:457

◆ PARA_DefaultValue

const Parameter PARA_DefaultValue
Initial value:
=
{
"DefaultValues",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_DefaultValue
Definition: PARA_ID_System.h:84
const ParaData_F32 ParaData_MinValue
Definition: PARA_ParaAccess.c:714
int32_t ReadFunction_PARA_DefaultValue(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:786
@ TYPE_float
Definition: SYS_Type.h:83

◆ PARA_Flags

const Parameter PARA_Flags
Initial value:
=
{
"Flags",
"",
"{0}",
(ReadFunction*)ReadFunction_PARA_Flags,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_ParaFlags
Definition: PARA_ID_System.h:92
int32_t ReadFunction_PARA_Flags(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:864

◆ PARA_GroupCount

const Parameter PARA_GroupCount
Initial value:
=
{
1,
"GroupCount",
"number of groups",
"{0}",
(ReadFunction*)ReadFunction_STD_U32,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_GroupCount
Definition: PARA_ID_System.h:85
ReadFunction_U32 ReadFunction_STD_U32
Definition: PARA_Lib.h:1174
const ParaData_I32 ParaData_GroupCount
Definition: PARA_ParaAccess.c:546
@ TYPE_int32
Definition: SYS_Type.h:79

◆ PARA_GroupGroupId

const Parameter PARA_GroupGroupId
Initial value:
=
{
"GroupGroupId",
"",
"{0}",
0,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_GroupGroupId
Definition: PARA_ID_System.h:86
int32_t ReadFunction_PARA_GroupGroupId(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:585

◆ PARA_GroupId

const Parameter PARA_GroupId
Initial value:
=
{
"GroupId",
"",
"{0}",
0,
(ReadFunction*)ReadFunction_PARA_GroupId,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_GroupId
Definition: PARA_ID_System.h:75
int32_t ReadFunction_PARA_GroupId(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:126

◆ PARA_GroupName

const Parameter PARA_GroupName
Initial value:
=
{
"GroupName",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_GroupName
Definition: PARA_ID_System.h:88
int32_t ReadFunction_PARA_GroupName(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:665
@ TYPE_string
Definition: SYS_Type.h:86

◆ PARA_GroupParent

const Parameter PARA_GroupParent
Initial value:
=
{
"GroupParent",
"",
"{0}",
0,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_GroupParent
Definition: PARA_ID_System.h:87
int32_t ReadFunction_PARA_GroupParent(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:625

◆ PARA_MaxValue

const Parameter PARA_MaxValue
Initial value:
=
{
"MaxValues",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_MaxValue
Definition: PARA_ID_System.h:83
int32_t ReadFunction_PARA_MaxValue(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:746

◆ PARA_MinValue

const Parameter PARA_MinValue
Initial value:
=
{
"MinValues",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_MinValue
Definition: PARA_ID_System.h:82
int32_t ReadFunction_PARA_MinValue(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:696

◆ PARA_ParaCount

const Parameter PARA_ParaCount
Initial value:
=
{
1,
"ParaCount",
"number of parameters",
"{0}",
(ReadFunction*)ReadFunction_STD_U32,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_ParaCount
Definition: PARA_ID_System.h:73
const ParaData_I32 ParaData_ParaCount
Definition: PARA_ParaAccess.c:47

◆ PARA_ParaDescription

const Parameter PARA_ParaDescription
Initial value:
=
{
"Description",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_ParaDescription
Definition: PARA_ID_System.h:77
int32_t ReadFunction_PARA_ParaDescription(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:348

◆ PARA_ParaFormat

const Parameter PARA_ParaFormat
Initial value:
=
{
"Format",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_ParaFormat
Definition: PARA_ID_System.h:78
int32_t ReadFunction_PARA_ParaFormat(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:383

◆ PARA_ParaId

const Parameter PARA_ParaId
Initial value:
=
{
"ParaId",
"",
"{0}",
0,
(ReadFunction*)ReadFunction_PARA_ParaId,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_ParaId
Definition: PARA_ID_System.h:74
int32_t ReadFunction_PARA_ParaId(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:86

◆ PARA_ParaName

const Parameter PARA_ParaName
Initial value:
=
{
"Name",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_ParaName
Definition: PARA_ID_System.h:76
int32_t ReadFunction_PARA_ParaName(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:306

◆ PARA_ParaSubstText

const Parameter PARA_ParaSubstText
Initial value:
=
{
"SubstitutionalTexts",
"",
"{0}",
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_SubstitutionalTexts
Definition: PARA_ID_System.h:91
int32_t ReadFunction_PARA_SubstText(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:835

◆ PARA_SubIdCount

const Parameter PARA_SubIdCount
Initial value:
=
{
"SubIdCount",
"",
"{0}",
0,
(WriteFunction*)WriteFunction_STD_Const,
(RestoreDefaultFunction*)SetToDefaultFunction_STD_Const,
"",
}
#define PARA_ID_SubIdCount
Definition: PARA_ID_System.h:81
int32_t ReadFunction_PARA_SubIdCount(Parameter *ptThis, const ParameterRequest *ptRequest)
Definition: PARA_ParaAccess.c:498

◆ ParaData_AccessPasscode

const ParaData_U32 ParaData_AccessPasscode
Initial value:
=
{
0,
0
}
#define MAX_uint32
Definition: SYS_Type.h:28
#define MIN_uint32
Definition: SYS_Type.h:27

◆ ParaData_GroupCount

const ParaData_I32 ParaData_GroupCount
Initial value:
=
{
(int32_t*)&ANZAHL_GRUPPEN,
0
}
const int32_t ANZAHL_GRUPPEN
Number of existent parameter-groups. Must be defined in main program.
#define MAX_int32
Definition: SYS_Type.h:30
#define MIN_int32
Definition: SYS_Type.h:29

◆ ParaData_MinValue

const ParaData_F32 ParaData_MinValue
Initial value:
=
{
0,
0
}
#define MAX_float32
Definition: SYS_Type.h:40
#define MIN_float32
Definition: SYS_Type.h:39

◆ ParaData_ParaCount

const ParaData_I32 ParaData_ParaCount
Initial value:
=
{
0
}
int32_t ANZAHL_PARAMETER
Number of existent parameters. Must be defined in main program.

◆ ParaData_ParaName

const ParaData_STR ParaData_ParaName
Initial value:
=
{
0,
16380 ,
""
}