Skip to content

2nd trial of implementing structured ADIs #20

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
BerndWernerGuenther wants to merge 3 commits into
base: main
Choose a base branch
from
Open

2nd trial of implementing structured ADIs #20

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
def483f
2nd trial of implementing structured ADIs
BerndWernerGuenther Feb 20, 2026
3b3f93c
compiler switch ABCC_CFG_DRV_STRUCTURED_ADIS disabled by default so t…
BerndWernerGuenther Feb 20, 2026
f00699e
Merge branch 'hms-networks:main' into 2nd_trial_of_implementing_struc…
BerndWernerGuenther Mar 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions src/abcc_adaptation/abcc_driver_config.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,30 @@
#include "abcc_types.h"
#include "abp.h"


/*------------------------------------------------------------------------------
** Selection of ADI setup:
** when defined structured ADIs will be used;
** if not defined the ADIs for the speed example will be used
**------------------------------------------------------------------------------
*/
#ifndef ABCC_CFG_DRV_STRUCTURED_ADIS
//#define ABCC_CFG_DRV_STRUCTURED_ADIS 1
#endif



/*------------------------------------------------------------------------------
** Switch dependent enabling of STRUCT_DATA_TYPE
**------------------------------------------------------------------------------
*/
#ifdef ABCC_CFG_DRV_STRUCTURED_ADIS
#ifndef ABCC_CFG_STRUCT_DATA_TYPE_ENABLED
#define ABCC_CFG_STRUCT_DATA_TYPE_ENABLED 1
#endif
#endif


/*------------------------------------------------------------------------------
** All interface drivers are supported.
**------------------------------------------------------------------------------
Expand Down
243 changes: 210 additions & 33 deletions src/example_application/abcc_network_data_parameters.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,11 @@

#include "abcc_api.h"


#ifndef ABCC_CFG_DRV_STRUCTURED_ADIS
/******************************************************************************************************/
#if ( ABCC_CFG_STRUCT_DATA_TYPE_ENABLED || ABCC_CFG_ADI_GET_SET_CALLBACK_ENABLED )
#error ABCC_CFG_ADI_GET_SET_CALLBACK_ENABLED must be set to 0 and ABCC_CFG_STRUCT_DATA_TYPE_ENABLED set to 0 in order to run this example
#error ABCC_CFG_ADI_GET_SET_CALLBACK_ENABLED must be set to 0 and ABCC_CFG_STRUCT_DATA_TYPE_ENABLED set to 0 in order to run this example
#endif

/*------------------------------------------------------------------------------
Expand All @@ -43,6 +46,42 @@ const AD_AdiEntryType ABCC_API_asAdiEntryList[] =
{ 0x2, "REF_SPEED", ABP_UINT16, 1, AD_ADI_DESC__R_S_, { { &appl_iRefSpeed, &appl_sUint16Prop } } }
};


/*------------------------------------------------------------------------------
** Example - electric motor control loop
**------------------------------------------------------------------------------
*/
void ABCC_API_CbfCyclicalProcessing()
{
if (ABCC_API_AnbState() == ABP_ANB_STATE_PROCESS_ACTIVE)
{
/*
** An example of ADI data handling.
*/
if (appl_iSpeed > appl_iRefSpeed)
{
/*
** Do something that lowers speed.
*/
appl_iSpeed -= 1;
}
else if (appl_iSpeed < appl_iRefSpeed)
{
/*
** Do something that increases speed.
*/
appl_iSpeed += 1;
}
}
else
{
/*
** We are not in process active, the default should be that the motor
** should not run.
*/
appl_iSpeed = 0;
}
}
/*------------------------------------------------------------------------------
** Map all adi:s in both directions
**------------------------------------------------------------------------------
Expand All @@ -56,43 +95,181 @@ const AD_MapType ABCC_API_asAdObjDefaultMap[] =
{ AD_MAP_END_ENTRY }
};

UINT16 ABCC_API_CbfGetNumAdi( void )
/******************************************************************************************************/


#else
/******************************************************************************************************/
/*
** Example with all access flags set.
*/
#define ADI_DESCR_ALL_ACCESS ( ABP_APPD_DESCR_GET_ACCESS | ABP_APPD_DESCR_SET_ACCESS | ABP_APPD_DESCR_MAPPABLE_WRITE_PD | ABP_APPD_DESCR_MAPPABLE_READ_PD )


/*******************************************************************************
** Example of ADI mapping structured data type
** (ABCC_CFG_STRUCT_DATA_TYPE_ENABLED defined to 1 in abcc_driver_config.h )
********************************************************************************
*/


/*------------------------------------------------------------------------------
** Variable place holders for the ADI:s
**------------------------------------------------------------------------------
*/
/*
** The content of struct1 is described by ABCC_API_AdiStruct1 below
*/
struct
{
return( sizeof( ABCC_API_asAdiEntryList ) / sizeof( AD_AdiEntryType ) );
}
UINT16 iData;
UINT32 lData;
} struct1;

/*
** The content of struct2 is described by ABCC_API_AdiStruct2 below
*/
struct
{
UINT8 bBitData[2];
UINT16 iData;
} struct2;

/*
** Basic 8 bit ADI
*/
UINT8 bData;


/*------------------------------------------------------------------------------
** Example - electric motor control loop
** ABCC_API_AdiStruct1 describes a structured ADI with two members. ( struct1 )
**------------------------------------------------------------------------------
*/
static const AD_StructDataType ABCC_API_AdiStruct1[] =
{
/*
** --------------------------------------------------------------------------------------------------------------------
** | 1. pacElementName | 2. bDataType | 3. iNumSubElem | 4. bDesc | 5. bBitOffset | 6. pxValuePtr | 7. pxValuePropPtr |
** --------------------------------------------------------------------------------------------------------------------
*/
/* Index: 0 */ { "Element01", ABP_UINT16, 1, ADI_DESCR_ALL_ACCESS, 0, { { &struct1.iData, NULL } } },
/* Index: 1 */ { "Element02", ABP_SINT32, 1, ADI_DESCR_ALL_ACCESS, 0, { { &struct1.lData, NULL } } }
};


