Difference between revisions of "Bluetooth"

From MOD Wiki
Jump to navigation Jump to search
(Marked this version for translation)
m
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
+
In this page you find instructions to connect your computer to the MOD Duo using Bluetooth.<br/>
  
<translate>
+
Please note that the MOD Duo unit does not include a Bluetooth chip inside, you have to plug a Bluetooth USB dongle on MOD Duo for this to work.<br/>
<!--T:2-->
 
In this page you find instructions to connect your computer to MOD.
 
  
== Mac OS == <!--T:3-->
+
'''Note:''' Bluetooth version 3 or higher is required.
  
<!--T:4-->
+
== Bluetooth options ==
1. Turn on the MOD with the bluetooth adaptor connected
 
  
<!--T:5-->
+
The controller has a menu option dedicated to Bluetooth. To access this menu please click and hold the left knob and scroll down to the "Settings" menu
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.
 
  
<!--T:6-->
+
[[File:settings-general.jpg]]
[[File:Mac1.jpeg|400px]]
 
  
<!--T:7-->
+
On the right display, scroll down to the "Bluetooth" option rotating the right knob. Quick press the right knob to access the Bluetooth options:
3. Click the "Pair" button
 
  
<!--T:8-->
+
[[File:setting-bluetooth.jpg]]
4. In case a PIN is requested, use 1234. Depending on the Bluetooth version, the PIN won't be necessary.
 
  
<!--T:9-->
+
'''Enable discovery''' will turn on discovery mode on for 2 minutes.<br/>
5. Wait for the pairing process to finish. When it's done, the device will appear as "Not connected", according to the picture below.
+
The MOD starts with discovery turned off by default.
  
<!--T:10-->
+
'''Status:...''' shows the current Bluetooth status<br/>
[[File:Mac3.jpeg|400px]]
+
The following different status are available:<br/>
 +
- Unavailable - no Bluetooth dongle is plugged in the MOD Duo<br/>
 +
- Unsupported - the Bluetooth version of the dongle in use is too old (needs >= Bluetooth 3)<br/>
 +
- Starting... - Bluetooth service is starting<br/>
 +
- Disconnected - Bluetooth active, no devices connected and not discoverable<br/>
 +
- Discoverable - Bluetooth active, discoverable (and perhaps with devices connected)<br/>
 +
- Connected - Bluetooth active, at least 1 device connected but not discoverable<br/>
  
<!--T:11-->
+
'''Name:...''' shows the Bluetooth device name for your specific MOD Duo.<br/>
5. Click with the right button on the device and then on "Connect to Network", according to the picture below.  
+
Usually, includes batch and serial number as suffix for uniqueness.<br/>
 +
You can customize this name by creating a file named '/data/bluetooth/name' inside the MOD Duo. Its contents define the name.
  
<!--T:12-->
+
'''Address:...''' shows the MAC address of the current Bluetooth dongle in the MOD Duo.<br/>
[[File:Mac2.jpeg|400px]]
 
  
<!--T:13-->
+
== Connecting using Bluetooth ==
6. That's it. Open Google Chrome and go to http://192.168.50.1
 
  
== Windows 7 == <!--T:14-->
+
The process to connect to MOD Duo via Bluetooth is pretty simple.<br/>
 +
We basically just need to enable discovery for 1st-time setups and pair it with the computer.<br/>
 +
Then connect to its network and open http://192.168.50.1/. (note the '50' instead of '51' used for USB cable connection)
  
<!--T:15-->
+
Just in case you still have doubts, the text below explains how to do the connection in a little more detail.
1. Turn on the MOD with the bluetooth adaptor connected
 
  
<!--T:16-->
+
In all cases, '''plug you Bluetooth dongle before turning the MOD on'''.
2. From the Control Panel, go to "Devices and Printers". In this window, click in "Add device" button, located at the top left window corner.
 
  
<!--T:17-->
+
=== Windows ===
[[File:Windows1.PNG|400px]]
 
  
<!--T:18-->
+
1. Turn on the MOD Duo and plug a Bluetooth USB dongle into it
3.  Wait for your MOD to appear as one of the available devices, according to the picture below.
+
<br/>
  
