® User Guide OpenECU Developer Platform Sim-API Release 3.1.0-FS r2021-1 Copyright © 2020 Pi Innovo Table of Contents Foreword .................................................................................................................. xii 1. Disclaimer .................................................................................................... xii 2. Health and Safety information ........................................................................ xii 1. Introduction ............................................................................................................ 1 1.1. Overview ..................................................................................................... 1 1.2. Included in your OpenECU kit ...................................................................... 2 1.2.1. Hardware ......................................................................................... 2 1.2.2. Software — C-API ............................................................................ 2 1.2.3. Software — Simulink API .................................................................. 2 1.2.4. Required Tools ................................................................................. 3 1.3. About MATLAB and Simulink ....................................................................... 3 1.4. Licensed Features ....................................................................................... 3 1.5. OpenECU requirements ............................................................................... 4 1.5.1. Hardware requirements ..................................................................... 4 1.5.2. Software requirements ...................................................................... 4 1.5.3. Assumed knowledge ......................................................................... 4 1.6. General development process ...................................................................... 5 1.7. Co-operational development with Pi .............................................................. 5 1.8. Warnings and safety guidelines .................................................................... 5 1.8.1. Verification of OpenECU by Pi Innovo ................................................ 6 1.9. Warning ...................................................................................................... 7 1.9.1. Personal safety ................................................................................. 7 2. Installation ............................................................................................................. 8 2.1. Introduction ................................................................................................. 8 2.1.1. Third party tool requirements ............................................................. 8 2.1.2. Third party tool requirements — C-API ............................................... 8 2.1.3. Third party tool requirements — Simulink-API ..................................... 8 2.1.4. Third party tool requirements — installation ........................................ 9 2.1.5. Third party tool requirements — compatibility .................................... 10 2.2. Installing OpenECU ................................................................................... 12 2.3. License setup ............................................................................................ 20 2.3.1. Floating license ............................................................................... 20 2.3.2. Node-locked license ........................................................................ 21 2.4. Removing OpenECU ................................................................................. 22 2.5. Integration notes for third party tools ........................................................... 23 2.5.1. Microsoft Windows 10 ..................................................................... 23 2.5.2. MATLAB ......................................................................................... 23 2.5.3. PiSnoop ......................................................................................... 24 2.5.4. ATI Vision ...................................................................................... 24 2.5.5. ETAS INCA calibration tool .............................................................. 25 2.5.6. Vector CANape ............................................................................... 26 2.5.7. Wind River (Diab) C Compiler v5.9.4.8 ............................................. 26 2.5.8. Python ............................................................................................ 27 3. Quick start ........................................................................................................... 28 3.1. Introduction ............................................................................................... 28 3.2. Installed examples ..................................................................................... 28 3.3. Exercise — Step 1 .................................................................................... 31 3.3.1. Modelling the design ....................................................................... 33 3.3.2. Defining constants and variables ...................................................... 35 3.3.3. Setting block parameters ................................................................. 36 3.3.4. Resource files ................................................................................. 44 3.3.5. Checking the model ........................................................................ 46 3.3.6. Running the model simulation .......................................................... 47 3.3.7. Building the model .......................................................................... 47 3.3.8. Programming the ECU .................................................................... 48 Copyright 2020, Pi Innovo ii User Guide OpenECU Developer Platform Sim-API 3.3.9. Playing with the application ............................................................. 50 4. Software overview ................................................................................................ 51 4.1. How to find OpenECU ............................................................................... 52 4.1.1. In Windows .................................................................................... 52 4.1.2. In MATLAB — After installation ........................................................ 52 4.1.3. In MATLAB — Help (R2013a - R2015b) ........................................... 53 4.1.4. In MATLAB — Help (R2016a and newer) ......................................... 53 4.1.5. In MATLAB — Library browser (R2013a and newer) .......................... 54 4.1.6. In MATLAB — Command line (all versions) ...................................... 54 4.2. Introduction to OpenECU ........................................................................... 55 4.2.1. Working with OpenECU ................................................................... 55 4.2.2. Create model .................................................................................. 56 4.2.3. Update model ................................................................................. 66 4.2.4. Simulate model ............................................................................... 67 4.2.5. Build model .................................................................................... 67 4.2.6. Program ECU with model ................................................................ 67 4.2.7. Test model ..................................................................................... 69 4.3. Simulink and OpenECU ............................................................................. 69 4.3.1. Block use restrictions ...................................................................... 70 4.3.2. Auto-coders .................................................................................... 71 4.3.3. Configuration sets ........................................................................... 71 4.3.4. Configuration options ...................................................................... 72 4.3.5. Selecting an auto-coder ................................................................... 77 4.3.6. Building a model ............................................................................. 79 4.4. System modes .......................................................................................... 84 4.4.1. Boot mode ...................................................................................... 85 4.4.2. Reprogramming mode ..................................................................... 85 4.4.3. Application mode ............................................................................ 85 4.5. Programming an ECU ................................................................................ 86 4.6. OpenECU blockset features ....................................................................... 90 4.6.1. Calibration tool support ................................................................... 91 4.6.2. Adaptive parameters ....................................................................... 91 4.6.3. Communications ............................................................................. 92 4.6.4. Compiler options ............................................................................. 94 4.6.5. Deprecated blocks .........................................................................