How to Setup a Wi-Fi bridge using an Android Phone (DOC-5030) - PREVIEW FEATURE

This document will take you through the steps to setup a Wi-Fi bridge with an Android phone. The Wi-Fi bridge can be used to extend the range of your MoCap Pro SuperSplay gloves streaming capability.

With your gloves connected to the app on your phone via Bluetooth, raw data is live streamed from the app using UDP via Wi-Fi to Hand Engine on your PC.

The application is designed to run on an Android Phone that the performer is carrying on their person. 

Requirements

  • StretchSense Hand Engine 1.3.0 or higher: Login to your account page on www.stretchsense.com or email support@stretchsense.com for details

    Please Note: On the PC running Hand engine make sure firewall rules have allowed Hand Engine to listen to the port that the phone app is streaming to.

  • Wi-Fi Router. StretchSense recommends the ASUS AC1900 Wi-Fi Gaming Router (RT-AC68U)

  • D-Link USB 3.0 to Gigabit Ethernet Adapter (optional)

  • Android Phone with Bluetooth 5.0 and Android 9.0 or above

  • Download and Install the StretchSense WiFi Link app to an Android phone. Download link here: StretchSense WiFi Bridge – Apps on Google Play


    Please Note: You will need to Enable Installation from Unknown Sources in the settings of your phone, and we highly recommend Disabling Battery Optimization for this application

  • Operating System: Windows 10

Setting up the ASUS AC1900 Wi-Fi Gaming Router (RT-AC68U) for Android Wi-Fi Link App

Preferred Wi-Fi Setup Configuration

The preferred setup is for the Hand Engine PC to remain connected to your existing LAN and the dedicated Wi-Fi router connected to the Hand Engine PC via a USB 3.0 to Ethernet adapter. This enables the Hand Engine PC to maintain connections to both networks (see image below). This may require modifying the priority of these two network connections in Windows Control Panel to give priority to the existing LAN. This will avoid general network requests being routed via the dedicated router which has no connection to any other network resources. A guide for prioritising the connection to your existing LAN can be found here:

Changing network adapter priorities on Windows 10

e2a3537d-6187-483b-9256-73e7b13d7d7e

Alternate Wi-Fi Setup Configuration

If you do not have a second ethernet port on your PC, or you do not have a USB to ethernet adaptor, an alternative configuration is available. Remove the ethernet connection to your existing LAN from the Hand Engine PC and connect that to the dedicated Wi-Fi router, then connect the Hand Engine PC to a second port on the dedicated Wi-Fi router. Note you may need to configure your LAN to allow the dedicated router to connect.

b44c0e1d-7714-498b-b507-daeb515da080

Steps for Setting up the router

  1. Plug in the power cable of the router and turn it on - switch on the back

  2. Plug in the yellow LAN cable into of the 4 yellow LAN accesses at the back of the router

  3. Plug in the other end of the yellow LAN cable via the D-Link adapter (LAN to USB) or directly via the LAN access into your computer

    • The driver for the D-Link adapter should install automatically on your computer. If it doesn’t (check device manager), there’s currently no documented way to install the driver manually. So, if this is the case, simply use the LAN cable directly.

  4. If not changed, the network adapter priority order is set automatically and the router gets the highest priority, which means that there’s no access to the local network or the internet as soon as the router is plugged in, as described in step 3.

  5. When the router is plugged in, a browser window should open leading to the router configuration page.

    • If the login has changed and you don’t know the login data, you can simply reset the router and set the login yourself via the setup wizard, which will open in the browser automatically.

    • The configuration page has useful tabs showing which devices are connected with the router or tools like the traffic analyzer, to see if data is sent via the router (debugging tool).

  6. Use the router login from above (if not reset) to enter the ASUS_5G Wi-Fi network with your Android phone (should show as a device on the router configuration page)

  7. Given you know the IP address of the network adapter (type the command ipconfig in Command Prompt) you can set the IP address and port in the Android Wi-Fi Link App, connect a glove and send data to HE.

