IXXAT CANblue II User manual

CANblue II
Bluetooth/CAN Interface
USER MANUAL
ENGLISH

HMS Technology Center Ravensburg GmbH
Helmut-Vetter-Straße 2
88213 Ravensburg
Germany
Tel.: [phone]
Fax: [phone]
Internet: www.hms-networks.de
E-Mail: [e-mail]
Support
For problems or support with this product or other HMS products please
request support at www.ixxat.com/support.
Further internation
al support contacts can be found on our webpage
www.ixxat.com
Copyright
Duplication (copying, printing, microfilm or other forms) and the electronic
distribution of this document is only allowed with explicit permission of
HMS Technology Center Ravensb
urg GmbH. HMS Technology Center
Ravensburg GmbH reserves the right to change technical data without
prior announcement. The general business conditions and the regulations
of the license agreement do apply. All rights are reserved.
Registered trademarks
All trademarks mentioned in this document and where applicable third
party registered are absolutely subject to the conditions of each valid
label right and the rights of particular registered proprietor. The absence
of identification of a trademark does
not automatically mean that it is not
protected by trademark law.
Document number: 4.01.0126.10000
Version: 2.2

Content
3
CANblue II - Manual, Version 2.2
1General functionality......................................................................6
2Hardware.........................................................................................7
2.1 Features.................................................................................. 7
2.2 Connections and control elements....................................... 7
2.2.1 Power supply X1 (PWR) ..........................................................7
2.2.2 External antenna......................................................................7
2.2.3 CAN bus plug X2 (CAN)...........................................................7
2.2.4 LED display..............................................................................8
2.2.5 Pushbutton...............................................................................9
2.2.6 Bluetooth..................................................................................9
3Extended ASCII protocol .............................................................10
4Behavior of the CANblue II ..........................................................11
4.1 Restore factory settings .......................................................11
4.2 Firmware Update...................................................................11
4.3 VCI Support ...........................................................................11
4.4 Bluetooth transmission behavior........................................ 12
4.5 Switching the message format............................................ 12
4.6 Autostart and handshake .................................................... 12
4.7 Automatic stop of the CAN controller ................................ 13
4.8 CAN filter .............................................................................. 13
4.9 Loss of connection .............................................................. 14
4.10Loss of messages................................................................ 14
4.10.1 CAN receive buffer overflow.................................................14
4.10.2 Bluetooth transmission buffer overflow.................................14
4.10.3 CAN transmission buffer overflow........................................14
4.10.4 Loss of responses to commands..........................................14
4.11CAN-Controller Errors ......................................................... 15
4.11.1 WARNING:...........................................................................15
4.11.2 BUS-OFF-Recovery: ............................................................15
5Establishing a connection and configuration ............................16
5.1 Installing the virtual COM port ............................................ 16
5.1.1 Windows XP...........................................................................16
5.1.2 Windows 7..............................................................................20

Content
4
CANblue II - Manual, Version 2.2
5.2 CanBlueCon Configuration Tool ......................................... 24
5.2.1 Command Line Parameters...................................................24
5.2.2 Additional Commands............................................................24
5.2.3 Interactive Mode ....................................................................25
5.2.4 Batch Mode............................................................................26
5.2.4.1 Rx-Tx Demo.............................................................26
5.2.4.2 Bridge Mode Setup Demo........................................27
5.3 Connecting with Hyperterminal........................................... 29
5.4 Configuration examples....................................................... 29
5.4.1 Connecting CAN to the PC through the CANblue II ..............29
5.4.2 Configuring a CAN bridge with two CANblue II devices........31
5.4.3 Connecting another CANblue II.............................................34
6Extended ASCII-Protocol Commands........................................ 35
6.1 Device specific Commands................................................. 35
6.1.1 D VERSION ...........................................................................35
6.1.2 D PROTOCOL .......................................................................35
6.1.3 D IDENTIFY...........................................................................36
6.1.4 D INFO...................................................................................36
6.1.5 D CONFIG..............................................................................37
6.1.6 D MAC_ADD..........................................................................39
6.1.7 D MAC_REMOVE..................................................................39
6.1.8 D MAC_CLEAR .....................................................................40
6.1.9 D MAC_SCAN........................................................................40
6.1.10 D MAC_MASTER_ADD .......................................................41
6.1.11 D MAC_MASTER_REMOVE ...............................................42
6.1.12 D MAC_MASTER_CLEAR...................................................42
6.1.13 D PASSKEY_SET................................................................43
6.1.14 D VISIBILITY TIMEOUT.......................................................43
6.1.15 D BUFF_TIMEOUT ..............................................................44
6.1.16 D LINK_POLICY...................................................................44
6.1.17 D RESET..............................................................................45
6.1.18 D SETTINGS_DEFAULT .....................................................46
6.1.19 D DISCONNECT_SET.........................................................46
6.1.20 D DISCONNECT_RESET....................................................47

