Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Application Parameter

This section describes the specification of a parameter groups. The parameter structures are highly application specific and shall be defined within the application header files.

Example:

This example defines multiple parameter groups:

  • one parameter group containing the communication profile parameter (COM_PARA_MEM).
  • one parameter group containing the application specific parameter (APP_PARA_MEM).
  • The third definition collects the previously defined parameter groups to a single parameter group to allow loading and storage of both parameter groups with a single access (ALL_PARA_MEM).

    • These structure type definitions are recommended to force the linker to place the corresponding parameter variables in a consecutive memory block. Any other technique to get this result is reasonable, too.

    Within the object directory configuration, the parameter group information structures shall be allocated and filled with the corresponding parameter group information settings.

    Example:

    The following descriptions explains the details of the table members:

  • The parameter group size [CPU_INT32U] shall be set to the number of bytes within the parameter group memory area.
  • The start address of the parameter group memory area [CPU_INT08U *] shall be set to the first address of the parameter group memory.
  • The reset type [CO_NMT_RESET] shall be set to one of the following values:
    • Reset Type Description
    CO_RESET_COM parameter group shall be set to the stored values on communication reset
    CO_RESET_NODE parameter group shall be set to the stored values on node reset
  • The pointer to the identification [void *] of this parameter group is not used by the CANopen stack. This member is intended to identify the different parameter groups within the application callback functions, related to the parameter handling. Any type of identification may be used for this purpose. In the shown example, an identification string is used.
  • The parameter group feature indication [CPU_INT32U], which is returned on a simple object entry read access, shall be set to one of the following values:
    • Parameter Feature Description
    CO_PARA____ parameter group is disabled
    CO_PARA___E parameter group is enabled and will be stored on command
    CO_PARA__A_ parameter group is enabled and will be stored autonomously
    CO_PARA__AE parameter group is enabled and will be stored on command and autonomously

    Note: "autonomously" means without CANopen network interaction; e.g. the application is responsible for the storage of these parameter groups.

    The object entries, handling the saving and restoring of parameters, shall be set for the example to the following values:

    The single parameters are most likely used within the object directory. The example definition of a object entry is shown for one parameter:

    { CO_KEY(0x1017, 0, CO_UNSIGNED16|CO_OBJ____RW), 0, (CPU_INT32U)&Para.App.DemoWord },

    • No labels