Difference between revisions of "Bluetooth"

From MOD Wiki
Jump to navigation Jump to search
(46 intermediate revisions by 4 users not shown)
Line 1: Line 1:
In this page you find instructions to connect your computer to the MOD using bluetooth.<br/>
+
In this page you find instructions to connect your computer to a MOD device using Bluetooth.<br/>
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.<br/>
 
Note: Bluetooth version 3 or higher is required.
 
  
== Display options ==
+
Please note that the MOD devices do not include a Bluetooth chip inside, you have to plug a Bluetooth USB dongle on them in order to make this procedure work.<br/>
  
The controller has a menu option dedicated to bluetooth.
+
'''Note:''' Your Bluetooth dongle should be with version 3 or higher.
  
[[File:hmi-bluetooth-1.jpg|400px]]
+
Sometimes your host device may ask you for a pin. In that case please use the pin: 0000
 +
 
 +
== Bluetooth options ==
 +
 
 +
Your MOD device has a menu option dedicated to Bluetooth. To access this menu please click and hold the left knob and scroll down to the "System" menu
 +
 
 +
{|
 +
|-
 +
|[[File:DUOX-System.png|400px]] || [[File:DUO-Settings_System.png|400px]]
 +
|}
 +
 
 +
On the right display, scroll down to the "Bluetooth" option rotating the right knob. Quick press the right knob to access the Bluetooth options:
 +
 
 +
{|
 +
|-
 +
|[[File:DUOX-System.png|400px]] || [[File:DUOX-System-Bluetooth.png|400px]]
 +
|}
  
 
'''Enable discovery''' will turn on discovery mode on for 2 minutes.<br/>
 
'''Enable discovery''' will turn on discovery mode on for 2 minutes.<br/>
 
The MOD starts with discovery turned off by default.
 
The MOD starts with discovery turned off by default.
  
'''Status: ...''' shows the current bluetooth status.<br/>
+
'''Status:...''' shows the current Bluetooth status<br/>
 
The following different status are available:<br/>
 
The following different status are available:<br/>
- Unavailable<br/>
+
- Unavailable - no Bluetooth dongle is plugged in the MOD device<br/>
- Unsupported<br/>
+
- Unsupported - the Bluetooth version of the dongle in use is too old (needs >= Bluetooth 3 or newer version)<br/>
- Starting...<br/>
+
- Starting... - Bluetooth service is starting<br/>
- Disconnected<br/>
+
- Disconnected - Bluetooth active, no devices connected and not discoverable<br/>
- Discoverable<br/>
+
- Discoverable - Bluetooth active, discoverable (and perhaps with devices connected)<br/>
- Connected<br/>
+
- Connected - Bluetooth active, at least 1 device connected but not discoverable<br/>
  
'''Name: ...''' shows the bluetooth device name for your specific MOD.<br/>
+
'''Name:...''' shows the Bluetooth device name for your specific MOD device.<br/>
Usually includes batch and serial number as suffix for uniqueness.<br/>
+
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. Its contents define the name.
+
You can customize this name by creating a file named '/data/bluetooth/name' inside your MOD device. Its contents define the name. Or on the settings of the [[MOD_Web_GUI_User_Guide|Web GUI]].
  
'''Address: ...''' shows the MAC address of the current bluetooth stick in the MOD.<br/>
+
[[File:DuoX_Settings.png|850px]]
  
== Connecting using bluetooth ==
+
'''Address:...''' shows the MAC address of the current Bluetooth dongle in your MOD device.<br/>
  
(TODO: initial text here, for discovery)
+
== Connecting using Bluetooth ==
  
=== Windows 7 === <!--T:14-->
+
The process to connect to a MOD device 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)
  
1. Turn on the MOD with the bluetooth adaptor connected
+
Just in case you still have doubts, the text below explains how to do the connection in a little more detail.
  
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.
+
In all cases, '''plug you Bluetooth dongle before turning the MOD device on'''.
  
