BUSMASTER Tutorial PDF

BUSMASTER Functionalities BUSMASTER Tutorial
Table of Contents
1. Abstract ............................................................................................................................... 2
2. Create a New Directory....................................................................................................... 2
3. BUSMASTER development .................................................................................................. 2
I. CAN Application ...................................................................................................................... 2
1. Create a Database ............................................................................................................... 2
2. Create Database Messages ................................................................................................. 2
3. Configure Transmission Messages ...................................................................................... 3
4. Create Nodes ...................................................................................................................... 4
5. Create Nodes Behavior ....................................................................................................... 4
II. Lin application ......................................................................................................................... 5
1. Introduction ........................................................................................................................ 5
2. Create LIN Database ........................................................................................................... 5
3. Cluster Configuration .......................................................................................................... 7
4. LIN Schedule Table Configuration....................................................................................... 7
5. LIN Controller Configuration ............................................................................................... 7
6. Transmit Messages ............................................................................................................. 7
III. MFC GUI .............................................................................................................................. 9
1. Creating the dialog window ................................................................................................ 9
2. Clean Up GUI ........................................................................ Error! Bookmark not defined.
3. Creating your Panel........................................................................................................... 10
4. Programming your Panel .................................................................................................. 11
5. Communication between Node Simulator and the Panel ................................................ 12
IV. Design panel with QT ........................................................................................................ 14
1. Panel Design...................................................................................................................... 14
2. Communicating the Panel with BUSMASTER ................................................................... 15
1
Realized by: A. CHARKAOUI & M. BOUKHRIS
1. Abstract
This is a step-by-step tutorial to introduce the basic process of developing a simple
BUSMASTER application. Used as a guide, the beginning user will get up the curve quickly.
2. Create a New Directory

Start BUSMASTER Application. Go to File -> New, create a new directory to contain the new
configuration. Name the file “Tutorial.cfx”. Then click [OK].
3. BUSMASTER development
The creation of a new BUSMASTER application involves four key steps.
1) Create a Database
2) Configure Transmission Messages
3) Create Nodes
4) Create Node behavior
I. CAN Application
1. Create a Database
1) On the BUSMASTER menu, go to CAN -> Database -> New.
2) Save the file as DBF file called “Tutorial.dbc” in the directory just created.
2. Create Database Messages

1) Select the path in the tree view on the left, right-click on it, and select New Message.
2) Name the message “Test”, put the address 0x720 and the Message Length 8 Bytes then
choose standard Frame format. You will get the tree as showing below.
Figure 1 : Database tree
3) Then select CAN -> Database -> Save and Import.

4) You can also add a signal by pressing New Signal. The window will now look like this in
the Overall View :
2
3. Configure Transmission Messages

1) Select CAN -> Transmit -> Configure.
2) Click Add to create a Message Block.
3) Select Monoshot on Tx Mode under Block Details. If you choose Cyclic, the message will
be sent periodically.
4) Keep Time Delay matched and choose 100 msec. It represents the time delay between
two messages. If you choose Key, the message will be sent after pressing the key
chosen. You can also choose delay between two messages blocks if you add more than
one message.
5) Expand the Name / ID drop-down menu and select “Test(0x720)”.
6) Write the data in the Data Bytes (02 22 FD 01 00 00 00 00), then choose channel 1, and
std in the type of data. Then click Add Message.
7) Click Update or check Auto Update.
Our message should now look like this in the Overall View:
Figure 2 : Configure Transmission Messages
3
4. Create Nodes
1) Select CAN -> Node Simulation -> Configure to create new simulation.
2) Right click on CAN Bus in the tree view on the left and choose New Simulated System.
3) Name the simulation “Tutorial” and save it as SIM file.
4) Right click on the simulation path and choose add Node.
5) Name the Node “Node1”. Then click [OK].
You will get the tree as showing below.
Figure 3 : Node tree
5. Create Nodes Behavior