How to Setup the Wi-Fi bridge App

  1. Install the StretchSense WiFi Link app to your android phone.

    Download link here: StretchSense WiFi Bridge – Apps on Google Play


    Please note: You will need to Enable Installation from Unknown Sources in the settings of your phone, and we recommend Disabling Battery Optimisation for this application

    ffe29128-0c6f-4a4b-8c1a-839ae69a1685

     

    043d09ef-7a11-48c1-b8a1-29424e78fafd

     

     
  2. Connect the Android device to the Wi-Fi router network.

  3. Turn the gloves on at the circuit and the circuit will be blinking slow blue.

  4. Open the StretchSense WiFi Link application on your phone

    0c513b9f-6436-4a8c-9910-922d7dfe648e

     

  5. Select Start Pairing (allow location access if prompted)

    9a448c14-d851-4921-aced-d30bee39b7bc



  6. Please enter the IP address and Port number of the computer where Hand Engine is running in the format shown in the image below (highlighted by blue box eg 192.168.1.1:41235)


    02560d9f-21a7-49fe-9f08-3ddb981d1747



  7. While you have your glove turned on and blue led slowly blinking press select Start Scan. A 10s countdown timer starts and your gloves should appear. Tick the checkboxes for the available gloves and select Connect

    Important: Please make sure your Bluetooth USB dongles are NOT plugged in when attempting to pair to the WiFi app.

    Note: We are using two gloves for this demonstration (see image below)


    2d5e2e23-3347-4e28-8d6e-cb50e1570ad1

  8. Once connected the bar graph for the glove will populate with the raw data coming from the glove and you will be able to see live data from the sensors. Above the bar graph are the IP address and port number that the glove is streaming data on.

    For example in the image below the IP address is  192.168.1.1 and the port number is 41235.


    7a1b3a0c-6681-4f9e-a8c8-2729fcfb54d9


    Please note: If you have a second glove you should see a second bar graph if you scroll down on
    the app (see image below) indicating that glove 2 is also streaming. It will automatically take the next port number for streaming that is if glove 1 was streaming on 41235 then glove 2 will do so on 41236

    c3f12332-3cd9-4bbf-ba5c-df0131a1d95a

     

  9. Open Hand Engine and click on the WiFi phone icon, you will notice you currently have no sensor data on the bar graph (see image below).

    Please Note: On the PC running Hand engine make sure firewall rules have allowed Hand Engine to listen to the port that the phone app is streaming to.

     

    0407eb20-08be-4625-90b3-7e92a31a898e

     

  10. Enter the port number (for example 9000 and 9001 for the second glove), leave the IP address as the local IP address 127.0.0.1, and toggle the stream on. The current version of the app uses a UDP connection

    b6d15e77-a6ce-4bb0-9875-8fcd773ef677

  11. You should immediately see the bar graph for that glove in Hand Engine update with the raw data coming from the glove. You will also see the green indicator come on to indicate the glove is connected and the sample rate will be indicated in s/sec.


    fa4b7e8d-ef35-415a-8f8e-ed5da1ec51a4

    bd85af2f-4be8-460a-9d37-ba8d2614356a

     

     
  12. The performer can now carry the phone on their body to extend the possible wireless range of the gloves.

  13. Use Hand Engine as normal from this point onwards by setting up your Performer and Profile as well as your calibration. See Using Hand Engine.

Known potential issues:

  • If you have a complex network arrangement between your stage Wi-Fi access point and the PC running Hand Engine (for example a number of switches and a firewall between the WiFi AP and the PC), you may see a reduced sample rate of your gloves (i.e. less than 120s/sec).

  • On the PC running Hand engine make sure firewall rules have allowed Hand Engine to listen to port that phone app is streaming to.

  • You will need to Enable Installation from Unknown Sources in the settings of your phone, and we recommend Disabling Battery Optimization for this application

Disclaimer, Intellectual Property, and Licensing

Disclaimer, Intellectual Property, and Licensing - StretchSense Knowledge Base

Revision Summary

 

Revision

Date

Notes

3

2021.11.18

Updated wording and added links to download

2

2021.11.04

Updated images for HE 1.5

1

2021.05.27

Initial version