<!--T:19-->
+
2. Right-click the Windows Bluetooth icon and click on "Join a Personal Area Network"
[[File:Windows2.PNG|400px]]
+
<br/>
 +
[[File:bluetooth-win-1.png]]
 +
<br/><br/>
  
<!--T:20-->
+
3. Open the MOD Duo controller menu (by holding the left knob down), go to the Bluetooth menu and enable discovery.
4. Select the MOD device and click in "Next"
+
<br/><br/>
  
<!--T:21-->
+
4. Click on the 'Add device' button on the new window that appeared on the computer.
5. In case a PIN is requested, use 1234. Depending on the Bluetooth version, the PIN won't be necessary.
+
<br/>
 +
[[File:bluetooth-win-2.png|600px]]
 +
<br/><br/>
  
<!--T:22-->
+
5. Select your MOD Duo from the list and click 'Next'.
6. Wait for the pairing process to finish and then close the window.
+
<br/>
 +
[[File:bluetooth-win-3.png|600px]]
 +
<br/><br/>
  
<!--T:23-->
+
6. Wait for Windows to finish setting it up...
[[File:Windows3.PNG|400px]]
+
<br/>
 +
[[File:bluetooth-win-4.png|600px]]
 +
<br/><br/>
  
<!--T:24-->
+
7. Select the MOD Duo icon and click 'Connect using' then 'Access point'
6. Back to the "Devices and printers" screen, right click on MOD and select "Connect using" > "Access point", according to the picture below.
+
<br/>
 +
[[File:bluetooth-win-5.png|600px]]
 +
<br/><br/>
  
<!--T:25-->
+
8. The connection should be successful. If not, start again from step 3.
[[File:Windows4.png|400px]]
+
<br/>
 +
[[File:bluetooth-win-6.png|600px]]
 +
<br/><br/>
  
<!--T:26-->
+
9. That's it. Open your browser and go to http://192.168.50.1/
7. That's it. Open Google Chrome and go to http://192.168.50.1
 
  
== Linux == <!--T:27-->
+
=== Mac OS ===
  
=== Pair devices === <!--T:28-->
+
1. Turn on the MOD Duo and plug a Bluetooth USB dongle into it
 +
<br/>
  
<!--T:29-->
+
2. Open System Preferences, go to Bluetooth and click on 'Set Up New Device...'
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:
+
<br/>
  
<!--T:30-->
+
3. Select the MOD Duo and click 'Continue'
* There's a default applet in Ubuntu for that
+
<br/>
* You can use bluez-simple-agent
+
[[File:bluetooth-mac-1.png|600px]]
 +
<br/><br/>
  
<!--T:31-->
+
4. Wait for MacOS to finish setting it up...
Any method will do, this step is not problematic.
+
<br/>
 +
[[File:bluetooth-mac-2.png|600px]]
 +
<br/><br/>
  
=== Creating the network === <!--T:32-->
+
5. After the setup finishes, connect to the MOD DUO Bluetooth network
 +
<br/>
 +
[[File:bluetooth-mac-3.png|600px]]
 +
<br/><br/>
  
<!--T:33-->
+
6. The connection should be successful. If not, remove the device from the list and start again from step 2.
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.
+
<br/>
 +
[[File:bluetooth-mac-4.png|600px]]
 +
<br/><br/>
  
<!--T:34-->
+
7. That's it. Open your browser and go to http://192.168.50.1/
To configure the network, use '''pand'''.
 
  
<!--T:35-->
+
=== Linux ===
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:
 
  
<!--T:36-->
+
There are quite a few different Bluetooth manager applications under Linux, so we won't cover them all here.<br/>
* sudo apt-get install bluez-compat
+
So instead we can tell the basic steps:
  