1) On the Configure Simulated Systems, select Node1 and click Add New File. Name the
file “Tutorial.cpp”.
2) Now you can add a C++ code.
3) Right click on Message Handlers in the tree view on the left, and click Add. Select the
function created and copy the following code to the bottom zone and press Ctrl+S.
RxMsg.m_unMsgID = 0x712; // Message ID

RxMsg.m_ucEXTENDED = FALSE; // Standard Message type
RxMsg.m_ucRTR = FALSE; // Not RTR type
RxMsg.m_ucDLC = 8; // Length is 8 Bytes
RxMsg.m_sWhichBit.m_aucData[0] = 0xff;
RxMsg.m_sWhichBit.m_aucData[1] = 0x01;
RxMsg.m_ucChannel = 1;
SendMsg(*(STCAN_MSG*)(&RxMsg));
The editor should looks like this:
4) Click on Build and Load on the Configure Simulated Systems.

5) In the Handlers Details, choose Message Handlers and click on Enable Handler.
4
6) Select CAN -> Connect in order to run the simulation.
7) Click on start or stop sending messages to send test message.

8) In the Message Window, the result will be shown.
Our result should now look like this in the Overall View:
II. Lin application

1. Introduction
BUSMASTER can be used as master to transmit the master requests and as slave to respond
to the requests. User can monitor/analyze the LIN messages using BUSMASTER. The
following steps are required to configure the BUSMASTER for transmission of frame
headers or transmission/reception of LIN messages.
2. Create LIN Database
1) Click LIN->DatabaseEditor, the LDF Editor interface will appear.

2) Click file->new and choose one of the following LIN Version: 1.3 or 2.0 or 2.1.
Figure 4 : LIN Editor
3) Create a new signal, right click on the Signals element in the LDF element view and click
'New'. A dialog box will be shown as below:
5
Figure 5 : Create Signal
4) Right click on the Unconditional Frame element and click 'New'->'Create Unconditional
Frame'.
Figure 6 : Unconditional Frame
5) Choose the publisher and the subscriber.

Schedule Table Configuration
Configure Schedule Table window can be used to select schedule table/frame headers for
transmission imported from the loaded LDF file if BUSMASTER is used as master.
1) To create Schedule Table right click on the Schedule Table element in the element view
and click on 'New'->Create Schedule Table.
Figure 7 : Edit Schedule Table

6
2) Choose the schedule table’s name, and select the unconditional frame already created.
Then click OK.
3. Cluster Configuration
To Transmit\Receive the LIN Messages, BUSMASTER has to be configured with LIN Baud
Rate and Version. To enable master mode for LIN channel for transmitting frame headers,
check the Enable Master Mode under LIN Network Settings.
Click on LIN->Cluster Configuration menu. This will display the Window as shown in the
following figure:
Figure 8 : Cluster Configuration
4. LIN Schedule Table Configuration

LIN Schedule Table Configuration can be used to configure schedule tables imported from
LDF file to transmit master requests.
1) To configure Schedule Table click LIN->Schedule Configuration.

2) Select the Schedule Table.
Figure 9 : Configure Schedule Table
5. LIN Controller Configuration

BUSMASTER is connected to LIN physical channel via the LIN Controller.
To select the controller:
1) Click LIN->Driver Section->{Driver} for instance “Vector XL”.
2) Configure your controller, then click LIN->Connect.
6. Transmit Messages
The master can transmit frame headers and the slave can respond to the master’s requests
over LIN-bus using LIN Transmit Window.
1) Select LIN --> Transmit --> Configure menu option, to open the LIN Transmission
Window.
7
Figure 10 : Transmit Messages
Configure Master Requests:

• Select the frame type as Master {DLC and data byte values will not be editable for
frame Header}.
Configure Slave Responses:
• Select the frame type as Slave.
• If the Message is a DB Messages and if it has signals associated, then they will be
displayed in Signal List.
Cyclic Transmission of the message:
The message/frame header can be transmitted periodically by Enabling Repetition.
Cyclic transmission will be useful to transmit the message with different data bytes
periodically.
Transmission on Event:
The Message/frame header can be sent to the controller by pressing a key. Each
message in Tx Frame List can be assigned to an alpha-numeric key.
Figure 11 : Message Transmited
8
MFC GUI BUSMASTER Tutorial
III. MFC GUI