[[File:Windows1.PNG|400px]]
+
=== Windows ===
  
3. Wait for your MOD to appear as one of the available devices, according to the picture below.
+
1. Turn on the MOD device and plug a Bluetooth USB dongle into it
 +
<br/>
  
[[File:Windows2.PNG|400px]]
+
2. Right-click the Windows Bluetooth icon and click on "Join a Personal Area Network"
 +
<br/>
 +
[[File:bluetooth-win-1.png]]
 +
<br/><br/>
  
4. Select the MOD device and click in "Next"
+
3. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]].
 +
<br/><br/>
  
5. In case a PIN is requested, use 1234. Depending on the Bluetooth version, the PIN won't be necessary.
+
4. Click on the 'Add device' button on the new window that appeared on the computer.
 +
<br/>
 +
[[File:bluetooth-win-2.png|600px]]
 +
<br/><br/>
  
6. Wait for the pairing process to finish and then close the window.
+
5. Select your MOD device from the list and click 'Next'.
 +
<br/>
 +
[[File:bluetooth-win-3.png|600px]]
 +
<br/><br/>
 +
Note: your Windows device may request you a pin. If that happens type: 0000
  
[[File:Windows3.PNG|400px]]
+
6. Wait for Windows to finish setting it up...
 +
<br/>
 +
[[File:bluetooth-win-4.png|600px]]
 +
<br/><br/>
  
6. Back to the "Devices and printers" screen, right click on MOD and select "Connect using" > "Access point", according to the picture below.
+
7. Select your MOD device icon and click 'Connect using' then 'Access point'
 +
<br/>
 +
[[File:bluetooth-win-5.png|600px]]
 +
<br/><br/>
  
[[File:Windows4.png|400px]]
+
8. The connection should be successful. If not, start again from step 3.
 +
<br/>
 +
[[File:bluetooth-win-6.png|600px]]
 +
<br/><br/>
  
7. That's it. Open Google Chrome and go to http://192.168.50.1
+
9. That's it. Open your browser and go to http://192.168.50.1/
 +
 
 +
Note: Every time you want to use the Bluetooth functionality you must enable Bluetooth discovery on your MOD device and repeat step 7
  
 
=== Mac OS ===
 
=== Mac OS ===
  
1. Turn on the MOD with the bluetooth adaptor connected
+
1. Turn on your MOD device and plug a Bluetooth USB dongle into it
 +
<br/>
  
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.
+
2. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]].
 +
<br/><br/>
  
[[File:Mac1.jpeg|400px]]
+
3. Open System Preferences, go to Bluetooth and wait for your list to update. After a while you must see your MOD device appearing and available to connect
 +
<br/>
 +
[[File:MacOSX_BTConnectDevice.png|600px]]
  
3. Click the "Pair" button
+
4. Click "Connect" for your MOD device and the list will be updated showing your device connected
 +
<br/>
 +
[[File:MacOSX_BTConnected.png|600px]]
 +
<br/><br/>
  
4. In case a PIN is requested, use 0000. Depending on the Bluetooth version, the PIN won't be necessary.
+
5. That's it, your MOD device is connected. Open your browser and go to http://192.168.50.1/
  
5. Wait for the pairing process to finish. When it's done, the device will appear as "Not connected", according to the picture below.
+
=== Linux ===
  
[[File:Mac3.jpeg|400px]]
+
There are quite a few different Bluetooth manager applications under Linux, so we won't cover them all here.<br/>
 +
So instead we can tell the basic steps:
  
5. Click with the right button on the device and then on "Connect to Network", according to the picture below.  
+
1. Turn on the MOD device and plug a Bluetooth USB dongle into it<br/>
 +
2. Wait for it to boot<br/>
 +
3. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]].<br/>
 +
4. Use your Bluetooth manager application to look for Bluetooth devices<br/>
 +
