Getting Started with TympanRemote App
The TympanRemote App allows you to control your Tympan from your mobile device!
-
Before the Tympan can connect with the App, it must be first connected to your Android or iOS device.
-
Go to the Bluetooth Settings on your device and make sure BT is turned on.
-
Then, still within your phone's Bluetooth Settings page, you need to connect to the Tympan. If you have never connected to your Tympan, you may need to hit a button in your phone's Bluetooth page called "Scan" or "Pair New Device".
-
The Tympan should show up under available devices as an 8 digit serial. All serials will most likely begin with "BC" for a Tympan RevE ("RNBT" for Tympan RevD). The Tympan might show up as two entries (both as a bluetooth headset and as a bluetooth device). You can choose to pair with either entry for the Tympan.
- After pairing, your device may give you the option to rename this pairing. This is your choice, however when connecting to the App, the device will still show up as the serial number.
- After this instance of pairing the Tympan to your phone, your phone should remember the Tympan so that you should not have to manually pair to your phone again.
- Before you can use the TympanRemote App, you first need to download the app from the Android Play Store or the Apple App Store.
- After the app is installed, launch the app. The first time that you launch the App it'll ask you for permission to access different properties of the phone, like its location. Sorry. This is all because of the Bluetooth (we do not want your location) so you need to say "yes".
-
Prior to connecting to your Tympan, your Tympan needs to be loaded with a sketch that creates a BLE connection in order to show up in the TympanRemote App. We will be using the BasicGain_wApp example from the Tympan library. Compile the BasicGain_wApp sketch on to your Tympan. For more information on how to load a sketch, please visit our Getting Started docs.
-
In the TympanRemote App, you will see the following under the Settings tab:
- Scan for Devices button - allows the app to look for available BLE connections
- Show serial monitor toggle - allows the user to toggle on and off the serial monitor as a page in the GUI
- Show logs in footer toggle - allows the user to toggle on and off the logs that appear on the bottom part of the screen
- Select Scan for Devices and select your Tympan's serial number once "Scanning BLE..." disappears.
- If the Tympan app shows no devices after completing its scan, it's time for trouble shooting:
- On your phone, is your Bluetooth on?
- Have you paired your Tympan to your phone before?
- If both of the above are true, turn off your phone's bluetooth, turn it back on, restart the Tympan app, rescan.
- After finding your Tympan in the Devices list and tapping on it to connect, the App will display "Connecting...". Once it has makes initla contact with your Tympan, the App will display "Receiving...", which indicates that the App is receiving information from the Tympan to create the pages and buttons (the GUI) that'll be displayed in the App. Wait until after "Receiving..." disappears to begin using the App.
- Once it has finished Receiving, the App will indicate that the Tympan is connected. Now you can switch over to the GUI!
- Switch to the GUI by selecting the up/down-arrow icon on the bottom of the page.
- Once you switch to the GUI, you should see the following very basic page:
- The current gain applied on your Tympan is shown in the white box. You can control the gain on your Tympan by selecting the increase or decrease buttons. Try it out!