Bluetooth

From MOD Wiki
Revision as of 14:56, 20 September 2016 by FalkTX (talk | contribs)
Jump to navigation Jump to search

In this page you find instructions to connect your computer to the MOD using bluetooth.
Please note that the MOD unit does not include a bluetooth chip inside, you have to plug a bluetooth usb dongle on MOD for this to work.
Note: Bluetooth version 3 or higher is required.

Display options

The controller has a menu option dedicated to bluetooth.

Hmi-bluetooth-1.jpg

Enable discovery will turn on discovery mode on for 2 minutes.
The MOD starts with discovery turned off by default.

Status:... shows the current bluetooth status.
The following different status are available:
- Unavailable - no bluetooth stick is plugged in the MOD
- Unsupported - the bluetooth version of the stick in use is too old (needs >= bluetooth 3)
- Starting... - bluetooth service is starting
- Disconnected - bluetooth active, no devices connected and not discoverable
- Discoverable - bluetooth active, discoverable (and perhaps with devices connected)
- Connected - bluetooth active, at least 1 device connected but not discoverable

Name:... shows the bluetooth device name for your specific MOD.
Usually includes batch and serial number as suffix for uniqueness.
You can customize this name by creating a file named '/data/bluetooth/name' inside the MOD. Its contents define the name.

Address:... shows the MAC address of the current bluetooth stick in the MOD.

Connecting using bluetooth

(TODO: initial text here, for discovery)

Windows

1. Turn on the MOD Duo and plug a Bluetooth USB stick into it

2. Right-click the Windows bluetooth icon and click on "Join a Personal Area Network"
Bluetooth-win-1.png

3. Open the MOD controller menu (by holding the left knob down), go to the bluetooth menu and enable discovery.

4. Click on the 'Add device' button on the new window that appeared on the computer.
Bluetooth-win-2.png

5. Select your MOD Duo from the list and click 'Next'.
Bluetooth-win-3.png

6. Wait for Windows to finish setting it up...
Bluetooth-win-4.png

7. Select the MOD Duo icon and click 'Connect using' then 'Access point'
Bluetooth-win-5.png

8. The connection should be successful. If not, start again from step 3.
Bluetooth-win-6.png

9. That's it. Open your browser and go to http://192.168.50.1/

Mac OS

1. Turn on the MOD with the bluetooth adaptor connected

2. In your Mac, go to "Bluetooth" option at the System Preferences and wait for your MOD to appear as one of the available devices, according to the picture below.

Mac1.jpeg

3. Click the "Pair" button

4. In case a PIN is requested, use 0000. Depending on the Bluetooth version, the PIN won't be necessary.

5. Wait for the pairing process to finish. When it's done, the device will appear as "Not connected", according to the picture below.

Mac3.jpeg

5. Click with the right button on the device and then on "Connect to Network", according to the picture below.

Mac2.jpeg

6. That's it. Open Google Chrome and go to http://192.168.50.1

Linux

Pair devices

First, it's necessary to pair your computer with the MOD and discover the bluetooth address (something like 00:15:83:3D:0A:57). There are several ways to do that, for example:

  • There's a default applet in Ubuntu for that
  • You can use bluez-simple-agent

Any method will do, this step is not problematic.

Creating the network

This is the complex part. Although the MOD runs Linux, the network implementation at client side (your computer) does not work very well. After everything is configured you'll be able to use it without problems, but it's usual to see some error messages during the process and it might be necessary to retry the connection several times until you succeed.

To configure the network, use pand.

It's necessary to have the bluez-compat package (in Linux Mint and probably in oither debian-based distributions). The important thing is to have the "pand" command at command line. If you use a Debian-based distribution, you can use the following command:

  • sudo apt-get install bluez-compat

Then, create the network (note that below there's a bluetooth address, substitute it for the address discovered at "Pair devices" section above):

  • sudo pand --connect 00:15:83:3D:0A:57 -n

In case there's an error 71, try again the command above. Sometimes it's necessary to retry it several times.

The network is done, now you need to get an IP. Use the DHCP client of your choice, at interface bnep0, for example:

  • sudo dhclient bnep0

That's it, you can open your browser and go to http://192.168.50.1