Programming with CAPL CANalyzer CANoe the art of engineering Programming With CAPL December 14, 2004 First printing Vector CANtech, Inc. Suite 550 39500 Orchard Hill Place Novi, MI 48375 USA http://www.vector-cantech.com II © 2004, 2005 Vector CANtech, Inc Novi, Michigan 48375 USA The authors and publishers have used their best efforts in preparing this book. These efforts include development, research, and testing of the theories, principles, and programming sample code so as to determine their effectiveness. The authors and/or publishers make no warranty, expressed or implied, with regard to the sample code or to any other documentation contained in this book. The authors and/or publishers shall not be liable in any event for incidental or consequential damages in connection with, or arising out of, the furnishing, performance, or use of the sample code or any of the contents of this book. All rights reserved. No part of this book may be reproduced, in any form or by any means, without express permission in writing from Vector CANtech, Inc. Table of Contents III Preface..............................................................................................................................................................................IX About This Book ............................................................................................................................................................IX Organization ..................................................................................................................................................................IX Acknowledgments .........................................................................................................................................................IX Tell Us What You Think!.................................................................................................................................................X 1 Introduction to CAPL................................................................................................................................................... 1 1.1 Evaluation Capability........................................................................................................................................... 1 1.2 Simulation Capability........................................................................................................................................... 1 1.3 Prerequisites for Using CAPL.............................................................................................................................. 2 1.4 Learning Steps .................................................................................................................................................... 2 1.5 CAPL – Event-Driven Software ........................................................................................................................... 3 1.6 CAPL Program Organization............................................................................................................................... 3 1.7 Using the CAPL Browser for Program Development .......................................................................................... 3 1.8 Program Development Uses the Database Tool – CANdb++............................................................................. 3 1.9 CAPL Programming Knowledge.......................................................................................................................... 4 1.10 CAN Communication Knowledge .................................................................................................................... 4 1.11 THE WARNING – Welcome to the Jungle....................................................................................................... 4 1.12 Responsibility................................................................................................................................................... 5 2 CANalyzer and CANoe............................................................................................................................................... 6 2.1 One Key Difference – Level of Node Control ...................................................................................................... 6 2.2 Graphic Panels – The Other Major Difference .................................................................................................... 7 3 A Brief Introduction to CANalyzer............................................................................................................................... 9 3.1 Value of the Downloadable Demo....................................................................................................................... 9 3.2 First-Time Considerations ................................................................................................................................... 9 3.3 How to Start and Stop CANalyzer ..................................................................................................................... 10 3.4 The Architecture of CANalyzer.......................................................................................................................... 10 3.5 Measurement Setup Window ............................................................................................................................ 12 3.5.1 Trace Window ............................................................................................................................................ 12 3.5.2 Statistics Window ....................................................................................................................................... 12 3.5.3 Bus Statistics Window................................................................................................................................ 13 3.5.4 Data Window.............................................................................................................................................. 13 3.5.5 Graphics Window ....................................................................................................................................... 13 3.5.6 Write Window ............................................................................................................................................. 13 3.6 Duplicating Analysis Blocks............................................................................................................................... 13 3.7 Controlling Data Flow ........................................................................................................................................ 13 3.8 Function Blocks ................................................................................................................................................. 13 3.8.1 Filtering Blocks........................................................................................................................................... 14 3.8.2 Message Blocks ......................................................................................................................................... 15 3.9 Using CAPL Program Blocks in CANalyzer ...................................................................................................... 17 3.9.1 CANalyzer Program Blocks for Transmission............................................................................................ 18 3.9.2 Program Blocks for Analysis ...................................................................................................................... 19 3.10 CANalyzer – CAPL Programming Environment ............................................................................................ 20 4 A Brief Introduction to CANoe .................................................................................................................................. 21 4.1 Value of the Downloadable Demo..................................................................................................................... 21 4.2 First-Time Considerations ................................................................................................................................. 21 4.3 Learning from the Demo.................................................................................................................................... 22 4.4 Tool Architecture of CANoe............................................................................................................................... 23 4.5 Using CAPL Program Blocks in CANoe............................................................................................................ 24 4.5.1 CANoe Program Blocks for Simulation ...................................................................................................... 24 4.5.2 CANoe Program Blocks for Analysis.......................................................................................................... 25 4.6 CANoe – CAPL Programming Environment ..................................................................................................... 25 5 Using Databases with CAPL .................................................................................................................................... 26 5.1 Why Use a Database with CAPL?..................................................................................................................... 26 5.1.1 Additional Uses of the Database...............................................................................................................