/*
**------------------------------------------------------------------------------
** ABCC_API_AdiStruct2 describes a structured ADI with 4 members (struct2). The
** structure includes bit data types and padding. The picture below shows the
** packed ADI result. The numbers are referring to the index in
** ABCC_API_AdiStruct2.
**
**
** Bit: 7 6 5 4 3 2 1 0
** ---------------------------------
** | 1 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | struct2.bBitData[ 0 ]
** ---------------------------------
** ---------------------------------
** | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 1 | struct2.bBitData[ 1 ]
** ---------------------------------
** ---------------------------------
** | 3 | 3 | 3 | 3 | 3 | 3 | 3 | 3 | struct2.iData
** ---------------------------------
** ---------------------------------
** | 3 | 3 | 3 | 3 | 3 | 3 | 3 | 3 | struct2.iData
** ---------------------------------
**------------------------------------------------------------------------------
*/
static const AD_StructDataType ABCC_API_AdiStruct2[] =
{
/*
** --------------------------------------------------------------------------------------------------------------------
** | 1. pacElementName | 2. bDataType | 3. iNumSubElem | 4. bDesc | 5. bBitOffset | 6. pxValuePtr | 7. pxValuePropPtr |
** --------------------------------------------------------------------------------------------------------------------
*/
/* Index: 0 */ { "Element01", ABP_BIT5, 1, ADI_DESCR_ALL_ACCESS, 0, { { &struct2.bBitData[0], NULL } } }, /* First 5 bits in struct2.bBitData[ 0 ] */
/* Index: 1 */ { "Element02", ABP_BIT4, 1, ADI_DESCR_ALL_ACCESS, 5, { { &struct2.bBitData[0], NULL } } }, /* 4 bits starting at position 5 in struct2.bBitData[ 0 ] */
/* Index: 2 */ { "Element03", ABP_PAD7, 1, ADI_DESCR_ALL_ACCESS, 1, { { NULL, NULL } } }, /* 7 bits padding is needed starting at position 1 in struct2.bBitData[ 1 ] */
/* Index: 3 */ { "Element04", ABP_UINT16, 1, AD_ADI_DESC____SG, 0, { { &struct2.iData, NULL } } } /* 16 bit type must at least be on a 8 bit aligned position */
};

/*------------------------------------------------------------------------------
** ADI instance allocation with structured ADI:s. The last member
** ( 8. psStruct ) is referring the structured data types described above.
** Note that member 3,5,6 and 7 are ignored if psStruct ( 8.) is a valid
** pointer.
**------------------------------------------------------------------------------
*/
const AD_AdiEntryType ABCC_API_asAdiEntryList[] =
//const AD_AdiEntryType AD_asADIEntryList[] =
{
/*
** ----------------------------------------------------------------------------------------------------------------------------
** | 1. iInstance | 2. pabName | 3. bDataType | 4. bNumOfElements | 5. bDesc | 6.pxValuePtr | 7. pxValuePropPtr | 8. psStruct |
** ----------------------------------------------------------------------------------------------------------------------------
*/
{ 10, "Struct1", ABP_BOOL, 2, ADI_DESCR_ALL_ACCESS, { { NULL, NULL } }, ABCC_API_AdiStruct1 },
{ 20, "Struct2", ABP_BOOL, 4, ADI_DESCR_ALL_ACCESS, { { NULL, NULL } }, ABCC_API_AdiStruct2 },
{ 30, "NoStruct", ABP_UINT8, 1, AD_ADI_DESC____SG, { { &bData, NULL } }, NULL }
};





























const AD_MapType ABCC_API_asAdObjDefaultMap[] =
{
/*




{ 10, PD_READ, AD_MAP_ALL_ELEM, 0 }, /* ADI 10 is mapped. ( All elements ) */
{ 20, PD_READ, 1, 1 }, /* ADI 20 element 1 (index) is mapped ( 4 Bits ) */
{ AD_MAP_PAD_ADI, PD_READ, 4, 0 }, /* PAD process data with 4 bits for correct alignment */
{ 30, PD_READ, 1, 0 }, /* Map ADI 30 */
{ 20, PD_WRITE, 2, 0 }, /* ADI 20 element 0 and 1 is mapped ( 9 bits ) */
{ AD_MAP_PAD_ADI, PD_WRITE, 7, 0 }, /* PAD process data with 7 bits for correct alignment */
{ AD_MAP_END_ENTRY}
};






void ABCC_API_CbfCyclicalProcessing()
{
if( ABCC_API_AnbState() == ABP_ANB_STATE_PROCESS_ACTIVE )
{
/*
** An example of ADI data handling.
*/
if( appl_iSpeed > appl_iRefSpeed )
{
/*
** Do something that lowers speed.
*/
appl_iSpeed -= 1;
}
else if( appl_iSpeed < appl_iRefSpeed )
{
/*
** Do something that increases speed.
*/
appl_iSpeed += 1;
}
}
else
{
/*
** We are not in process active, the default should be that the motor
** should not run.
*/
appl_iSpeed = 0;
}
}

#endif


UINT16 ABCC_API_CbfGetNumAdi(void)
{
return(sizeof(ABCC_API_asAdiEntryList) / sizeof(AD_AdiEntryType));
}