Installation of Digi Wireless Vehicle Device for use with VisTracks, Inc.

Download a PDF version of this.

POWER WVA: attach the Digi WVA to the vehicle diagnostic port.

Step 1 – Reset the Digi WVA device

NOTE: This step is only to be followed if the device has never been setup, or the device is being changed from Push Button pairing to PIN pairing mode or vice-versa.

1. Press the WVA button on the device and hold it down for at least 10 seconds. This will reset the device to its original factory settings and is necessary for initial configuration of Wi-Fi Direct.
image21-min-min

Step 2 – Configure WiFi Direct through the following options:

2.1 Digi WVA Configuration via VisTracks Application
 
  • Install Barcode Scanner from the Play Store
  • Open VisTracks app (or Branded App)
  • Log into the app
  • On the main dashboard, tap the ‘Connect’ button which is located below the app header to display the ‘Connect to Vehicle’ dialog.
  • At this point, 2 options were present in order to establish a connection to the VBUS device: Manual Connection and Auto Connection.
    A. Manual Connection

    1. Tap on the Manual Connection button
    2. Select Digi WVA VBUS device

    3. Tap on the Next button
    4. The ‘Configure VBUS device’ dialog will be displayed.
    5. At this point, there are two ways to connect to the Digi WVA device; the first time the Digi is being configured, or connecting to an already configured device. To connect for the first time, follow the steps below starting at step 6. If the device is already configured, then start the connection on step 7.
    6. Configure Digi VBUS device screen will then display. Connect to Digi device by scanning QR code.
      a) Tap ‘Scan QR code’
      b) Barcode Scanner app will then launched
      c) Place Camera over QR Code

      d) If the scanning of QR code is successful, then Digi WVA Configuration screen will then be displayed.

      e) Enter a device name on the ‘Enter Device Name’ field. Example: “Digi_Truck
      f) Select a Pairing Mode
      • If you select Pin Pairing mode
        • Tap on the drop-down option and select ‘Pin Pairing’
        • Input a Pin on the ‘Enter Pin’ field. (Note: It requires 8 digit pin and a default value will be auto generated upon vbus configuration)
        • Input an admin password on the ‘Admin Password’ field. (Note: The admin password field will be auto populated by the Digi WVA VBUS device’s default admin password)
        • Select a Baud Rate on the ‘Baud Rate’ drop down option list
        • Then tap ‘Configure Device’ button

          ⇒ If an error was encountered during configuration process then an Error dialog will be displayed.
        • Upon successful configuration, the device will show up in the Available devices after the Discover Peers process
        • Tap the device name you recently configured
        • A dialog will then display the asking if you want to connect to the Digi WVA device.
        • Tap Yes button, then a dialog will be displayed asking to enter the required Pin alongside with ‘Accept’ and ‘Decline’ buttons
        • Enter the Pin you recently configured and tap the Accept button
        • It will then display the VBUS Progress dialog upon establishing a connection to the selected VBUS device along with a ‘Stop Connection’ and ‘Ok’ buttons.
          • Tap ‘Stop Connection’ button to stop establishing VBUS connection.
          • Tap OK button to hide the VBUS Progress dialog while establishing VBUS connection.

            ⇒ If the VBUS connection results to an error (given the following situations below), an error dialog will display.
            • VBUS Connection Error
              • Interrupted Internet Connection
              • VBUS Power Failure

                Note: The app will automatically disconnect from the device after attempting to connect for 1 minute and 30 seconds without receiving any data from the VBUS device.
        • Wait until the Device shows as ‘Connected’ status

       

      • If you select Push Button mode

        • Tap on the drop-down option and select ‘Push Button’
        • Input an admin password on the ‘Admin Password’ field. (Note: The admin password field will be auto populated by the Digi WVA VBUS device’s default admin password)
        • Select a Baud Rate on the ‘Baud Rate’ drop down option list
        • Then tap ‘Configure Device’ button
        • The device will show up in the Available devices after the Discover Peers process
        • Hold the Digi WVA button down for 3 seconds (do not hold down for more than 3 seconds or you will have to repeat the entire process).
        • After successfully pressing the Digi WVA button, the device status will then be shown as ‘Connected’

          Note: If this did not work please follow the below manual setup method to connect to the Digi WVA in Wi-Fi direct mode. Prior to following the manual setup method you will need to press the WVA button on the device and hold it down for at least 10 seconds in order to reset the device to its original factory settings.

    7. Connect to a WiFi Direct Digi device already configured
      a) For a Digi WVA device configured for PIN Pairing mode.
      • Tap ‘Skip’ button
      • The device will show up in the Available devices after the Discover Peers process
      • Tap the device name you recently configured
      • A dialog will then display the asking if you want to connect to the Digi WVA device.
      • Tap Yes button, then a dialog will be displayed asking to enter the required Pin alongside with ‘Accept’ and ‘Decline’ buttons
      • Enter the Pin you recently configured and tap the Accept button
      • Device should show as ‘Invited’
      • Wait until the Device shows as ‘Connected’ status

      b) For a Digi WVA device configured for Push Button pairing.

      • Tap ‘Select Device’ button
      • The device will show up in the Available devices after the Discover Peers process
      • The device should show as ‘Invited’ status
      • Hold the Digi WVA button down for 3 seconds (do not hold down for more than 3 seconds or you will have to repeat the entire process).
        After successfully pressing the Digi WVA button, the device status will then be shown as ‘Connected’
  • B. Auto Connection
    ■ Prerequisites to successfully perform Auto Connection

    • Create/Update a preconfigured device in the Portal’s Equipment Management Page or in the App’s Manage Vehicles/Trailers screen
    • Updating and setting the ELD Configurations of an existing Equipment
      • Tap the Edit icon of an existing equipment you want to use for connecting to Digi WVA VBUS device
      • Select Digi WVA VBUS device and connection type
      • Enter a Device Name
      • Enter the MAC Address of the Digi VBUS device
      • Enter an admin password of the Digi VBUS device on the Admin Password field (Optional)
      • Tap Save button to save the changes made
     
    1. Tap on the Connect button
    2. The ‘VBUS Progress’ dialog will then display
    3. Upon establishing a connection to the VBUS device, You should hear a tone letting you know that device is now connected.
