AUTOAR4.2.2CanDrv配置容器20230715A

AUTOAR4.2.2CanDrv配置容器，This container holds the configuration of a single CAN Driver. Post-Build Variant Support true

CANDrv

• This container holds the configuration of a single CAN Driver. Post-Build Variant Support true
• CanConfigSet
  • This container contains the configuration parameters and sub containers of the AUTOSAR Can module.
  • CanController(1..*)
    • CanBusoffProcessing
      • Enables / disables API Can_MainFunction_BusOff() for handling busoff events in polling mode.
      • INTERRUPT
      • POLLING
    • CanControllerActivation
      • Defines if a CAN controller is used in the configuration.
      • EcucBooleanParamDef
    • CanControllerBaseAddress
      • Specifies the CAN controller base address.
      • EcucIntegerParamDef
    • CanControllerId
      • This parameter provides the controller ID which is unique in a given CAN Driver. The value for this parameter starts with 0 and continue without any gaps.
      • EcucIntegerParamDef (Symbolic Name generated for this parameter)
    • CanRxProcessing
      • Enables / disables API Can_MainFunction_Read() for handling PDU reception events in polling mode.
      • INTERRUPT
      • POLLING
    • CanTxProcessing
      • Enables / disables API Can_MainFunction_Write() for handling PDU transmission events in polling mode.
      • INTERRUPT
      • POLLING
    • CanWakeupFunctionalityAPI
      • Adds / removes the service Can_CheckWakeup() from the code. True: Can_CheckWakeup can be used. False: Can_CheckWakeup cannot be used. dependency: H/W should support the wakeup functionality to enable this parameter.
      • EcucBooleanParamDef
    • CanWakeupProcessing
      • Enables / disables API Can_MainFunction_Wakeup() for handling wakeup events in polling mode.
      • INTERRUPT
      • POLLING
    • CanWakeupSupport
      • CAN driver support for wakeup over CAN Bus
      • EcucBooleanParamDef
    • CanControllerDefaultBaudrate
      • Reference to baudrate configuration container configured for the Can Controller.
      • Reference to [ CanControllerBaudrateConfig ]
    • CanCpuClockRef
      • Reference to the CPU clock configuration, which is set in the MCU driver configuration
      • Reference to [ McuClockReferencePoint ]
    • CanWakeupSourceRef(0..1)
      • Symbolic name reference to [ EcuMWakeupSource ]
    • CanControllerBaudrateConfig(1..*)
      • This container contains bit timing related configuration parameters of the CAN controller(s)
      • CanControllerBaudRate
        • Specifies the baudrate of the controller in kbps.
        • EcucIntegerParamDef(0..2000)
      • CanControllerBaudRateConfigID
        • Uniquely identifies a specific baud rate configuration. This ID is used by SetBaudrate API dependency: CanSetBaudrateApi
        • EcucIntegerParamDef
      • CanControllerPropSeg
        • Specifies propagation delay in time quantas
        • EcucIntegerParamDef(0..255)
      • CanControllerSeg1
        • Specifies phase segment 1 in time quantas.
        • EcucIntegerParamDef(0..255)
      • CanControllerSeg2
        • Specifies phase segment 2 in time quantas.
        • EcucIntegerParamDef(0..255)
      • CanControllerSyncJumpWidth
        • Specifies the synchronization jump width for the controller in time quantas.
        • EcucIntegerParamDef(0..255)
      • CanControllerFdBaudrateConfig(0..1)
        • This optional container contains bit timing related configuration parameters of the CAN controller(s) for payload and CRC of a CAN FD frame. If this container exists the controller supports CAN FD frames.
        • CanControllerFdBaudRate
          • Specifies the data segment baud rate of the controller in kbps
          • EcucIntegerParamDef(0..16000)
        • CanControllerPropSeg
          • Specifies propagation delay in time quantas
          • EcucIntegerParamDef(0..255)
        • CanControllerSeg1
          • Specifies phase segment 1 in time quantas.
          • EcucIntegerParamDef(0..255)
        • CanControllerSeg2
          • Specifies phase segment 2 in time quantas.
          • EcucIntegerParamDef(0..255)
        • CanControllerSyncJumpWidth
          • Specifies the synchronization jump width for the controller in time quantas.
          • EcucIntegerParamDef(0..255)
        • CanControllerTrcvDelayCompensationOffset(0..1)
          • Specifies the Transceiver Delay Compensation Offset in ns. If not specified Transceiver Delay Compensation is disabled
          • EcucIntegerParamDef(0..400)
        • CanControllerTxBitRateSwitch
          • Specifies if the bit rate switching shall be used for transmissions. If FALSE: CAN FD frames shall be sent without bit rate switching
          • EcucBooleanParamDef
    • CanTTController(0..1)
      • CanTTController is specified in the SWS TTCAN and contains the configuration parameters of the TTCAN controller(s) (which are needed in addition to the configuration parameters of the CAN controller(s)). This container is only included and valid if TTCAN is supported by the controller, enabled
  • CanHardwareObject(1..*)
    • CanFdPaddingValue(0..1)
      • Specifies the value which is used to pad unspecified data in CAN FD frames > 8 bytes for transmission. This is necessary due to the discrete possible values of the DLC if > 8 bytes. If the length of a PDU which was requested to be sent does not match the allowed DLC values, the remaining bytes up to the next possible value shall be padded with this value.
      • EcucIntegerParamDef
    • CanHandleType
      • Specifies the type (Full-CAN or Basic-CAN) of a hardware object. dependency: This configuration element is used as information for the CAN Interface only. The relevant CAN driver configuration is done with the filter mask and identifier.
      • BASIC
        • For several L-PDUs are hadled by the hardware object
      • FULL
        • For only one L-PDU (identifier) is handled by the hardware object
    • CanHwObjectCount
      • Number of hardware objects used to implement one HOH. In case of a HRH this parameter defines the number of elements in the hardware FIFO or the number of shadow buffers, in case of a HTH it defines the number of hardware objects used for multiplexed transmission or for a hardware FIFO used by a FullCAN HTH.
      • EcucIntegerParamDef
    • CanIdType
      • Specifies whether the IdValue is of type - standard identifier - extended identifier - mixed mode ImplementationType: Can_IdType
      • EXTENDED
        • All the CANIDs are of type extended only (29 bit)
      • MIXED
        • The type of CANIDs can be both Standard or Extended
      • STANDARD
        • All the CANIDs are of type standard only (11bit).
    • CanObjectId
      • Holds the handle ID of HRH or HTH. The value of this parameter is unique in a given CAN Driver, and it should start with 0 and continue without any gaps. The HRH and HTH Ids share a common ID range. Example: HRH0-0, HRH1-1, HTH0-2, HTH1-3
      • EcucIntegerParamDef (Symbolic Name generated for this parameter)
    • CanObjectType
      • RECEIVE
        • Receive HOH
      • TRANSMIT
        • Transmit HOH
    • CanTriggerTransmitEnable(0..1)
      • This parameter defines if or if not Can supports the trigger-transmit API for this handle.
      • EcucBooleanParamDef
    • CanControllerRef
      • Reference to CAN Controller to which the HOH is associated to.
      • Reference to [ CanController ]
    • CanMainFunctionRWPeriodRef(0..1)
      • Reference to CanMainFunctionPeriod
      • Reference to [ CanMainFunctionRWPeriods ]
    • CanHwFilter(0..*)
      • This container is only valid for HRHs and contains the configuration (parameters) of one hardware filter.
      • CanHwFilterCode
        • Specifies (together with the filter mask) the identifiers range that passes the hardware filter.
        • EcucIntegerParamDef
      • CanHwFilterMask
        • Describes a mask for hardware-based filtering of CAN identifiers. The CAN identifiers of incoming messages are masked with the appropriate CanFilterMaskValue. Bits holding a 0 mean don't care, i.e. do not compare the message's identifier in the respective bit position. The mask shall be build by filling with leading 0. In case of CanIdType EXTENDED or MIXED a 29 bit mask shall be build. In case of CanIdType STANDARD a 11 bit mask shall be build dependency: The filter mask settings must be known by the CanIf configuration for optimization of the SW filters.
        • EcucIntegerParamDef
    • CanTTHardwareObjectTrigger(0..*)
      • CanTTHardwareObjectTrigger is specified in the SWS TTCAN and contains the configuration (parameters) of TTCAN triggers for Hardware Objects, which are additional to the configuration (parameters) of CAN Hardware Objects. This container is only included and valid if TTCAN is supported by the controller and, enabled
  • CanIcom(0..1)
    • CanIcomConfig(1..*)
      • This container contains the configuration parameters of the ICOM Configuration.
      • CanIcomConfigId
        • This parameter identifies the ID of the ICOM configuration.
        • EcucIntegerParamDef(1..255)
      • CanIcomWakeOnBusOff
        • This parameter defines that the MCU shall wake if the bus off is detected or not.
        • EcucBooleanParamDef
      • CanIcomWakeupCauses
        • This container contains the configuration parameters of the wakeup causes to leave the power saving mode.
        • CanIcomRxMessage
          • CanIcomCounterValue(0..1)
            • This parameter defines that the MCU shall wake if the message with the ID is received n times on the communication channel.
            • EcucIntegerParamDef
          • CanIcomMessageId
            • This parameter defines the message ID the wakeup causes of this CanIcomRxMessage are configured for. In addition a mask (CanIcomMessageIdMask) can be defined, in that case it is possible to define a range of rx messages, which can create a wakeup condition.
            • EcucIntegerParamDef
          • CanIcomMessageIdMask(0..1)
            • Describes a mask for filtering of CAN identifiers. The CAN identifiers of incoming messages are masked with this CanIcomMessageIdMask. If the masked identifier matches the masked value of CanIcomMessageId, it can create a wakeup condition for this CanIcomRxMessage. Bits holding a 0 mean don't care, i.e. do not compare the message's identifier in the respective bit position. The mask shall be build by filling with leading 0. dependency: CanIcomMessageIdMask and CanIcomRxMessageSignalConfig shall not be defined together
            • EcucIntegerParamDef
          • CanIcomPayloadLengthError
            • This parameter defines that the MCU shall wake if a payload error occurs
            • EcucBooleanParamDef
          • CanIcomRxMessageSignalConfig(0..*)
            • This container contains the configuration parameters for the wakeup causes for matching signals. It has to be configured as often as a signal is defined as wakeup cause. If at least one Signal conditions defined in a CanIcomRxMessageSignalConfig evaluates to true or if no CanIcomRxMessageSignalConfig are defined, the whole wakeup condition is considered to be true. All instances of this container refer to the same frame/pdu (see CanIcomMessageId).
            • CanIcomSignalMask
              • This parameter shall be used to mask a signal in the payload of a CAN message. The mask is binary AND with the signal payload. The result will be used in combination of the operations defined in CanIcomSignalOperation with the CanIcomSignalValue.
              • EcucIntegerParamDef
            • CanIcomSignalOperation
              • This parameter defines the operation, which shall be used to verify the signal value creates a wakeup condition.
              • AND
              • EQUAL
              • GREATER
              • SMALLER
              • XOR
            • CanIcomSignalValue
              • This parameter shall be used to define a signal value which shall be compared (CanIcomSignalOperation) with the masked CanIcomSignalMask value of the received signal (CanIcomSignalRef).
              • EcucIntegerParamDef
            • CanIcomSignalRef(0..1)
              • This parameter defines a reference to the signal which shall be checked additional to the message id (CanIcomMessageId). This reference is used for documentation to define which ComSignal originates this filter setting. All signals being referred by this reference shall point to the same PDU. dependency: The signal referenced by CanIcomSignalRef shall be included in a ComIPdu which matches with the current CAN Controller and the CAN Identifier (CanIcomMessageId) configured for this CanIcomRxMessage.
              • Reference to [ ComSignal ]
    • CanIcomGeneral
      • CanIcomLevel(0..1)
        • Defines the level of Pretended Networking. This parameter is reserved for future implementations (Pretended Networking level 2).
        • CAN_ICOM_LEVEL_ONE
        • CAN_ICOM_LEVEL_TWO
      • CanIcomVariant
        • Defines the variant, which is supported by this CanController
        • CAN_ICOM_VARIANT_HW
        • CAN_ICOM_VARIANT_NONE
        • CAN_ICOM_VARIANT_SW