5. Select your MOD device and connect to it<br/>
 +
6. Join the Bluetooth network created by your MOD device<br/>
 +
7. That's it. Open your browser and go to http://192.168.50.1/<br/>
  
[[File:Mac2.jpeg|400px]]
+
== Connecting to mobile devices ==
  
6. That's it. Open Google Chrome and go to http://192.168.50.1
+
As to access to the [[MOD_Web_GUI_User_Guide|Web GUI]] of your MOD devices you don't need to install any software, one of the coolest ways to tweak your pedalboards is by using a mobile device like your smartphone or tablet. This gets even easier if you use the Bluetooth connection.
  
=== Linux ===
+
Here we will let you know how to connect your MOD device via bluetooth with iOS and Android systems.
 +
 
 +
=== iOS ===
 +
 
 +
1. Turn on the MOD device and plug a Bluetooth USB dongle into it <br/>
 +
 
 +
2. Make sure that you have the Bluetooth active on your iOS device and that you enabled the discovery on the settings of your MOD device (check how to do it [[Bluetooth#Bluetooth_options|here]]) <br/>
 +
 
 +
[[File:iPhoneBluetoothON.PNG|300px]]
 +
 
 +
3. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]].<br/>
 +
 
 +
 
 +
4. Go to Settings -> Bluetooth on your iOS device and wait until the MOD device appears on the list of "Other Devices" <br/>
 +
 
 +
[[File:iOS_Bluetooth_MOD.PNG|300px]]
 +
 
 +
 
 +
4. Click on it and wait to connect. <br/>
 +
 
 +
Note: your iOS device may request you a pin. If that happens type: 0000
 +
 
 +
[[File:iOS_Bluetooth_ConnectedMOD.PNG|300px]]
 +
 
 +
 
 +
6.You are now connected. Open your the browser on your mobile device and go to http://192.168.50.1/<br/>
 +
 
 +
[[File:iPhoneMOD_GUI.PNG|800px]]
 +
 
 +
Note: this screenshot was taken on an iPhone SE. iPad resolutions may allow you to see better your pedalboard
 +
 
 +
=== Android ===
  
==== Pair devices ====
+
1. Turn on the MOD device and plug a Bluetooth USB dongle into it <br/>
  
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:
+
2. Enable the discover on the Bluetooth settings of your MOD device. On your Android device switch OFF the WLAN (WiFi) and switch ON the Bluetooth. Your MOD device must now appear on the list <br/>
  
* There's a default applet in Ubuntu for that
+
[[File:Android_MODavailable.png|600px]]
* You can use bluez-simple-agent
 
  
Any method will do, this step is not problematic.
+
3. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]].<br/>
  
==== 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.
+
4. Click on the MOD device name in order to pair it with your Android. <br/>
  
To configure the network, use '''pand'''.
+
Note: If your Android device requests you a pin during this operation type: 0000
  
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:
+
[[File:Android_MODconnected.png|600px]]
  
* 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):
+
5. As soon as your MOD device is paired, click on its settings and activate the "Internet access" through it <br/>
  
* sudo pand --connect 00:15:83:3D:0A:57 -n
+
Note: this will stop your access to your normal internet on this device.
  
'''In case there's an error 71''', try again the command above. Sometimes it's necessary to retry it several times.
+
[[File:Android_BtInternetAccess.png|600px]]
  
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
+
6.You are now able to edit your pedalboard from your Android device. Open your the browser on your mobile device and go to http://192.168.50.1/<br/>
  
That's it, you can open your browser and go to '''http://192.168.50.1'''
+
[[File:Android_MOD_pedalboard.png|600px]]

Revision as of 09:04, 28 October 2020

In this page you find instructions to connect your computer to a MOD device using Bluetooth.

Please note that the MOD devices do not include a Bluetooth chip inside, you have to plug a Bluetooth USB dongle on them in order to make this procedure work.