Content
5
CANblue II - Manual, Version 2.2
6.2 CAN Controller Commands................................................. 47
6.2.1 C CONFIG..............................................................................47
6.2.2 C CAN_INFO .........................................................................48
6.2.3 C CAN_INIT ...........................................................................49
6.2.4 C CAN_INIT_AUTO...............................................................50
6.2.5 C CAN_INIT_CUSTOM..........................................................50
6.2.6 C CAN_START......................................................................51
6.2.7 C CAN_STOP........................................................................52
6.2.8 C CAN_RESET......................................................................52
6.2.9 C AUTOSTART......................................................................53
6.2.10 C SEND_CAN_FRAMES .....................................................53
6.2.11 C FILTER_ADD....................................................................54
6.2.12 C FILTER_REMOVE............................................................55
6.2.13 C FILTER_CLEAR................................................................55
6.2.14 C FILTER_ENABLE .............................................................56
6.2.15 C FILTER_DISABLE ............................................................56
6.3 CAN Bluetooth Messages.................................................... 57
6.3.1 M (ASCII) ...............................................................................57
6.3.2 X (Binary) ...............................................................................58
6.4 Error Response .................................................................... 60
7Appendix.......................................................................................61
7.1 Support ................................................................................. 61
7.2 Returning hardware ............................................................. 61
7.3 Disposing of old equipment................................................ 61
7.4 Information on EMC............................................................. 61
7.5 Compliance with RoHS directive......................................... 61
7.6 FCC Compliance Statement................................................. 62
7.7 EC Declaration of Conformity ............................................. 63
7.8 Japan Radio Equipment Compliance (TELEC)................... 63
7.9 Technical Specifications...................................................... 65

General functionality
6
CANblue II - Manual, Version 2.2
1 General functionality
The CANblue II units enables multiple CAN networks to connect wirelessly us-
ing the Bluetooth Serial Port Profile (SPP). If two CANblue II units are con-
nected, one unit acts as the SPP server and one as the SPP client. The units
can act as server and client in different connections simultaneously, allowing
more than two units – and thus multiple CAN networks – to be connected. To
establish an SPP connection between two units, the unit acting as the client
should be given the Bluetooth MAC address of the server. The client then at-
tempts to establish a connection to the other CANblue II. Each CANblue II for-
wards the messages it receives from the CAN network to all existing SPP con-
nections. Conversely, all CAN messages received from Bluetooth are sent into
the CAN network and, if there are any, to other SPP connections as well.
In addition to the SPP server and client for chaining CANblue II units, each
CANblue II also provides an additional SPP server. Any other Bluetooth-
capable unit that supports SPP can connect to this server. This connection can
be used to configure the CANblue II and CAN messages can be received or
sent.
There is an ASCII protocol defined for communication with the CANblue II that
provides commands for the configuration of the units and the transmis-
sion/receiving of CAN messages.
Fig.: 1-1 Networking example

