Digi WVA Getting Started Manual
  1. Manuals
  2. Brands
  3. Digi Manuals
  4. Adapter
  5. WVA
  6. Getting started manual

Digi WVA Getting Started Manual

Wireless vehicle bus adapter
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Wireless Vehicle Bus Adapter (WVA)
Getting Started Guide

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the WVA and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Digi WVA

Summary of Contents for Digi WVA

  • Page 1 Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...
  • Page 2 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.
  • Page 3 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.

  • Page 4: Table Of Contents

    WVA LEDs Power LED User-defined LED Connect to the WVA Connect to the WVA from a smart phone or tablet Connect to the WVA from a laptop Access and use the WVA web interface Apply and save changes Cancel changes to configuration settings...
  • Page 5 Get started Learn the demo application software features Build your own application Download the demo application Start the demo application and discover WVA devices Discover the WVA Connect to the WVA Optional: Manually connect to the WVA Review the demo application dashboard...
  • Page 6 WVA does not connect to an access point Wi-Fi access issues Cannot discover device using Wi-Fi Direct Cannot associate with WVA over Wi-Fi Direct in push-button mode Cannot associate with WVA over Wi-Fi Direct in PIN mode Wireless signal strength issues...

  • Page 7: Wireless Vehicle Bus Adapter Getting Started Guide

    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.

  • Page 8: 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: Connect the hardware Evaluate deployment decisions Connect to the WVA Configure the WVA Run the WVA demo application In addition, the Troubleshooting section provides troubleshooting tips. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...
  • Page 9 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 Recommended CAN bus simulator model Connect the WVA to a CAN simulator...

  • Page 10: Connect The Hardware

    Digi part number 76000931 Recommended CAN bus simulator model for ordering information. Communications equipment You will need a mobile device to interact with the WVA, such as a laptop, tablet or smart phone. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 11: Recommended Can Bus Simulator Model

    2. Locate the alignment pin on the WVA and the wiring harness. 3. Following the pin alignment indicated by the alignment pin, connect the WVA to the 9-pin connector of the wiring harness. Locate the locking ring on the base of the WVA and twist it clockwise to lock in place.

  • Page 12: Connect The Wva To A Vehicle's Diagnostic Port

    Connect the WVA to a vehicle's diagnostic port Follow this process to connect a WVA to a vehicle's diagnostic port. Note You can skip this process if you are connecting a WVA device to a CAN simulator. See Connect the WVA to a CAN simulator.

  • Page 13: Remove The Wva From The Diagnostic Port

    Connect the hardware Remove the WVA from the diagnostic port 3. Connect the WVA to the diagnostic port. Twist the WVA locking ring clockwise to lock. Remove the WVA from the diagnostic port You can remove the WVA from the diagnostic port in a vehicle.

  • Page 14: Wva Leds

    Solid green: The device is powered. Note The WVA must be powered on and able to connect with a wireless network to work as expected. You can confirm that the WVA can connect to a wireless network in the Network Connectivity Status section in the Device Information page in the web interface.

  • Page 15: Connect To The Wva

    Connect to the WVA After you have connected the WVA to a CAN simulator or plugged it into a vehicle's diagnostic port, you can connect to the WVA from a smart phone, tablet, or laptop. This enables you to configure the WVA settings, view device status, perform firmware updates, and view a log of system events.

  • Page 16: Connect To The Wva From A Smart Phone Or Tablet

    Connect to the WVA from a smart phone or tablet Connecting to the WVA from a smart phone or tablet requires a QR code reader. If you do not already have a QR code reader available on your phone or tablet, download one for your mobile device or tablet. Digi recommends the QR code reader by Scan, Inc.
  • Page 17 For example: wva-00:40:4d:41:88:81 3. Select the access point name and click Connect to connect to the WVA as a wireless access point. If you do not see the WVA in the connections list, or cannot connect to it, see...

  • Page 18: Access And Use The Wva Web Interface

    Access and use the WVA web interface The WVA has a web interface for configuring device settings, viewing device status, performing firmware updates, and viewing a log of system events. See the topics below for more detailed information: Apply and save changes...

  • Page 19: Apply And Save Changes

    Connect to the WVA. 1. Go to a browser and access the web interface using the default IP address for the WVA access point: 192.168.100.1 2. The first time you attempt to access the WVA, a certificate management prompt appears. Click Proceed Anyway.

  • Page 20: Upload A File To The Wva

    In the File Management page, you can manage custom applications, their associated data files, and other files. You can also push firmware upload files to the device filesystem, pull log files from the device filesystem, and load files onto the WVA. The File Management page also displays current information about loaded files.

  • Page 21: Configure The Wva

    Configure the WVA You can configure settings for the WVA in the web interface. You must first connect to the WVA. See Connect to the WVA Open the web interface to get started. Once you have accessed the web interface, you can configure the WVA settings. The following topics describe how to configure your WVA’s wireless settings and perform other set up and management...

  • Page 22: Configure Wireless Settings

    WVA to operate. The web interface has a wizard for configuring the WVA as a client device. By default, when the WVA connects to another access point as a client, which it can do in parallel with devices connecting to it as an access point, it gets its IP address via DHCP.
  • Page 23 5. Select the security mode and enter the associated parameters for the security mode. If you do not know these values, contact your network administrator. The default security mode for the WVA is WPA-PSK. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 24: Configure Wva For Wi-Fi Direct

    Configure the WVA Configure wireless settings 6. When the wizard completes, the WVA connects as a client to the wireless network you selected in step 4. The WVA gets its IP address via DHCP. Configure WVA for Wi-Fi Direct To configure the WVA for access by Wi-Fi Direct: Open the web interface.
  • Page 25 Because most phone/tablet devices remember the connection, the connection needs to be established only once. However, users must locate the WVA in the vehicle to press the button, which can be difficult to do in some vehicles. Enter PIN: Configures the Wi-Fi Direct connection to be established by a user entering a PIN on the connecting device (phone or tablet).

  • Page 26: Configure Can Bus Baud Rate (Can Bus Simulator Use Only)

    Configure CAN bus baud rate (CAN bus simulator use only) If you are using the WVA connected to a CAN simulator, you need to configure the CAN bus baud rate. CAUTION! When connected to a CAN bus with multiple active devices, such as in a vehicle, the WVA can automatically select the CAN bus baud rate.
  • Page 27 Change the Baud Rate setting from its default, Auto Baud, to 250000. CAUTION! If any single device is set to the wrong rate, the entire CAN bus can be affected negatively. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 28: Configure Python Programs

    5. Click Apply. Configure Python programs You can configure the WVA to automatically run a specified set of Python programs each time the WVA starts up and when the Python applications exit. You access the Python Configuration page in the WVA web interface.

  • Page 29: Start Or Stop An Already Configured Python Application

    Configure the WVA Configure Python programs 5. Configure the application to automatically run when the WVA device starts up by clicking the corresponding checkbox in the Enable column. Note When you check this option, the Python application also runs when the configuration changes are saved.

  • Page 30: Configure Network Services

    You can configure network services in the Network Service Configuration page in the WVA web interface. Settings on this page enable or disable common network services on the WVA, and configure the network port on which the service is listening. You can disable network services to improve device security, so the device runs only specifically needed network services.

  • Page 31: Configure Power Management Settings

    You can configure power management settings in the Power Management Configuration page in the WVA web interface. With these settings, you can control whether the WVA powers down once it has been determined that the vehicle is not running, and choose from a variety of mechanisms for waking the WVA again.
  • Page 32 When Power Management is enabled, all the Power Management settings appear: 4. View and change the power management settings as needed. See Power Management Configuration page descriptions for information about the settings and defined defaults. 5. Click Apply to save the changes. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 33: About Power Management

    By default, the connectivity of the WVA device to Remote Manager for remote device management is disabled. Digi Remote Manager® connectivity is typically only available when the WVA is in Infrastructure mode, operating as a Wi-Fi client, and the device acting as the access point for the WVA forwards traffic to the Internet. Note To serve our customers most effectively, Digi International Inc.
  • Page 34 6. When Remote Manager connectivity is enabled, several network connection states are added to the Network Connectivity Status list on the Device Information page. For descriptions of each option, see Device Information page descriptions. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 35: Manage The Wva Device

    Manage the WVA device The topics in this section explain how to manage the WVA devices. Rediscover the WVA Reboot the WVA Reset the WVA to factory defaults Disable and enable the factory reset button WVA filesystem and file management View the system log...

  • Page 36: Rediscover The Wva

    Rediscover the WVA Rediscover the WVA To determine the IP address of a WVA connected to a network in Infrastructure mode, you can use the Digi Device Discovery Utility to rediscover the device. 1. Download the Digi Device Discovery Utility.

  • Page 37: Reboot The Wva

    A factory reset clears all custom configuration settings since the device was last reset. After the reboot, you must reenter and reapply any configuration settings unique to your device. To reset the WVA to factory defaults, press and hold the button on the top of the WVA for 10 seconds. Note You can disable the factory reset by button press, if needed.

  • Page 38: Access/Browse The Filesystem From Device Interfaces

    View the system log The System Message Log File Browser in the WVA web interface is a diagnostic tool that allows you to view entries in a system log file. The default log file that you can view from this browser is eventlog.txt.

  • Page 39: Log Files And Contents

    When both files reach their maximum size, the older file is overwritten. Many of the log files are stored in persistent memory (flash) and contain data from multiple boots. Log file Contents eventlog.txt High-level system messages. eventlog.txt.0 Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...
  • Page 40 For internal use only. cherokee.log.0 The options in the Message Filters for Displayed Log File section allow Digi Technical Support working with customers on troubleshooting issues to more quickly focus on areas of interest in the log file as needed.
  • Page 41 Manage the WVA device View the system log Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 42: View Status Information

    Manage the WVA device View status information View status information Several pages in the WVA web interface indicate device status information. Network Connectivity Status section in the Device Information (Home) page. For detailed information, see Device Information page descriptions. Adapter Status page. This page includes information about the wireless network and vehicle status.

  • Page 43: Deployment Decisions

    As long as the WVA is installed in the vehicle, you can assume the WVA clock is accurate. Once the WVA is disconnected from the vehicle and not powered by any other source, some drift in the time can occur.
  • Page 44 Deployment decisions Default behavior regarding IP address assignment IP address of the Wi-Fi client interface: By default, when the WVA connects out to another access point in Infrastructure mode, it gets its IP address via DHCP. The WVA can do this in parallel with devices connecting to it as an access point.

  • Page 45: Wva Web Interface Page Descriptions

    WVA web interface page descriptions You can find information about the options in the WVA web interface pages in this section. Adapter Status page descriptions CAN Bus page descriptions Device Information page descriptions File Management page descriptions Network Service Configuration page descriptions...

  • Page 46: Adapter Status Page Descriptions

    10/70 indicates a poor one. Current Vehicle Status section This section includes status items about the vehicle or simulated vehicle to which the WVA is connected. These values are set when the page appears and are not dynamically updated.

  • Page 47: Device Information Page Descriptions

    250000: Select this option if you are using a CAN bus device. Device Information page descriptions The following table describes each of the sections in the Device Information (Home) page. For more information about this page, see Open the web interface. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...
  • Page 48 Device Information page. Current System Status Summarizes current system parameters and network connectivity status. Network Connectivity Status Indicates the readiness of the WVA to communicate in a wireless network using a colored indicator. Options are: Orange: Not ready Green: Ready Refresh button Click Refresh to refresh the information on the page.

  • Page 49: File Management Page Descriptions

    Upload to Current Directory Uploads files to the current directory. Use the Browse button to find a file on your computer to be uploaded to the WVA. Click Update file to begin the file upload process. For more information, see Upload a file to the WVA.

  • Page 50: Network Service Configuration Page Descriptions

    1025 and 65535 that is not already assigned to another service. The example below shows the TCP port being set to 5000, which is the TCP port number set in the WVA demo application. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 51: Power Management Configuration Page Descriptions

    Network port Service setting Services provided number Digi's Advanced Device Discovery Protocol allows devices to be found Advanced Device on a network, regardless of protocol. You can also use ADDP to change Discovery network settings, or disable the service completely.

  • Page 52: Python Configuration Page Descriptions

    Description Enable Click the check box in the Enable column for the Python application that should run when the WVA device starts up. When you check this option, the Python application also runs when the configuration changes are saved. Command Line The Python application name and any arguments.

  • Page 53: Run The Wva Demo Application

    Review the demo application dashboard Learn the demo application software features After you have connected the demo application to a WVA, you can learn how to use the software features: View a live graph view of vehicle speed and engine RPMs. See Show graph view.

  • Page 54: Start The Demo Application And Discover Wva Devices

    After you have installed the demo application, you can run it. 1. Before you run the demo application, verify that the device is connected to the WVA. For data to be displayed in the WVA demo application, the WVA must be connected to a CAN simulator or...

  • Page 55: Discover The Wva

    The WVA demo application waits 15 seconds before attempting to reconnect. 1. In the discovered devices list, connect to the WVA by clicking the device name in the device pane. This opens the dashboard.

  • Page 56: Optional: Manually Connect To The Wva

    Optional: Manually connect to the WVA You can manually connect to the WVA, if you prefer this method over using the discovery method. 1. On the action bar, click the action overflow button: 2. Select Settings. The Applications settings dialog appears.

  • Page 57: Show Graph View

    Note To use the Graph View from the demo application, you must perform a Sync Time operation to synchronize the WVA system time with the Android device clock. Click the action overflow button and select Sync time. Configure endpoints: subscriptions and alarms...

  • Page 58: Subscribe To An Endpoint

    Configure an endpoint as an alarm. Delete an alarm. Subscribe to an endpoint The following example uses an endpoint named BatteryPotential. 1. In the dashboard's Alarms and Subscriptions panel, select the endpoint. The Endpoint dialog appears: Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...
  • Page 59 Select Subscription enabled. b. In the Interval value, specify the desired number of seconds between updates for the endpoint. 3. When the endpoint is configured, it appears in the Vehicle Data panel: Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 60: Configure An Endpoint As An Alarm

    Below: When the data falls below a certain value. A threshold value must also be entered. Change: Any change in value. Selecting Change disables the Threshold field. Delta: When the data changes by a certain amount. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...
  • Page 61 Run the WVA demo application Configure endpoints: subscriptions and alarms For example, this endpoint is configured for an alarm when the value of BatteryPotential drops below 30: Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 62: Delete An Alarm

    Delete an alarm The following example uses an endpoint named BatteryPotential. 1. In the dashboard's Alarms and Subscriptions panel, select the endpoint. 2. Select the endpoint. The endpoint dialog appears. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 63: Change Application Settings

    Connection Settings: Settings for network connections. IP address for manual connection: Identifies the IP address that is the destination for a manual device connection. Once set, the manual connection can be established by Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 64: Review Fault Codes

    Review fault codes selecting Manual. TCP port for events: The TCP network port number used for the Event Channel. The WVA demo application is set to use port number 5000, but this number can be changed. Application Settings: Settings for subscriptions and the Event Log.
  • Page 65 Run the WVA demo application Review fault codes 3. Click on one of the CAN bus headings to query the WVA for the list of ECU units on that CAN bus. You can click the Refresh icon to update the list.

  • Page 66: Demo Application Issues

    Run the WVA demo application Demo application issues 6. Click Fetch inactive fault code to query the WVA for the most recently reported inactive fault codes. The inactive fault codes appear on the screen. If there are no inactive fault codes, the message "No inactive fault codes have been reported"...

  • Page 67: Demo Application Error Messages

    Must be on Wi-Fi or serving as hotspot to use this application. Possible cause The Android device is not connected to the WVA, or is not in Access Point (mobile hotspot) mode. Solution Make sure the Android device is connected to the WVA before trying to connect to the demo application.

  • Page 68: Demo Application: Connection Refused Error (Econnrefused)

    3. If you cannot open the web interface, both HTTP and HTTPS may have been disabled on the WVA. In this case, you cannot access a web browser to display and change settings. The only way to return the WVA to the default setting of HTTP being enabled is to reset the device to factory defaults. See Reset the WVA to factory...
  • Page 69 The Android device has been disconnected from the WVA. The demo application detects that condition owing to a change in the Android device's network state. For example, the Android device was connected to the WVA's Wi-Fi network, but the current state is not connected to Wi-Fi or connected to another network type.

  • Page 70: Troubleshooting

    Troubleshooting See the following topics for assistance if you run into issues with your WVA, such as connectivity problems. If you need further assistance, contact Digi Technical Support at www.digi.com/support. Power LED is dark Device is not discovered by Digi Device Discovery Cannot open web interface or access web services Cannot receive data from the CAN bus...

  • Page 71: Power Led Is Dark

    Possible cause Hardware failure. Solution 1. Disconnect the WVA from the power source. 2. Reconnect the WVA to the power source. 3. If the Power LED remains dark, return the WVA to your supplier. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 72: Device Is Not Discovered By Digi Device Discovery

    Solution If possible, remove any routers between the computer and the WVA and use a hub instead. Possible cause A switch between the computer and the WVA the Digi Device Discovery utility is configured to block the discovery traffic. Solution Occasionally switches are configured to block the discovery traffic.
  • Page 73 Possible cause Unknown. Solution If you have a second Digi device, try discovering it instead to see if you have the same problem. Though it may not solve your original discovery problem, it should provide you with some additional troubleshooting clues.

  • Page 74: Cannot Open Web Interface Or Access Web Services

    Cannot open web interface or access web services Cannot open web interface or access web services Problem Cannot open the WVA web interface or access any of the web services. Possible cause Password has been changed from the default: admin.

  • Page 75: Cannot Receive Data From The Can Bus

    Troubleshooting Cannot receive data from the CAN bus Cannot receive data from the CAN bus When the WVA is connected wither to a CAN simulator or a vehicle diagnostic port, it does not receive data from the CAN bus. Possible cause When connecting to a CAN simulator, the baud rate was set to Auto Baud or an incorrect baud rate.

  • Page 76: Wva Does Not Connect To An Access Point

    Device is already configured as an access point only. The SSID changed. Solution 1. Determine and verify the new access point to which the WVA should connect. 2. Use the Digi Device Discovery Utility to rediscover the WVA. See Rediscover the WVA.

  • Page 77: Wi-Fi Access Issues

    Solution Determine the correct WPA passkey and enter it. You can also reset the WPA passkey to the default by resetting the device to factory defaults. See Reset the WVA to factory defaults. Wireless Vehicle Bus Adapter (WVA) Getting Started Guide...

  • Page 78: Cannot Discover Device Using Wi-Fi Direct

    Troubleshooting Cannot discover device using Wi-Fi Direct Cannot discover device using Wi-Fi Direct Cannot discover the WVA using the Wi-Fi Direct method. Possible cause The WVA may not be configured for Wi-Fi Direct. The Wi-Fi Direct device name may have changed. Solution Reset the WVA to factory defaults...

  • Page 79: Cannot Associate With Wva Over Wi-Fi Direct In Push-Button Mode

    Cannot associate with WVA over Wi-Fi Direct in push-button mode Cannot associate with WVA over Wi-Fi Direct in push-button mode Cannot associate with the WVA over Wi-Fi Direct when in push-button mode. Possible cause The WVA might not be configured for Wi-Fi Direct.

  • Page 80: Cannot Associate With Wva Over Wi-Fi Direct In Pin Mode

    Cannot associate with WVA over Wi-Fi Direct in PIN mode Cannot associate with WVA over Wi-Fi Direct in PIN mode Cannot associate with the WVA over Wi-Fi Direct when in PIN mode. Possible cause The WVA is not configured for Wi-Fi Direct.

  • Page 81: Wireless Signal Strength Issues

    Solution When installing the WVA in a vehicle, it is not recommended to mount the WVA under the dash. If you must mount the WVA under the dash, make sure there are no metal enclosures near it.

Table of Contents