® User Guide OpenECU Developer Platform C-API Release 3.0.3-FS (r2019-3) Copyright © 2019 Pi Innovo Table of Contents Foreword ................................................................................................................... xi 1. Disclaimer ..................................................................................................... xi 2. Health and Safety information ........................................................................ xi 1. Introduction ............................................................................................................ 1 1.1. Included in your OpenECU kit ...................................................................... 1 1.1.1. Hardware ......................................................................................... 2 1.1.2. Software ........................................................................................... 2 1.2. Licensed Features ....................................................................................... 2 1.3. OpenECU requirements ............................................................................... 3 1.3.1. Hardware requirements ..................................................................... 3 1.3.2. Software requirements ...................................................................... 3 1.3.3. Assumed knowledge ......................................................................... 3 1.4. Co-operational development with Pi .............................................................. 4 1.5. Warnings and safety guidelines .................................................................... 4 1.5.1. Verification of OpenECU by Pi Innovo ................................................ 5 1.6. Warning ...................................................................................................... 6 1.6.1. Personal safety ................................................................................. 6 1.6.2. Disclaimer ........................................................................................ 6 2. Installation ............................................................................................................. 7 2.1. Introduction ................................................................................................. 7 2.1.1. Third party tool requirements ............................................................. 7 2.1.2. Third party tool requirements — C-API ............................................... 7 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 ................................................................................... 11 2.3. License setup ............................................................................................ 17 2.3.1. Floating license ............................................................................... 17 2.3.2. Node-locked license ........................................................................ 19 2.4. Removing OpenECU ................................................................................. 19 2.5. Integration notes for third party tools ........................................................... 20 2.5.1. Microsoft Windows 10 ..................................................................... 20 2.5.2. Microsoft Windows 7 ....................................................................... 20 2.5.3. Microsoft Windows XP .................................................................... 21 2.5.4. PiSnoop ......................................................................................... 21 2.5.5. ATI Vision ...................................................................................... 21 2.5.6. ETAS INCA calibration tool .............................................................. 22 2.5.7. Vector CANape ............................................................................... 22 2.5.8. Wind River (Diab) C Compiler v5.5.1.0 ............................................. 22 2.5.9. Wind River (Diab) C Compiler v5.8.0.0 ............................................. 24 2.5.10. Wind River (Diab) C Compiler v5.9.0.0 ........................................... 25 2.5.11. Wind River (Diab) C Compiler v5.9.4.8 ........................................... 25 2.5.12. GCC Compiler v4.7.3 .................................................................... 26 2.5.13. Python .......................................................................................... 27 3. Quick start ........................................................................................................... 28 3.1. Introduction ............................................................................................... 28 3.2. Installed examples ..................................................................................... 28 3.3. Exercise — Step 1 .................................................................................... 28 3.3.1. Designing the application ................................................................. 30 3.3.2. Create the application ..................................................................... 30 3.3.3. Review the application .................................................................... 30 3.3.4. Implement the sensor reading .......................................................... 32 3.3.5. Implement the sensor conversion to temperature .............................. 33 3.3.6. Implement the threshold comparison ................................................ 36 3.3.7. Implement the lamp driver ............................................................... 36 Copyright 2019, Pi Innovo ii User Guide OpenECU Developer Platform C-API 3.3.8. Summary so far .............................................................................. 37 3.3.9. Create data dictionary and interface specification files ....................... 39 3.3.10. Building the application .................................................................. 41 3.3.11. Program the ECU ......................................................................... 42 3.3.12. Play with the application ................................................................ 44 4. Software overview ................................................................................................ 46 4.1. Introduction ............................................................................................... 46 4.2. System components .................................................................................. 46 4.3. System modes .......................................................................................... 48 4.4. Boot mode ................................................................................................ 48 4.5. Reprogramming mode ............................................................................... 49 4.6. Application mode ....................................................................................... 54 4.6.1. Building an application .................................................................... 55 4.6.2. Interface specification ...................................................................... 58 4.6.3. Data dictionary and engineering unit files .......................................... 58 4.6.4. Application and library tasks ............................................................ 58 4.6.5. Library status and error handling ...................................................... 61 4.6.6. Compiler library support .................................................................. 61 4.6.7. Deprecated library features .............................................................. 62 4.6.8. Examples ....................................................................................... 62 5. Library interface ................................................................................................... 65 5.1. Introduction ............................................................................................... 67 5.1.1. Name-spaces, naming conventions and library composition ............... 67 5.1.2. File locations .................................................................................. 68 5.1.3. Layout of each feature section ......................................................... 69 5.1.4. Notations ........................................................................................ 69 5.2. System feature (PSY) ................................................................................ 70 5.2.1. Overview ........................................................................................ 70 5.2.2. System types .................................................................................. 70 5.2.3. Error log ......................................................................................... 70 5.2.4. Interface index ................................................................................ 71 5.2.5. Interface detail ................................................................................ 75 5.3. System start-up and background processing (PSC) ...................................... 84 5.3.1. Overview ........................................................................................ 84 5.3.2.