GOAL: To gain understanding of the GUI API and basic MFC Dialog Window
PREREQUISITES: C++.
1. Creating the dialog window
Open the BUSMASTER solution with Visual Studio IDE. Once done follow these steps:
1) Click on Resource View. You will get the tree as showing bellow :
Figure 12 : Panel resource tree
2) Click on Panel.rc. In order to create your GUI, choose Dialog folder.

3) Click on Dialog folder -> Insert Dialog. You will get the view as in the following figure :
Figure 13 : Insert dialog
4) Inside the Panel Window, Click on the menu item View -> Resource View.
5) Double Click on "IDD_DIALOG" to bring up the MFC Resource Editor.
6) Select the main application window by clicking on the window.
7) Right-click on main application window -> Properties -> change :
a. ID to "IDD_dialog_session";
b. Caption to "MFC_DiagSession".
8) Right-click on the Dialog and select add a class. You will have to complete certain
information like shown in the figure bellow :
9
Figure 14 : Adding a class
9) Get back to the MFC Resource Editor: Select the push-button ‘OK’ -> go to properties ->
change Caption to “Send”.
10) Select the push-button ‘Cancel’ -> go to properties -> change Caption to “Quit”.
11) Drag now "Quit" and “Send” button to the bottom-right corner of the dialog window.
12) Build the Solution by selecting the menu Build -> Build solution.
2. Design the Panel
1) Drag from the toolbox a three Radio Buttons -> Bring up the Properties window of each
Radio Button -> rename each Caption like shown in the figure bellow:
Figure 15 : Example of panel
2) Now that you have created your panel, you should integrate it in BUSMASTER interface.
To do so, you should follow this steps :
a. Go to the Visual Studio Menu -> Click View -> Solution Explorer.
b. Go to BUSMASTER Project -> Define your ID (IDD_dialog_session) in Ressource.h
file (in the header files folder).
c. Inside the file BUSMASTER.rc (in the source files folder), create your
“MENUITEM”. In the figure bellow you can see an example of panels already
created. You have to look for the POPUP “Panels”.
Figure 16 : Code to add in the ressource file
d. Now you have to associate your ID with a function which will show your panel. To do so,
go to MainFrm -> declare your function and associate it with an ID like showing in the
line bellow:
10
ON_COMMAND (YOUR ID (‘IDD_dialog_session’), YOUR FUNCTION (‘OnDiagSession’)).
e. Your function (OnDiagSession) in the main of BUSMASTER (MainFrm), will be like this:
void CMainFrame::OnDiagSession()
{
HRESULT Temp = DIL_UDS_ShowdiagSession(this->m_hWnd);
}
You will call an external function that (DIL_UDS_ShowdiagSession) you will create in the
main of the project Panel (in “main_panel.cpp”), it will be responsible of showing your
panel in BUSMASTER.
f. In the main_panel.cpp, you have to instantiate the dialog class, already created in
section two. For example: your class name is CDiagSession you will have to add :
CDiagSession * dgsession = NULL;
Now your function should look like the example bellow:
USAGEMODE HRESULT DIL_UDS_ShowdiagSession(HWND hParent)

{
CWnd objParent;
if (dgsession == NULL)
{
dgsession = new DiagSession();
dgsession->Create(IDD_dialog_session);
}
dgsession->ShowWindow(SW_SHOW);
objParent.Detach();
return 0;
}
3. Programming your Panel
In order to program it, we will use Node Simulator, where we will write our code source. As it is
mentioned before, it offers a browser where the user can write its code and simulates its
nodes.
So to make a link between the panel and the browser we give the user a parameter called
“Id_Ressource_Variables”, this parameter can represent the ID of a service and its sub service.
For example: we have our diagnostic session panel, which represent service 10 and it has tree
sub services (01-02-03).To program it we will follow these steps:
1) Click on “Id_Ressource_Variables”,add your parameter , in this example we will