Note: Your Bluetooth dongle should be with version 3 or higher.

Sometimes your host device may ask you for a pin. In that case please use the pin: 0000

Bluetooth options

Your MOD device has a menu option dedicated to Bluetooth. To access this menu please click and hold the left knob and scroll down to the "System" menu

DUOX-System.png DUO-Settings System.png

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

DUOX-System.png DUOX-System-Bluetooth.png

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 device
- Unsupported - the Bluetooth version of the dongle in use is too old (needs >= Bluetooth 3 or newer version)
- 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 device.
Usually, includes batch and serial number as suffix for uniqueness.
You can customize this name by creating a file named '/data/bluetooth/name' inside your MOD device. Its contents define the name. Or on the settings of the Web GUI.

DuoX Settings.png

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

Connecting using Bluetooth

The process to connect to a MOD device 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 device on.

Windows

1. Turn on the MOD device 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 settings menu of your MOD device as described above.

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

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

Note: your Windows device may request you a pin. If that happens type: 0000

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

7. Select your MOD device 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/

Note: Every time you want to use the Bluetooth functionality you must enable Bluetooth discovery on your MOD device and repeat step 7

Mac OS

1. Turn on your MOD device and plug a Bluetooth USB dongle into it

2. Open the settings menu of your MOD device as described above.

3. Open System Preferences, go to Bluetooth and wait for your list to update. After a while you must see your MOD device appearing and available to connect
MacOSX BTConnectDevice.png

4. Click "Connect" for your MOD device and the list will be updated showing your device connected
MacOSX BTConnected.png

5. That's it, your MOD device is connected. 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 device and plug a Bluetooth USB dongle into it
2. Wait for it to boot
3. Open the settings menu of your MOD device as described above.
4. Use your Bluetooth manager application to look for Bluetooth devices
5. Select your MOD device and connect to it
6. Join the Bluetooth network created by your MOD device
7. That's it. Open your browser and go to http://192.168.50.1/

Connecting to mobile devices

As to access to the Web GUI of your MOD devices you don't need to install any software, one of the coolest ways to tweak your pedalboards is by using a mobile device like your smartphone or tablet. This gets even easier if you use the Bluetooth connection.

Here we will let you know how to connect your MOD device via bluetooth with iOS and Android systems.

iOS

1. Turn on the MOD device and plug a Bluetooth USB dongle into it

2. Make sure that you have the Bluetooth active on your iOS device and that you enabled the discovery on the settings of your MOD device (check how to do it here)

IPhoneBluetoothON.PNG

3. Open the settings menu of your MOD device as described above.


4. Go to Settings -> Bluetooth on your iOS device and wait until the MOD device appears on the list of "Other Devices"

IOS Bluetooth MOD.PNG


4. Click on it and wait to connect.

Note: your iOS device may request you a pin. If that happens type: 0000

IOS Bluetooth ConnectedMOD.PNG


6.You are now connected. Open your the browser on your mobile device and go to http://192.168.50.1/

IPhoneMOD GUI.PNG

Note: this screenshot was taken on an iPhone SE. iPad resolutions may allow you to see better your pedalboard

Android

1. Turn on the MOD device and plug a Bluetooth USB dongle into it

2. Enable the discover on the Bluetooth settings of your MOD device. On your Android device switch OFF the WLAN (WiFi) and switch ON the Bluetooth. Your MOD device must now appear on the list

Android MODavailable.png

3. Open the settings menu of your MOD device as described above.


4. Click on the MOD device name in order to pair it with your Android.

Note: If your Android device requests you a pin during this operation type: 0000

Android MODconnected.png


5. As soon as your MOD device is paired, click on its settings and activate the "Internet access" through it

Note: this will stop your access to your normal internet on this device.

Android BtInternetAccess.png


6.You are now able to edit your pedalboard from your Android device. Open your the browser on your mobile device and go to http://192.168.50.1/

Android MOD pedalboard.png