• CanGeneral
  • This container contains the parameters related each CAN Driver Unit.
  • CanDevErrorDetection
    • EcucBooleanParamDef
  • CanIndex
    • Specifies the InstanceId of this module instance. If only one instance is present it shall have the Id 0.
    • EcucIntegerParamDef
  • CanLPduReceiveCalloutFunction(0..1)
    • This parameter defines the existence and the name of a callout function that is called after a successful reception of a received CAN Rx L-PDU. If this parameter is omitted no callout shall take place.
    • EcucFunctionNameDef
  • CanMainFunctionBusoffPeriod(0..1)
    • This parameter describes the period for cyclic call to Can_MainFunction_Busoff. Unit is seconds.
    • EcucFloatParamDef
  • CanMainFunctionModePeriod
    • This parameter describes the period for cyclic call to Can_MainFunction_Mode. Unit is seconds.
    • EcucFloatParamDef
  • CanMainFunctionWakeupPeriod(0..1)
    • This parameter describes the period for cyclic call to Can_MainFunction_Wakeup. Unit is seconds.
    • EcucFloatParamDef
  • CanMultiplexedTransmission
    • Specifies if multiplexed transmission shall be supported.ON or OFF dependency: CAN Hardware Unit supports multiplexed transmission
    • EcucBooleanParamDef
  • CanPublicIcomSupport
    • Selects support of Pretended Network features in Can driver. True: Enabled False: Disabled
    • EcucBooleanParamDef
  • CanSetBaudrateApi(0..1)
    • The support of the Can_SetBaudrate API is optional. If this parameter is set to true the Can_SetBaudrate API shall be supported. Otherwise the API is not supported.
    • EcucBooleanParamDef
  • CanTimeoutDuration
    • Specifies the maximum time for blocking function until a timeout is detected. Unit is seconds
    • EcucFloatParamDef
  • CanVersionInfoApi
    • Switches the Can_GetVersionInfo() API ON or OFF.
    • EcucBooleanParamDef
  • CanOsCounterRef(0..1)
    • This parameter contains a reference to the OsCounter, which is used by the CAN driver.
    • Reference to [ OsCounter ]
  • CanSupportTTCANRef
    • The parameter refers to CanIfSupportTTCAN parameter in the CAN Interface Module configuration. The CanIfSupportTTCAN parameter defines whether TTCAN is supported.
    • Reference to [ CanIfPrivateCfg ]
  • CanIcomGenera(0..1)
    • This container contains the general configuration parameters of the ICOM Configuration.
  • CanMainFunctionRWPeriods(0..*)
    • This container contains the parameter for configuring the period for cyclic call to Can_MainFunction_Read or Can_MainFunction_Write depending on the referring item.
    • CanMainFunctionPeriod
      • This parameter describes the period for cyclic call to Can_MainFunction_Read or Can_MainFunction_Write depending on the referring item. Unit is seconds. Different poll-cycles will be configurable if more than one CanMainFunctionPeriod is configured. In this case multiple Can_MainFunction_Read() or Can_MainFunction_Write() will be provided by the CAN Driver module
      • EcucFloatParamDef(0.001..65.535)