program the sub service (01), so our ID will be 1001.
Figure 17 : Add an ID
11
2) When you add your parameter, a function prototype is created with your
parameter
Figure 18 : Node simulation's browser
3) Now it’s time to write your code, for this example, we need to send the frame 10
01 in CAN BUS :
Tester RxMsg;// Tester is a message from data base
RxMsg.m_sWhichBit.m_aucData[0] = 0x02;//data to send
RxMsg.m_ucChannel = 1; //channel
SendMsg(*((STCAN_MSG *)&RxMsg));
4. Communication between Node Simulator and the Panel
After creating the panel and written its code, we must make a link between the Node Simulator
and the panel.
When the user push a button, the appropriate code written in the Node Simulator should be
executed. To achieve this, you must:
1) Go back to Panel project, inside your “class”.cpp, you should include different files to
use CAN interface, Node Simulator libraries and Panel external functions file
(Panel_Externe.h) where we have developed some functions that you can use.
2) (Inside the Panel Window) Click the menu item View >> Resource View
3) Double-Click on "IDD_dialog_session" to bring up the MFC Resource Editor
4) Right-Mouse-Button click, select Add Event Handler...
5) In the 'Event Handler Wizard' window, change :
1. Message Type to BN_CLICKED

2. Class List to “Your Class Name”
3. Function Handler Name to OnBnClickedBtnDgSession (just an example)
4. Click Add and Edit
6) Within the OnBnClickedBtnDgSession() function, add the following code :
12
GetICANNode()->NS_ManageOnIDHandler("1001");
When BUSMASTER is running, this function will search the ID "1001" in the Node
Simulator and then will use the CAN BUS interface to send the frame.
Each time you will have to change the parameter according to your code in Node
Simulator.
GetICANNode()->NS_ManageOnIDHandler("YourParameter");
7) In the Visual Studio project window, click Build >> Build Solution
Here you are an example of a main panel, where multiple services were implemented:
Figure 19 : Example of Panel
13
Design panel with QT BUSMASTER Tutorial
IV. Design panel with QT

This section will present you how to design a panel using QT and communicate it with
BUSMASTER.
1. Panel Design
To design your panel, you will have to use a QT project already created named Panel. It
contains a Main Panel which is a tabulation containing several panels. The work to do is to add
your own tab and design your panel on it.
To start your design, open the Panel project (file with extention .pro) and then:
1) Select ‘Forms’ -> double click on ‘panel.ui’. You will get the tree as showing below.
Figure 20 : QT Project Tree
2) The GUI will appear as follows :
Figure 21 : The Main Panel
3) Right click on the last tab created (if you want to add your panel at the end) -> Click on
‘Insert Page’ -> ‘After Current Page’. It will appear as follows :
Figure 22 : Add new tab

14
4) Now that your tab is added you can design your panel. An example of panel is shown
below.
Figure 23 : Diagnostic Session Control Panel
2. Communicating the Panel with BUSMASTER

Once the panel is designed, now we have to communicate it with BUSMASTER. We will
continue on working at the Diagnostic Session Control.
In order to program your panel in the node simulator, you have to send an ID which is a string.
To do so you have to:
1) Right Click on the ‘Default Session’ Radio Button -> ‘Go to slot…’ -> Select signal
‘Clicked’ and then click OK. The window will appear as follows :
Figure 24 : Adding the slot
2) Once selecting the slot, a function will be created automatically and you will be
switched to the file panel.cpp. It will appear as follows :
Figure 25 : The slot function created
3) To send the ID copy the following code in the function :