Hardware
7
CANblue II - Manual, Version 2.2
2 Hardware
2.1 Features
Bluetooth specification V 2.1 + EDR (Enhanced Data Rate)
Power supply 9 - 30 V DC
Microcontroller STM32F103RC with integrated CAN controller, 72 MHz
Bluetooth Radio Ericsson STLC2500
Available with integrated or external antenna
Different external antennas available
2.2 Connections and control elements
Fig.: 2-1 Connections and control elements
2.2.1 Power supply X1 (PWR)
The unit is supplied with a DC voltage from 9 V to 30 V. The connection pinout
is shown in the following table.
The CANblue II is protected against polarity reversal.
X1
Pin no.
Signal
1
PWR (+)
2
GND (-)
2.2.2 External antenna
The external antenna must be screwed on the connector on the top of the
CANblue II. Further information about different antennas can be found on
www.ixxat.com.
2.2.3 CAN bus plug X2 (CAN)
The CANblue II has an ISO 11898-2 bus coupling. The signals for the bus
coupling are on the 9-pin sub-D plug as shown in the following table.

Hardware
8
CANblue II - Manual, Version 2.2
X2
Pin no.
Signal
1
-
2
CAN-L
3
GND
4
-
5
-
6
-
7
CAN-H
8
-
9
-
2.2.4 LED display
The CANblue II has three LEDs for signaling different states:
LED
Display
Description
Mode
steady red
No Bluetooth MAC address is stored in the
configuration of the CANblue II, and there is
no connection to an SPP server on the unit.
CAN
flashing green
A CAN message has been sent or received
and the CAN controller is not in the warning
state.
flashing red
A CAN message has been sent or received
and the CAN controller is in the warning
state.
steady red
The CAN controller is in the BUS-OFF state.
Bluetooth
flashing blue
(2 Hz)
An attempt is made to establish a Bluetooth
SPP connection with another Bluetooth
device or a connection is being established
to this device.
flashing blue
(10 Hz)
Bluetooth SPP is used to send or receive
data.
steady blue
There is at least one Bluetooth SPP
connection to another device.

Hardware
9
CANblue II - Manual, Version 2.2
2.2.5 Pushbutton
Pushbutton
Description
T1
Restore factory settings see Section 4.1
T2
Not used
2.2.6 Bluetooth
The internal Bluetooth interface needs a unique MAC address (MAC-ID) to
communicate. The MAC-ID is on the back of the device and is also used for
the unique identification of devices when searching for them with Bluetooth.
See also chapter 5, "Establishing a connection and configuration".

Extended ASCII protocol
10
CANblue II - Manual, Version 2.2
3 Extended ASCII protocol
To configure and transmit Bluetooth CAN messages, there is an ASCII proto-
col defined. There is also a binary format available for the transmission of
Bluetooth CAN messages to permit a better data rate. CANblue II units always
use the binary format for CAN messages transmitted between them.
ASCII commands have the following structure:
Message type
Command
Parameter 1
…
Parameter n
LF or CR-LF
Individual fields are separated by blanks.
Multiple sequential blanks are considered to be a single blank.
There is no distinction between capital and lower-case letters.
A message is terminated with the ASCII linefeed control code (LF or "\n") or
with a carriage return and linefeed (CR LF or "\r\n").
ASCII messages sent by the CANblue II are terminated with the same ASCII
control codes as ASCII messages sent by the user. If the user has not yet
sent any ASCII messages, the CANblue II uses CR-LF as the terminator.
There are six different message types defined. The message type is defined
by the first byte.
"D"
Device-specific commands
"C"
CAN-specific commands
"M"
CAN messages in ASCII format
"X"
CAN messages in binary format
"I"
Info messages
"E"
Error messages
Examples:
ASCII command
Response from the CANblue II
„C CAN_INIT 250\n“
„I OK: CAN_INIT\n“
„C CAN_START\r\n“
„I OK: CAN_START\r\n“
„C FILTER_ADD EXT 7FA1 RTR\r\n“
„I OK: FILTER_ADD\r\n“
„D SETTINGS_DEFAULT\n“
„I OK: SETTINGS_DEFAULT\n“
A list of all ASCII commands can be found in chapter 6 "Extended ASCII-Protocol Commands"(p.35).