EHOOKS V4.9 User Guide Copyright The data in this document may not be altered or amended without special notification from ETAS GmbH. ETAS GmbH undertakes no further obligation in relation to this docu- ment. The software described in it can only be used if the customer is in possession of a general license agreement or single license. Using and copying is only allowed in concur- rence with the specifications stipulated in the contract. Under no circumstances may any part of this document be copied, reproduced, transmit- ted, stored in a retrieval system or translated into another language without the express written permission of ETAS GmbH. © Copyright 2020 ETAS GmbH, Stuttgart The names and designations used in this document are trademarks or brands belonging to the respective owners. Document R4.9 EN Contents 1 Introduction .......................................................................................................................... 10 1.1 Safety Notice ................................................................................................................. 11 1.2 Privacy Statement .......................................................................................................... 12 1.2.1 Data Processing ................................................................................................. 12 1.2.2 Technical and organizational measures ................................................................ 12 1.3 Conventions ................................................................................................................... 12 2 Getting Started ..................................................................................................................... 14 2.1 Installation .................................................................................................................... 14 2.2 Silent Installation ........................................................................................................... 15 2.3 Licensing ....................................................................................................................... 15 2.4 Post Installation Setup and Configuration Steps ............................................................... 16 2.4.1 Installed Versions of EHOOKS pacakges ............................................................... 16 2.4.2 EHOOKS-DEV Simulink Configuration ................................................................... 17 3 EHOOKS Overview ................................................................................................................ 19 3.1 EHOOKS Workflow ......................................................................................................... 19 3.1.1 Step 1: EHOOKS Prepared ECU Software ............................................................. 19 3.1.2 Step 2: Creating the Hook Configuration .............................................................. 19 3.1.3 Step 3: Running the EHOOKS-DEV ECU Target Support Tools ............................... 20 3.1.4 Step 4: EHOOKS-DEV Generated ECU Software .................................................... 20 3.1.5 Step 5: Working with the EHOOKS-DEV Generated ECU Software .......................... 20 3.2 EHOOKS-DEV Features ................................................................................................... 21 3.2.1 EHOOKS-DEV Hook Types ................................................................................... 21 3.2.2 EHOOKS-DEV Hook Configuration Properties ........................................................ 24 3.2.3 Service Points .................................................................................................... 30 4 EHOOKS-PREP Dependencies ................................................................................................. 31 5 Configuring EHOOKS-DEV ...................................................................................................... 35 5.1 General Settings Tab ...................................................................................................... 36 5.1.1 A2L Section ........................................................................................................ 36 5.1.2 ECU Image ........................................................................................................ 38 5.1.3 Project Settings .................................................................................................. 38 5.1.4 Project Information ............................................................................................ 39 5.2 Variable Bypass Tab ....................................................................................................... 40 5.2.1 Selecting Variables to Be Hooked ........................................................................ 41 5.2.2 Configuring Properties of a Variable Hook ............................................................ 43 5.2.3 Multi-Select Operation ........................................................................................ 49 2 Contents 5.2.4 Copy and Paste .................................................................................................. 50 5.3 Function Bypass Tab ...................................................................................................... 51 5.4 On-Target Bypass Tab .................................................................................................... 53 5.4.1 Configuring Properties of an On-Target Bypass Function ....................................... 54 5.5 Service Points Tab .......................................................................................................... 60 5.6 Group Tab ..................................................................................................................... 63 5.6.1 Configuring the properties of a Group .................................................................. 63 5.7 Build Tab ....................................................................................................................... 65 5.7.1 Configuring Build Source Files ............................................................................. 65 5.7.2 Configuring Memory Sections .............................................................................. 67 5.7.3 Configuring pre- and post-build scripting ............................................................. 69 5.7.4 Configuring macro definitions .............................................................................. 71 5.7.5 Configuring Characteristic Groups ........................................................................ 71 5.8 Configuration Consistency Checking, Building and Options ................................................ 72 5.8.1 Consistency Checking ......................................................................................... 72 5.8.2 Building Hooked ECU Software ............................................................................ 73 5.8.3 Options .............................................................................................................. 73 5.9 Project Actions ............................................................................................................... 74 5.9.1 Convert All Paths ................................................................................................ 74 5.9.2 Delete all externally configured items .................................................................. 75 5.9.3 On-target bypass ................................................................................................ 75 5.9.4 Filter files ........................................................................................................... 75 5.9.5 Advanced actions ............................................................................................... 77 6 Working with Hooked ECU Software in INCA ........................................................................... 78 6.1 Run-Time Hook Control and Monitoring ........................................................................... 78 6.2 Offset Hooks .................................................................................................................. 80 6.3 Backup Measurement Copies .......................................................................................... 81 6.4 Safety Checks ................................................................................................................ 81 6.5 Using EHOOKS-CAL and EHOOKS-BYP to Work with Hooks in INCA ................................... 82 6.6 A2L Function Groups ...................................................................................................... 84 7 Creating and Working with Simple Internal Bypass .................................................................. 87 8 Creating and Working with External Bypass ............................................................................ 89 8.1 Hook based bypass (HBB) ............................................................................................... 89 8.2 Service based bypass (SBB) ............................................................................................ 90 9 Creating and Working with On-Target Bypass ......................................................................... 91 9.1 Introduction ................................................................................................................... 91 9.2 Step 1: Configure On-Target Bypass Hooks