BlueCore
®
VMSpy
User Guide
Issue 5
© Cambridge Silicon Radio Limited 2008-2014
Page 1 of 8
CS-123515-UGP5
www.csr.com
Document History
Revision
Date
History
1
03 OCT 08
Original publication of this document.
2
08 JUL 10
Updated for 2010 Bluetooth SDKs with BlueLab references removed.
Updated to latest style guidelines.
3
16 AUG 13
Updated to latest CSR style
4
01 JAN 12
Updated to latest CSR style
5
09 APR 14
Updated to latest CSR style
General information
Information on this product
Customer support for this product
More detail on compliance and standards
Help with this document
© Cambridge Silicon Radio Limited 2008-2014
www.csr.com
sales@csr.com
www.csrsupport.com
product.compliance@csr.com
comments@csr.com
Page 2 of 8
CS-123515-UGP5
www.csr.com
BlueCore VMSpy User Guide
Contacts
Trademarks, Patents and Licences
Unless otherwise stated, words and logos marked with ™ or ® are trademarks registered or owned by CSR plc
and/or its affiliates.
Bluetooth® and the Bluetooth logos are trademarks owned by Bluetooth SIG, Inc. and licensed to CSR.
Other products, services and names used in this document may have been trademarked by their respective owners.
The publication of this information does not imply that any licence is granted under any patent or other rights owned
by CSR plc or its affiliates.
CSR reserves the right to make technical changes to its products as part of its development programme.
While every care has been taken to ensure the accuracy of the contents of this document, CSR cannot accept
responsibility for any errors.
Life Support Policy and Use in Safety-critical Compliance
Performance and Conformance
Refer to www.csrsupport.com for compliance and conformance to standards information.
© Cambridge Silicon Radio Limited 2008-2014
Page 3 of 8
CS-123515-UGP5
www.csr.com
BlueCore VMSpy User Guide
CSR’s products are not authorised for use in life-support or safety-critical applications. Use in such applications is
done at the sole discretion of the customer. CSR will not warrant the use of its devices in such applications.
Contents
Document History ......................................................................................................................................................... 2
Contacts........................................................................................................................................................................ 2
Trademarks, Patents and Licences .............................................................................................................................. 3
Life Support Policy and Use in Safety-critical Compliance............................................................................................ 3
Performance and Conformance .................................................................................................................................... 3
Contents ....................................................................................................................................................................... 4
1. VMSpy ................................................................................................................................................................... 5
Document References .................................................................................................................................................. 8
Terms and Definitions ................................................................................................................................................... 8
BlueCore VMSpy User Guide
© Cambridge Silicon Radio Limited 2008-2014
Page 4 of 8
CS-123515-UGP5
www.csr.com
1.
VMSpy
The VMSpy application collects debug output from a VM application into a useful dialogue. You can also use it as a
simple terminal application to access BCSP channel 13. This channel is used for communications between the host
and the VM application. VMSpy needs to connect to the BlueCore device on your development platform (e.g a
casira) over a serial or USB connection. Ensure that:

Your development platform is connected to the PC via a suitable cable.

Nothing else is using that port (including other CSR software).

The appropriate transport has been configured using PSTool.
Note:
PSTool is included in the tools shipped with Bluetooth SDKs and BlueSuite Development Tools.
VMSpy can use any host transport that can carry BCSP, i.e:
BCSP over the UART

H4 over the UART

H4DS over UART

H5 over the UART

H2 over USB
It cannot be connect using raw UART access, or over SPI.
To log a session to file, click the Log button. To initiate a connection, click the Connect button. Select the transport
and other settings to match the configuration of your development hardware.
When VMSpy has connected to the development platform, all debugging output is displayed in the main window. If
the application uses the VM data channel 13 for BCSP using either streams or the host messages, the channel
traffic can be viewed by clicking the VM Data button. This button opens a window that shows all traffic on this
channel.
© Cambridge Silicon Radio Limited 2008-2014
Page 5 of 8
CS-123515-UGP5
www.csr.com
BlueCore VMSpy User Guide

BlueCore VMSpy User Guide
If the application uses the printf function, the output displays in the main window. This is the same text displayed
in the Print Channel 0 tab in xIDE.
1.
This window displays the output generated by the printf statement,
e.g. printf(“Hello, VMSpy!\n”).
2.
If the application sends data to the host using BCSP channel 13, the message displays in the VM Data
window. Host message (word) based data is prefixed by “Words:” and stream (byte) based data by
”Bytes nn:” where nn is the channel number used. The window in this example shows the output
using BCSP channel 13 of the following code example:
uint16 msg[] = {0x0004,/* length */
0x0000,/* sub-type */
0x0102,/* data */
0x0304,/* data */};
HostSendMessage(msg);
and also by writing the text “\x05\x06” to the Sink using the function StreamHostSink(0). For further details,
see Implementing Streams in Bluetooth SDKs.
3.
This field enables you to send information to the device on your development platform. It can contain
numbers (decimal, hex or octal) or character strings (delimited with “). The first entry on the line must
be a number defining sub-type or Host Stream channel. Do not enter the length field: it is calculated
automatically.
© Cambridge Silicon Radio Limited 2008-2014
Page 6 of 8
CS-123515-UGP5
www.csr.com
4.
The Send as radio buttons select whether the data is sent as message (word) or stream (byte):

Message-based information is sent to a task selected using MessageHostCommsTask
Stream-based data is available via the Source as specified by the StreamHostSource(channel) function
BlueCore VMSpy User Guide
© Cambridge Silicon Radio Limited 2008-2014
Page 7 of 8
CS-123515-UGP5
www.csr.com
Document References
Document
Reference
Implementing Streams in BlueCore Applications
CS-207483-UG
Terms and Definitions
BlueCore Serial Protocol
BlueCore®
Group term for CSR’s range of Bluetooth wireless technology chips
Bluetooth®
Set of technologies providing audio and data transfer over short-range radio connections
CSR
Cambridge Silicon Radio
e.g.
exempli gratia, for example
i.e.
Id est, that is
PC
Personal Computer
SPI
Serial Peripheral Interface
UART
Universal Asynchronous Receiver Transmitter
USB
Universal Serial Bus
VM
Virtual Machine
© Cambridge Silicon Radio Limited 2008-2014
BlueCore VMSpy User Guide
BCSP
Page 8 of 8
CS-123515-UGP5
www.csr.com