4.3. Arrival Inverter Driver - ArvlInvDrvr

Id

ArvlInvDrvr

Title

Arrival Inverter Driver

System

Drivetrain

Document Type

Application Software Component Specification Preview

4.3.1. Overview

The Arrival Inverter Driver component handles communication with the traction inverter given inverter configuration and installation. It provides inverter state control and monitoring, sends control commands to the inverter and receives status information, mechanical feedback and electrical measurements. The component converts individual inverter CAN data into vehicle frame system and provides a more abstract interface for other components to interact with the inverter.

4.3.2. Functions

Title

Description

1

Configure Inverter Conventions

Provides options to configure inverter location on the vehicle, inverter data sign conventions and inverter fault handling behavior.

2

Control Inverter Operation

Exchanges command and state information with inverter according to inverter-specific handhsaking protocol.

3

Monitor Inverter Status

Provides inverter operation and state monitoring, reverting to safe commands in failure scenarios.

4

Transform Inverter Data

Transforms location-specific inverter data from inverter-local frame to vehicle frame system.

4.3.3. Ports

Id

Direction

Data Type

Dimensions

Unit

1

InvEnaReq

Incoming

boolean

[1]

inherit

2

InvOperStReq

Incoming

Enum: com_vAction_t

[1]

inherit

3

InvDirFwdReq

Incoming

boolean

[1]

inherit

4

InvTqReq

Incoming

single

[1]

inherit

5

InvDirFwdCcwCfg

Incoming

boolean

[1]

inherit

6

MotSpdInvCtlErrCfg

Incoming

boolean

[1]

inherit

7

InvTowModReq

Incoming

Enum: VtSig_RecoveryMode_t

[1]

inherit

8

InvDchaModReq

Incoming

Enum: VtSig_HVActiveDischargeRequest_t

[1]

inherit

9

InvFltRstEnad

Incoming

boolean

[1]

inherit

10

CanInvCtlFbInfo

Incoming

Bus: CAN_Inv_Control_Feedback_Info_t

[-1]

inherit

11

CanInvStInfo

Incoming

Bus: CAN_Inv_State_Info_t

[-1]

inherit

12

CanInvTqLim

Incoming

Bus: CAN_Inv_Torque_Limits_t

[1]

inherit

13

CanInvOutInfo

Incoming

Bus: CAN_Inv_Output_Info_t

[-1]

inherit

14

CanInvInInfo

Incoming

Bus: CAN_Inv_Input_Info_t

[-1]

inherit

15

VldInvInInfo

Incoming

boolean

[1]

inherit

16

VldInvOutInfo

Incoming

boolean

[1]

inherit

17

VldInvStInfo

Incoming

boolean

[1]

inherit

18

VldInvFbInfo

Incoming

boolean

[1]

inherit

19

VldInvTqLim

Incoming

boolean

[1]

inherit

20

InstNo

Incoming

uint8

[1]

inherit

21

InvdrvInvOperStAct

Outgoing

Enum: com_vOnOff_t

[1]

inherit

22

InvdrvInvDirStAct

Outgoing

boolean

[1]

inherit

23

InvdrvInvDrvrStAct

Outgoing

Enum: InvdrvInvStActEnum

[1]

inherit

24

InvdrvMotTqTracLim

Outgoing

single

[1]

inherit

25

InvdrvMotTqRgnLim

Outgoing

single

[1]

inherit

26

InvdrvMotTqLimRsn

Outgoing

Enum: vtLimReasons_t

[1]

inherit

27

InvdrvMotTqActVeh

Outgoing

single

[1]

inherit

28

InvdrvMotSpdActVeh

Outgoing

int16

[1]

inherit

29

InvdrvMotSpdSt

Outgoing

Enum: com_value_state_t

[1]

inherit

30

InvdrvMotPwrAct

Outgoing

single

[1]

inherit

31

InvdrvMotHvCurAct

Outgoing

single

[1]

inherit

32

InvdrvMotHvVoltAct

Outgoing

single

[1]

V

33

InvdrvInvInpDaVld

Outgoing

boolean

[1]

inherit

34

InvdrvInvRdy2Slp

Outgoing

boolean

[1]

inherit

35

InvdrvInvWarnFlg

Outgoing

boolean

[1]

inherit

36

InvdrvInvFltCritFlg

Outgoing

boolean

[1]

inherit

37

InvdrvInvCtlErrFlg

Outgoing

boolean

[1]

inherit

38

InvdrvInvCanErrFlg

Outgoing

boolean

[1]

inherit

39

CanCommandMessage

Outgoing

Bus: CAN_Command_Message_t

[1]

inherit

4.3.4. Parameters

Id

Data Type

Dimensions

Range

Unit

Description

1

InvdrvFltStCritCfg

boolean

[1,5]

Min: 0, Max: 1

Inverter Fault State Configuration defining Critical faults in INV_FS_001…005 signals

2

InvdrvMotRotSignPosCcwCfg

boolean

[1,1]

Min: 0, Max: 1

Motor Rotation Sign Configuration: 0 - CCW is Negative direction, 1 - CCW is Positive direction

3

InvdrvMotSpdVldyRng

int16

[1,2]

Min: , Max:

rpm

Motor Speed Validity Range for signal range monitoring

4

InvdrvFltStWarnCfg

boolean

[1,5]

Min: 0, Max: 1

Inverter Fault State Configuration defining Warning faults in INV_FS_001…005 signals

5

InvdrvTqRateLimTqRamp

single

[1,1]

Min: 1, Max: 10000

N*m/s

Torque RampUp and RampDown Rate Limit at inverter startup or shutdown

6

InvdrvInvOnForAxleDiFlg

boolean

[1,1]

Min: , Max:

Keep Inverter On when Axle Disabled (zero out torque limits only)

7

InvdrvMotSpdThdInvCtlErr

uint16

[1,1]

Min: 0, Max: 10000

rpm

Motor Speed Threshold for detecting Control Error

8

InvdrvMotSpdThdRgn

int16

[1,1]

Min: 0, Max: 10000

rpm

Motor Speed Threshold for Enabling Regeneration

9

InvdrvMotSpdThdSftyRst

single

[1,1]

Min: 0, Max: 50000

rpm

Motor speed threshold to allow tow mode or active discharge mode or faults reset

10

InvdrvMotTqThdSftyRst

single

[1,1]

Min: 0, Max: 5000

N*m

Motor torque threshold to allow tow mode or active discharge mode or faults reset

11

InvdrvStCfmDlyCtlErr

single

[1,1]

Min: 0, Max: 10000

sec

Inverter Run State Confirmation Time Delay before throwing Control Error

12

InvdrvTiConstTqRamp

single

[1,1]

Min: 0, Max: 5

sec

Torque RampUp and RampDown Filter Time Constant at inverter startup or shutdown

13

InvdrvTioutMaxTqRamp

single

[1,1]

Min: 0, Max: 10

sec

Torque RampUp and RampDown Maximum Duration at inverter startup or shutdown

14

InvdrvTqThdCmplTqRamp

single

[1,1]

Min: 0.1, Max: 1000

N*m

Torque RampUp and RampDown completed torque threshold condition