2.2 Digi WVA Configuration via Web Browser
 
a.

Connect to WVA hot spot

  1. Go to the wireless connections on your computer. The WVA will announce itself as a hot spot wireless network using the naming convention of wva-mac-address.
    image33-min
  2. Connect to WVA on Wi-Fi using PASS from QR Label as shown below:
    image34-min
b.

WVA Configuration

  1. Open your web browser and type in the following URL in order to connect to the device configuration homepage: 192.168.100.1
    image35-min
  2. The following message may be displayed. If so, click on Advanced
    image11-min
  3. Click on Proceed to 192.168.100.1 (unsafe)
    image12-min
  4. Authenticate using admin for both username and password
    image13-min
  5. User is at the device configuration homepage.
    image14-min
c.

Confirm Adapter Status

  1. Click the Adapter Status tab
  2. Verify there are values being displayed for the CAN Bus Statistics, example below
    image15-min
  3. If the values remain as 0, click on the Refresh Once button and wait a few seconds to see if the values change
  4. If the values still do not change proceed to the section below for ‘Change CAN Bus Configuration’. Else if you see values skip to the section titled ‘Configure the WVA for Wi-Fi Direct’.
d.

Change CAN Bus Configuration

  1. Click the CAN Bus tab to configure the device Bus settings
  2. Change the Baud Rate for CAN Bus 1 and CAN Bus 2 from ‘Auto Baud’ to ‘25000’
    image16-min
  3. Click Apply and wait a few seconds
  4. Confirm the Adapter status by following the steps described in the above section
  5. Verify values are being displayed for the CAN Bus Statistics
  6. If the value do not change repeat the above steps and select another baud rate
e.

Configure WVA for Wi-Fi Direct

  1. Click Network Services tab to get to Network Service Configuration screen.
  2. Enable Web Server (HTTP)
  3. Enable Web Services Events on TCP Port 5000
  4. Click Apply
  5. Wait for 2 minutes then refresh the page and confirm the above settings were applied
    image17-min
  6. Click Wireless Network tab
  7. Click Wi-Fi Direct button
    image18-min
  8. Enter in a Device Name. The name must contain the contiguous text “Digi_WVA”. You can also add the vehicle number associated with the device as in the example below where “Digi_WVA_Truck_01” was entered. A VIN # as part of the name may be a great choice as well.
  9. Select Push Button for the WPS Method and click the Finish button.
    image19-min
  10. User will be asked to reboot. User must reboot in order to complete the install.
    image20-min
f.

Initial Pairing of Device

  1. On the Android tablet tap on the Settings icon
    image01-min
  2. Tap on Wi-Fi
    image02-min
  3. On the Wi-Fi screen tap on the additional options icon at the top right and select Wi-Fi Direct
    image03-min
  4. Tap on the WVA Wi-Fi Direct network and immediately afterwards press the button on the WVA device for 3 seconds. Do not press the button any longer than ten seconds as this will reset the device and user will have to start over.
    image04-min
  5. Once the initial pairing is complete the device is ready for use with the VisTracks android application.
g.

Launching VisTracks HOS App and connecting it to a WiFi Direct device already configured

  1. Open VisTracks App
  2. Log into the app
  3. On the main dashboard, tap the ‘Connect’ button which is located below the app header
  4. Tap on ‘Manual Connection’ button
  5. Select VBUS device – “Digi WVA”

  6. Tap on the ‘Next’ button
  7. The ‘Configure VBUS device’ dialog will then display
  8. You have the option to scan the QR code that came with your device or connect to it yourself via Wifi-Direct. In this example, we will be connecting via Wi-Fi Direct device already configured. Tap “Select Device” Button.
    (Note: If you haven’t configured a WiFi Direct device, you can also select the Scan QR Code option. Refer to 2.1 Step #6 for the instructions.)
  9. Tap on the WiFi direct device name: “Digi_Truck 
    (Note: If the WiFi Direct device is paired through ‘Push Button’ mode then you will see the device as ‘Invited’ screen. Hold WVA button down for 3 seconds (do not hold down for more than 3 seconds or you will have to repeat the entire process). If the WiFi Direct device is paired through ‘Pin’ mode, then it will ask you for a PIN)
  10. You should hear a tone letting you know that device is now connected.
  11. To check if you are successfully connected to the Digi_WVA_Truck_01 Wi-Fi Direct network, navigate to the Main Dashboard and the VBUS status indicator should be displayed as “Connected” image09-min which is located on the app header

  12. You can also check on the Android Notification Bar and you should see the VBUS Service status as “Connected”

Troubleshooting Steps

  1. Exit out of the VisTracks application
  2. Go to Settings on the Android device and verify that the device is connected to the WVA Wi-Fi Direct network
  3. If the network status states ‘Available’ tap on the network to initiate a connection
  4. If the WVA Wi-Fi Direct network is not displayed tap on the Search button at the top of the Wi-Fi Direct screen to search for the network
  5. Once the connection has been confirmed repeat the previous section for “VisTracks Mobile App Settings