How to edit States and State Groups Version 1.2 2008-09-23

How to edit States and State Groups
Version 1.2
2008-09-23
Application Note AN-IDG-1-005
Author(s)
Restrictions
Abstract
Huber, Carsten
Public Document
This application note describes how to edit and use states and state groups of a
CANdelaStudio document.
Table of Contents
1.0
1.1
1.2
1.3
1.4
1.5
2.0
3.0
4.0
Overview ..........................................................................................................................................................1
Session State Group .....................................................................................................................................1
Security State Group .....................................................................................................................................2
Graphical Representation of States ..............................................................................................................2
Editing State Transitions ...............................................................................................................................3
Defining Default State Transitions.................................................................................................................3
Automatic Setting of State Transitions.............................................................................................................4
Additional Resources .......................................................................................................................................4
Contacts ...........................................................................................................................................................4
1.0 Overview
This application note describes how to edit and use states and state groups of a CANdela document. Setting states
and state transitions properly is essential if you want to create automatic tests with CANoe Option DiVa.
Executing a service generally causes a state change in the ECU. Some services may only be executed if the ECU
is in a particular state. For this, CANdelaStudio offers the opportunity to define and edit global states and state
transitions on the services of a diagnostic instance. States can further be combined into state groups to describe
the state machine defined by services, states and state transitions.
CANdelaStudio supports two state groups with special semantics: “Session” and “Security”. States which follow no
specific semantic can be set to semantics “None”.
1.1 Session State Group
The “session” state group contains all states belonging to session control (service $10 StartDiagnosticSession).
States in this state group are used to manage the execution of services in a certain session (e.g. Programming
Session, Default Session etc.)
If your CANdela document does not contain a “session” state group, proceed as following:
1. Go to chapter “States/State Groups”
2. Click on the magic line of the upper table
3. Rename the new state group to e.g. “Session”
4. Set “Semantics” to “session”
1
Copyright © 2008 - Vector Informatik GmbH
Contact Information: www.vector-informatik.com or ++49-711-80 670-0
How to edit States and State Groups
Figure 1: Entry mask “State Groups”
1.2 Security State Group
The “security” state group contains all states belonging to security access control (service $27 SecurityAccess).
States in this state group are used e.g. to set the ECU in a locked mode (no service can be executed) or to handle
access to security critical services like IO-Control.
If your CANdela document does not contain a “security” state group, proceed as described above but rename the
state group to “Security” and set “Semantics” to “security”.
1.3 Graphical Representation of States
CANdelaStudio offers a graphical overview of all states and state transitions of the services in a CANdela
document. It is located in the “Dependencies” chapter of the CANdela document. The view window takes up the
main part of the entry mask. There are three lists under the view window, which you can use to select one of three
views, the variant and the state group that are to be displayed in the view window.
The entry mask offers three views:
•
•
•
Note:
“State diagram” plots the graph of the currently selected state group and variant in the graphic window.
“Editing” replaces the current view with a tabular view, in which you can edit the state transitions.
“Overview” replaces the current view with a tabular view that provides an overview of all states.
You must have installed the external program “GraphViz” in order to view the graphics. For
information about this program see http://www.graphviz.org.
2
Application Note AN-IDG-1-005
How to edit States and State Groups
Figure 2: Graphical view of the state dependencies
1.4 Editing State Transitions
You can edit state transitions of existing services in the entry mask of chapter “Dependencies”. To do so, click on
. The graphical state diagram will be replaced by a tabular view with columns “Service”, “Protocol Service”,
“Prefix”, as well as additional columns for each state defined in the selected State group.
The names of the columns to the right of column “Prefix” represent the current ECU state before service execution.
In these columns, you can define the state the ECU will reach after execution of the respective service is
completed. The contents of these columns have the following meaning:
• “(no)”: the service must not be executed.
• "(yes)": the service may be executed, but triggers no state transition.
• Name: the service may be executed and triggers a state transition to the specified state.
If you want to modify multiple state transitions at once, highlight the respective lines with the bar in the desired
column, and then press <F2>. Select the state from the appearing list and press <Return>.
1.5 Defining Default State Transitions
You can also define default state transitions for new services. You can do this in chapter “Defaults” of the “States”
chapter of a CANdelaStudio document. The entry mask of this chapter provides the same tabular view as the
“Dependencies” chapter if “Editing” is selected under View. See chapter 1.4 for a description of the tabular view.
3
Application Note AN-IDG-1-005
How to edit States and State Groups
2.0 Automatic Setting of State Transitions
CANdelaStudio offers automatic setting of state transitions via its Session and Security Level Wizards. Both
Wizards use states defined in state groups “session” and “security”, if present (see description above).
Note: To achieve correct results, you should add a state “Locked” to state group “Security”. This state is used by
Session Wizard and Security Level Wizard to set the state transition which resets the ECU to a locked state.
You can find further information on these Wizards in the online help of CANdelaStudio.
3.0 Additional Resources
VECTOR APPLICATION NOTE
AN-ION-1-1050 Introduction to Vehicle Network Software Development
AN-AND-1-121 Introduction to Detroit’s CAN-based Physical Layers
4.0 Contacts
Vector Informatik GmbH
Ingersheimer Straße 24
70499 Stuttgart
Germany
Tel.: +49 711-80670-0
Fax: +49 711-80670-111
Email: info@vector-informatik.de
Vector CANtech, Inc.
39500 Orchard Hill Pl., Ste 550
Novi, MI 48375
USA
Tel: +1-248-449-9290
Fax: +1-248-449-9704
Email: info@vector-cantech.com
VecScan AB
Theres Svenssons Gata 9
41755 Göteborg
Sweden
Tel: +46 (0)31 764 76 00
Fax: +46 (0)31 764 76 19
Email: info@vecscan.com
Vector France SAS
168 Boulevard Camélinat
92240 Malakoff
France
Tel: +33 (0)1 42 31 40 00
Fax: +33 (0)1 42 31 40 09
Email: information@vector-france.fr
Vector Japan Co. Ltd.
Seafort Square Center Bld. 18F
2-3-12, Higashi-shinagawa,
Shinagawa-ku
Tokyo 140-0002
Japan
Tel.: +81 3 5769 7800
Fax: +81 3 5769 6975
Email: info@vector-japan.co.jp
Vector Korea IT Inc.
Daerung Post Tower III, 508
182-4 Guro-dong, Guro-gu
Seoul, 152-790
Republic of Korea
Tel.: +82-2-2028-0600
Fax: +82-2-2028-0604
Email: info@vector-korea.com
4
Application Note AN-IDG-1-005