Digi WVA User manual

Wireless Vehicle Bus Adapter (WVA)
Getting Started Guide

Revision history—90001929
Revision Date Description
A December 2013 Original release.
B December 2013 nUpdated description of passkey.
nAdded information for disabling factory
default reset from the WVA button.
C March 2014 Corrected link for Contact Support.
D November 2014 nAdded new features: Wi-Fi Direct, Python
Programmability and File Management.
nChanged how WVA is referenced in network:
from wva-serial-number to wva-mac-
address
E September 2017 nUpdated to new format.
nEdited and updated content.
F November 2017 Added information for reviewing fault codes in the
demo application.
Trademarks and copyright
Digi, Digi International, and the Digi logo are trademarks or registered trademarks in the United
States and other countries worldwide. All other trademarks mentioned in this document are the
property of their respective owners.
© 2017 Digi International Inc. All rights reserved.
Disclaimers
Information in this document is subject to change without notice and does not represent a
commitment on the part of Digi International. Digi provides this document “as is,” without warranty of
any kind, expressed or implied, including, but not limited to, the implied warranties of fitness or
merchantability for a particular purpose. Digi may make improvements and/or changes in this manual
or in the product(s) and/or the program(s) described in this manual at any time.
Warranty
To view product warranty information, go to the following website:
Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 2

Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 3
www.digi.com/howtobuy/terms
Send comments
Documentation feedback: To provide feedback on this document, send your comments to
[e-mail].
Customer support
Digi Technical Support: Digi offers multiple technical support plans and service packages to help our
customers get the most out of their Digi product. For information on Technical Support plans and
pricing, contact us at +1 952.912.3444 or visit us at www.digi.com/support.

Contents
Wireless Vehicle Bus Adapter Getting Started Guide
Features 7
Setting up your Wireless Vehicle Bus Adapter 8
Connect the hardware
Verify product components 10
Optional equipment 10
Communications equipment 10
Recommended CANbus simulator model 11
Connect the WVAto a CANsimulator 11
Connect the WVA to a vehicle's diagnostic port 12
Remove the WVA from the diagnostic port 13
WVALEDs 14
Power LED 14
User-defined LED 14
Connect to the WVA
Connect to the WVA from a smart phone or tablet 16
Connect to the WVAfrom a laptop 16
Access and use the WVA web interface
Apply and save changes 19
Cancel changes to configuration settings 19
Open the web interface 19
Upload a file to the WVA 20
Configure the WVA
Configure wireless settings 22
Configure WVA for Wi-Fi Infrastructure mode 22
Configure WVA for Wi-Fi Direct 24
Configure CANbus baud rate (CANbus simulator use only) 26
Configure Python programs 28
Start or stop an already configured Python application 29
Determine whether Python applications are running 29
Configure network services 30
Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 4

Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 5
Configure power management settings 31
About power management 33
Enable Remote Manager connectivity (optional) 33
Manage the WVA device
Rediscover the WVA 36
Reboot the WVA 37
Reset the WVAto factory defaults 37
Disable and enable the factory reset button 37
Disable the factory reset button 37
Enable the factory reset button 37
WVA filesystem and file management 37
Access/Browse the filesystem from device interfaces 38
View the system log 38
Log files and contents 39
View status information 42
Deployment decisions
Default behavior regarding time 43
Default behavior regarding Wi-Fi network connectivity 43
Default behavior regarding Remote Manager connectivity 43
Default behavior regarding IP address assignment 43
WVA web interface page descriptions
Adapter Status page descriptions 46
CANBus page descriptions 47
Device Information page descriptions 47
File Management page descriptions 49
Network Service Configuration page descriptions 50
Power Management Configuration page descriptions 51
Python Configuration page descriptions 52
Run the WVAdemo application
Get started 53
Learn the demo application software features 53
Build your own application 53
Download the demo application 53
Start the demo application and discover WVA devices 54
Discover the WVA 55
Connect to the WVA 55
Optional: Manually connect to the WVA 56
Review the demo application dashboard 56
Show graph view 57
Configure endpoints: subscriptions and alarms 57
Subscribe to an endpoint 58
Configure an endpoint as an alarm 60
Delete an alarm 62
Change application settings 63
Review fault codes 64

Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 6
Demo application issues 66
Demo application error messages 67
Demo application: Wi-Fi hotspot issues 67
Demo application: user login fails 67
Demo application: Connection Refused error (ECONNREFUSED) 68
Demo application: Connection has gone away error 68
Troubleshooting
Power LED is dark 71
Device is not discovered by Digi Device Discovery 72
Cannot open web interface or access web services 74
Cannot receive data from the CANbus 75
WVA does not connect to an access point 76
Wi-Fi access issues 77
Cannot discover device using Wi-Fi Direct 78
Cannot associate with WVA over Wi-Fi Direct in push-button mode 79
Cannot associate with WVA over Wi-Fi Direct in PIN mode 80
Wireless signal strength issues 81