fichier.open(QIODevice::WriteOnly | QIODevice::Text);
QTextStream flux(&fichier);
flux << "1001";
fichier.close();
4) In this example we have send the ID ‘1001’ referring to the service 10 and the sub-
function 01.
5) In order to show which session are used, add the following line to your code :
ui->lineEdit_72->setText("1"); (replace lineEdit_72 by the ID of your line edit).
15
6) If you want to read the content of a line edit or other and send it in order to be used in
the node simulation browser (send the content of this line edit), you have to use the
function ‘pathFinder’ as follows :
QString VAR;
VAR = ui->MYVAR->text();
pathFinder("MYVAR", VAR);
Where MYVAR is the ID of the Line edit.

7) Once you have built your project, you have to copy the executable of the Main Panel
and paste it on the Panel folder in the configuration folder as its showed in the
following figure :
Figure 26 : Configuration folder
8) In BUSMASTER :
- Select CAN -> Node Simulation -> Configure -> Select your node ‘tester’ -> Click ‘Edit
File’;
- Right-click on ID_Ressources_Variables -> click Add;
- Add the ID that you have already send it in QT (“1001”);
- Click on the function created -> write the following code :
Tester RxMsg;
RxMsg.m_sWhichBit.m_aucData[0] = 0x02; //DATA
RxMsg.m_ucChannel = 1;
SendMsg(*((STCAN_MSG *)&RxMsg));
Our function should now look like this in the Overall View:
16
- If you want to use the content of the variable MYVAR and send it in the third byte
for example, use the function ‘Utils_GetValue’ as following :
RxMsg.m_sWhichBit.m_aucData[3] = Utils_GetValue("MYVAR");
17

BUSMASTER Tutorial PDF

Uploaded by

Copyright:

Available Formats

BUSMASTER Tutorial PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

BUSMASTER Tutorial PDF

Uploaded by

Copyright:

Available Formats

BUSMASTER Functionalities BUSMASTER Tutorial

2. Create a New Directory

2. Create Database Messages

Figure 1 : Database tree

3) Then select CAN -> Database -> Save and Import.

3. Configure Transmission Messages

Figure 2 : Configure Transmission Messages

You will get the tree as showing below.

Figure 3 : Node tree

5. Create Nodes Behavior

RxMsg.m_unMsgID = 0x712; // Message ID

The editor should looks like this:

4) Click on Build and Load on the Configure Simulated Systems.

7) Click on start or stop sending messages to send test message.

II. Lin application

2. Create LIN Database

1) Click LIN->DatabaseEditor, the LDF Editor interface will appear.

Figure 4 : LIN Editor

Figure 5 : Create Signal

Figure 6 : Unconditional Frame

5) Choose the publisher and the subscriber.

Figure 7 : Edit Schedule Table

Figure 8 : Cluster Configuration

4. LIN Schedule Table Configuration

1) To configure Schedule Table click LIN->Schedule Configuration.

Figure 9 : Configure Schedule Table

5. LIN Controller Configuration

Figure 10 : Transmit Messages

Configure Master Requests:

Figure 11 : Message Transmited

III. MFC GUI

1. Creating the dialog window

Figure 12 : Panel resource tree

2) Click on Panel.rc. In order to create your GUI, choose Dialog folder.

Figure 13 : Insert dialog

Figure 14 : Adding a class

2. Design the Panel

Figure 15 : Example of panel

Figure 16 : Code to add in the ressource file

USAGEMODE HRESULT DIL_UDS_ShowdiagSession(HWND hParent)

3. Programming your Panel

1) Click on “Id_Ressource_Variables”,add your parameter , in this example we will

Figure 18 : Node simulation's browser

4. Communication between Node Simulator and the Panel

1. Message Type to BN_CLICKED

6) Within the OnBnClickedBtnDgSession() function, add the following code :

Figure 19 : Example of Panel

IV. Design panel with QT

Figure 20 : QT Project Tree

2) The GUI will appear as follows :

Figure 21 : The Main Panel

Figure 22 : Add new tab

Figure 23 : Diagnostic Session Control Panel

2. Communicating the Panel with BUSMASTER

Figure 24 : Adding the slot

Figure 25 : The slot function created

3) To send the ID copy the following code in the function :

Where MYVAR is the ID of the Line edit.

Figure 26 : Configuration folder