<!--T:37-->
+
1. Turn on the MOD Duo and plug a Bluetooth USB dongle into it<br/>
Then, create the network ('''note that''' below there's a bluetooth address, substitute it for the address discovered at "Pair devices" section above):
+
2. Wait for it to boot<br/>
 
+
3. Open the MOD Duo controller menu (by holding the left knob down), go to the Bluetooth menu and enable discovery<br/>
<!--T:38-->
+
4. Use your Bluetooth manager application to look for Bluetooth devices<br/>
* sudo pand --connect 00:15:83:3D:0A:57 -n
+
5. Select the MOD Duo and connect to it<br/>
 
+
6. Join the Bluetooth network created by the MOD Duo<br/>
<!--T:39-->
+
7. That's it. Open your browser and go to http://192.168.50.1/<br/>
'''In case there's an error 71''', try again the command above. Sometimes it's necessary to retry it several times.
 
 
 
<!--T:40-->
 
The network is done, now you need to get an IP. Use the DHCP client of your choice, at interface '''bnep0''', for example:
 
 
 
<!--T:41-->
 
* sudo dhclient bnep0
 
 
 
<!--T:42-->
 
That's it, you can open your browser and go to '''http://192.168.50.1'''
 
</translate>
 

Revision as of 12:40, 11 November 2019

In this page you find instructions to connect your computer to the MOD Duo using Bluetooth.

Please note that the MOD Duo unit does not include a Bluetooth chip inside, you have to plug a Bluetooth USB dongle on MOD Duo for this to work.

Note: Bluetooth version 3 or higher is required.

Bluetooth options

The controller has a menu option dedicated to Bluetooth. To access this menu please click and hold the left knob and scroll down to the "Settings" menu

Settings-general.jpg

On the right display, scroll down to the "Bluetooth" option rotating the right knob. Quick press the right knob to access the Bluetooth options:

Setting-bluetooth.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 dongle is plugged in the MOD Duo
- Unsupported - the Bluetooth version of the dongle 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 Duo.
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 Duo. Its contents define the name.

Address:... shows the MAC address of the current Bluetooth dongle in the MOD Duo.

Connecting using Bluetooth

The process to connect to MOD Duo via Bluetooth is pretty simple.
We basically just need to enable discovery for 1st-time setups and pair it with the computer.
Then connect to its network and open http://192.168.50.1/. (note the '50' instead of '51' used for USB cable connection)

Just in case you still have doubts, the text below explains how to do the connection in a little more detail.

In all cases, plug you Bluetooth dongle before turning the MOD on.

Windows

1. Turn on the MOD Duo and plug a Bluetooth USB dongle 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 Duo 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 Duo and plug a Bluetooth USB dongle into it

2. Open System Preferences, go to Bluetooth and click on 'Set Up New Device...'

3. Select the MOD Duo and click 'Continue'
Bluetooth-mac-1.png

4. Wait for MacOS to finish setting it up...
Bluetooth-mac-2.png

5. After the setup finishes, connect to the MOD DUO Bluetooth network
Bluetooth-mac-3.png

6. The connection should be successful. If not, remove the device from the list and start again from step 2.
Bluetooth-mac-4.png

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

Linux

There are quite a few different Bluetooth manager applications under Linux, so we won't cover them all here.
So instead we can tell the basic steps:

1. Turn on the MOD Duo and plug a Bluetooth USB dongle into it
2. Wait for it to boot
3. Open the MOD Duo controller menu (by holding the left knob down), go to the Bluetooth menu and enable discovery
4. Use your Bluetooth manager application to look for Bluetooth devices
5. Select the MOD Duo and connect to it
6. Join the Bluetooth network created by the MOD Duo
7. That's it. Open your browser and go to http://192.168.50.1/