Wireless Vehicle Bus Adapter Getting Started Guide
The Wireless Vehicle Bus Adapter (WVA) is a telematics component that makes vehicle bus data
available through wireless communication. Using Wi-Fi, the WVA connects to other intelligent devices
or routers as a client, host, or through a Wi-Fi Direct connection. The WVA can accommodate vehicle
bus data in J1939/CAN or J1587/J1708 form.
You can use the WVA in a desktop development environment with a CAN bus simulator, and can install
it in a vehicle by plugging into the vehicle's diagnostic port.
The WVA provides an option for wireless connectivity within the vehicle cab as an alternative to wired
installation process. If you already have a system that includes an on-board computer (OBC) with Wi-Fi
capabilities in your vehicles, you can integrate the WVA into your existing system. If you have not yet
installed an OBC in your vehicles, you can use a smart phone, tablet, or rugged display combined with
a custom application to interact with the WVA.
Features
nEmbedded Wi-Fi with b/g/n Internet speeds
nStandard Deutsch 9-pin diagnostic port connector
nTwo J1939/CAN vehicle bus interfaces
nJ1587/J1708 vehicle bus interface
nLEDs to indicate power and user-defined functions in applications
n12 VDC power through a vehicle diagnostic port; can be powered directly from the vehicle
nBasic power management
nCustom buzzer for driver alerts
Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 7

Wireless Vehicle Bus Adapter Getting Started Guide Setting up your Wireless Vehicle Bus Adapter
Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 8
nWeb interface for configuration and management, password-protected
nWeb services, a RESTful programming interface to vehicle data, password-protected
For detailed hardware specifications, see the Hardware topic of the Wireless Vehicle Bus Adapter (WVA)
Application Developer's Guide.
Setting up your Wireless Vehicle Bus Adapter
This Getting Started Guide walks you through the steps to set up your Wireless Vehicle Bus Adapter.
These steps include:
1. Connect the hardware
2. Evaluate deployment decisions
3. Connect to the WVA
4. Configure the WVA
5. Run the WVAdemo application
In addition, the Troubleshooting section provides troubleshooting tips.

Connect the hardware
You can use the WVA for desktop development with a CAN simulator, or plug it into a vehicle's
diagnostic port.
Follow the steps in this section to connect the WVA hardware.
Verify product components 10
Recommended CANbus simulator model 11
Connect the WVAto a CANsimulator 11
Connect the WVA to a vehicle's diagnostic port 12
Remove the WVA from the diagnostic port 13
WVALEDs 14
Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 9

Connect the hardware Verify product components
Wireless Vehicle Bus Adapter (WVA) Getting Started Guide 10
Verify product components
The Wireless Vehicle Bus Adapter includes the following components. Make note of any missing or
damaged item and contact your supplier.
Wireless Vehicle Bus Adapter QR code label
Optional equipment
You can order the following equipment separately, if needed.
CAN bus simulator and optional recommended cabling for
connecting to the computer.
Note This part is not sold by Digi International Inc. See
Recommended CANbus simulator model for ordering
information.
Wiring harness
Digi part number 76000931
Communications equipment
You will need a mobile device to interact with the WVA, such as a laptop, tablet or smart phone.