Difference between revisions of "Bluetooth"

From MOD Wiki
Jump to navigation Jump to search
(Tutorial bluetooth no Linux)
 
(73 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Nesta página você encontra instruções para conectar seu computador ao MOD.
+
In this page you find instructions to connect your computer to a MOD device using Bluetooth.<br/>
  
== Mac OS ==
+
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/>
  
1. Ligue o MOD com o adaptador bluetooth conectado
+
'''Note:''' Your Bluetooth dongle should be with version 3 or higher.
  
2. No seu Mac, acesse a opção "Bluetooth" dentro das configurações de sistema e aguarde o seu MOD aparecer como um dos dispositivos disponíveis, conforme figura abaixo.
+
Sometimes your host device may ask you for a pin. In that case please use the pin: 0000
  
[[File:Mac1.jpeg|400px]]
+
== Bluetooth options ==
  
3. Clique no botão "Emparelhar"
+
Your MOD device has a menu option dedicated to Bluetooth. Screens might look slightly different for different devices.  For example, for MOD Duo / Duo X, please click and hold the left knob and scroll down to the "System" menu
  
4. Caso seja requisitado um PIN, use 1234. Dependendo da versão do Bluetooth, o PIN não será requisitado.
+
{|
 +
|-
 +
|[[File:DUOX-System.png|400px]] || [[File:DUO-Settings_System.png|400px]]
 +
|}
  
5. Aguarde o processo de emparelhamento. Ao final dele, o dispositivo irá aparecer como "Não conectado", conforme figura abaixo
+
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:Mac3.jpeg|400px]]
+
{|
 +
|-
 +
|[[File:DUOX-System.png|400px]] || [[File:DUOX-System-Bluetooth.png|400px]]
 +
|}
  
5. Clique com o botão direito em cima do disposito e então em "Conectar à Rede", conforme figura abaixo
+
'''Enable discovery''' will turn on discovery mode on for 2 minutes.<br/>
 +
The MOD starts with discovery turned off by default.
  
[[File:Mac2.jpeg|400px]]
+
'''Status:...''' shows the current Bluetooth status<br/>
 +
The following different status are available:<br/>
 +
- Unavailable - no Bluetooth dongle is plugged in the MOD device<br/>
 +
- Unsupported - the Bluetooth version of the dongle in use is too old (needs >= Bluetooth 3 or newer version)<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/>
  
6. Pronto, abra o Google Chrome e acesse http://192.168.50.1
+
'''Name:...''' shows the Bluetooth device name for your specific MOD device.<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 your MOD device. Its contents define the name. Or on the settings of the [[MOD_Web_GUI_User_Guide|Web GUI]].
  
== Windows 7 ==
+
[[File:DuoX_Settings.png|850px]]
  
1. Ligue o MOD com o adaptador bluetooth conectado
+
'''Address:...''' shows the MAC address of the current Bluetooth dongle in your MOD device.<br/>
  
2. A partir do Painel de Controle, acesse o item "Dispositivos e Impressoras". Nesta janela, clique no botão "Adicionar um dispositivo, localizado no topo esquerdo da janela
+
== Connecting using Bluetooth ==
  
[[File:Windows1.PNG|400px]]
+
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)
  
3.  Aguarde o seu MOD aparecer como um dos dispositivos disponíveis, conforme figura abaixo.
+
Just in case you still have doubts, the text below explains how to do the connection in a little more detail.
  
[[File:Windows2.PNG|400px]]
+
In all cases, '''plug your Bluetooth dongle before turning the MOD device on'''.
  
4. Selecione o dispositivo MOD e clique em "Avançar"
+
=== Windows ===
  
5. Caso seja requisitado um PIN, use 1234. Dependendo da versão do Bluetooth, o PIN não será requisitado.
+
1. Plug a Bluetooth USB dongle into the MOD device
 +
<br/>
  
6. Aguarde o processo de emparelhamento ser concluído com sucesso e então feche a janela clicando em Fechar
+
2. Turn on the MOD device
 +
<br/>
  
[[File:Windows3.PNG|400px]]
+
3. Right-click the Windows Bluetooth icon and click on "Join a Personal Area Network"
 +
<br/>
 +
[[File:bluetooth-win-1.png]]
 +
<br/><br/>
  
6. De volta a tela "Dispositivos e Impressoras", clique com o botão direito sobre o MOD e selecione "Conectar usando" > "Ponto de acesso", conforme figura abaixo
+
4. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]]
 +
<br/><br/>
  
[[File:Windows4.png|400px]]
+
5. Click on the 'Add device' button on the new window that appeared on the computer
 +
<br/>
 +
[[File:bluetooth-win-2.png|600px]]
 +
<br/><br/>
  
7. Pronto, abra o Google Chrome e acesse http://192.168.50.1
+
6. 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
  
== Linux ==
+
7. Wait for Windows to finish setting it up
 +
<br/>
 +
[[File:bluetooth-win-4.png|600px]]
 +
<br/><br/>
  
=== Parear devices ===
+
8. Select your MOD device icon and click 'Connect using' then 'Access point'
Primeiro, é necessário parear o seu computador com o MOD e descobrir o endereço do bluetooth (algo como 00:15:83:3D:0A:57). Há diversas maneiras de se fazer isso, por exemplo:
+
<br/>
 +
[[File:bluetooth-win-5.png|600px]]
 +
<br/><br/>
  
* Há um applet padrão no Ubuntu para isso
+
9. The connection should be successful. If not, start again from step 3
* Pode-se usar o bluez-simple-agent
+
<br/>
 +
[[File:bluetooth-win-6.png|600px]]
 +
<br/><br/>
  
Qualquer método servirá, essa fase não é problemática
+
10. That's it. Open your browser and go to http://192.168.50.1/
  
=== Subindo a rede ===
+
Note: Every time you want to use the Bluetooth functionality you must enable Bluetooth discovery on your MOD device and repeat step 7
  
Essa é a parte mais complexa. Apesar do MOD rodar Linux, a implementação da rede não funciona bem do lado do cliente (o seu computador). Depois de configurar tudo, você vai conseguir acessar sem grandes problemas, mas é normal ver algumas mensagens de erro e pode ser necessário tentar a conexão repetidas vezes até conseguir.
+
=== Mac OS ===
  
Para configurar a rede, usamos o '''pand'''.
+
1. Plug a Bluetooth USB dongle into the MOD device
 +
<br/>
  
É necessário o pacote '''bluez-compat''' (no Linux Mint e provavelmente outras distros debian-based. O importante é ter o comando "pand" na linha de comando). Se você usa alguma distribuição baseada em Debian, pode usar o comando:
+
2. Turn on the MOD device
 +
<br/>
  
* sudo apt-get install bluez-compat
+
3. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]]
 +
<br/><br/>
  
Em seguida, suba a rede ('''note que''' abaixo há um endereço de bluetooth, substitua pelo endereço descoberto na seção "Parear devices"):
+
4. 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]]
  
* sudo pand --connect 00:15:83:3D:0A:57 -n
+
5. Click "Connect" for your MOD device and the list will be updated showing your device connected
 +
<br/>
 +
[[File:MacOSX_BTConnected.png|600px]]
 +
<br/><br/>
  
'''Caso haja um erro 71''' tente novamente o comando acima. Às vezes são necessárias algumas tentativas.
+
6. That's it, your MOD device is connected. Open your browser and go to http://192.168.50.1/
  
A rede está feita, falta agora pegar um IP. Use qualquer cliente dhcp de sua preferência, na interface bnep0, por exemplo:
+
=== Linux ===
  
* sudo dhclient bnep0
+
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:
  
Pronto, pode abrir o seu navegador e acessar '''http://192.168.50.1'''
+
1. Plug a Bluetooth USB dongle into the MOD device
 +
<br/>
 +
 
 +
2. Turn on the MOD device
 +
<br/>
 +
 
 +
3. Wait for it to boot
 +
<br/>
 +
 
 +
4. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]].
 +
<br/>
 +
 
 +
5. Use your Bluetooth manager application to look for Bluetooth devices
 +
<br/>
 +
 
 +
6. Select your MOD device and connect to it
 +
<br/>
 +
 
 +
7. Join the Bluetooth network created by your MOD device
 +
<br/>
 +
 
 +
8. That's it. Open your browser and go to http://192.168.50.1/<br/>
 +
 
 +
== Connecting to mobile devices ==
 +
 
 +
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.
 +
 
 +
Here we will let you know how to connect your MOD device via Bluetooth with iOS and Android systems.
 +
 
 +
=== iOS ===
 +
 
 +
1. Plug a Bluetooth USB dongle into the MOD device
 +
<br/>
 +
 
 +
2. Turn on the MOD device
 +
<br/>
 +
 
 +
3. 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]]
 +
 
 +
4. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]]<br/>
 +
 
 +
5. 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]]
 +
 
 +
6. 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]]
 +
 
 +
7.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 ===
 +
 
 +
1. Plug a Bluetooth USB dongle into the MOD device
 +
<br/>
 +
 
 +
2. Turn on the MOD device
 +
<br/>
 +
 
 +
3. On the settings of your Android device turn off the internet connection. Normally this is done on the WLAN selector. Also turn off 4G/mobile data too, if you have that.<br/>
 +
 
 +
4. Enable the discovery 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/>
 +
 
 +
[[File:Android_MODavailable.png|600px]]
 +
 
 +
5. Open the settings menu of your MOD device as described [[Bluetooth#Bluetooth_options|above]]<br/>
 +
 
 +
6. Click on the MOD device name in order to pair it with your Android <br/>
 +
 
 +
Note: If your Android device requests you a pin during this operation type: 0000
 +
 
 +
[[File:Android_MODconnected.png|600px]]
 +
 
 +
7. As soon as your MOD device is paired, click on its settings and activate the "Internet access" through it <br/>
 +
 
 +
Note: this will stop your access to your normal internet on this device
 +
 
 +
[[File:Android_BtInternetAccess.png|600px]]
 +
 
 +
8. You are now able to edit your pedalboard from your Android device. Open the browser on your mobile device and go to http://192.168.50.1/<br/>
 +
 
 +
[[File:Android_MOD_pedalboard.png|600px]]
 +
 
 +
== Bluetooth dongles tested by community ==
 +
 
 +
 
 +
 
 +
{| class="wikitable sortable"
 +
|-
 +
! Dongle !! Dongle chipset !! Chipset VID:PID !! MOD Device !! MOD Release !! Test !! User !! Date !! Device + OS
 +
|-
 +
| Maxuni Bluetooth 5.0 - https://www.amazon.com/dp/B08CMP5LQC || || || MOD Dwarf || || style="background: lightgreen" | Passed || redcloud || 2022-01-26 || iPad 7
 +
|-
 +
| Maxuni Bluetooth 5.0 - https://www.amazon.com/dp/B08CMP5LQC || || || MOD Dwarf || || style="background: pink" | Not passed || redcloud || 2022-01-26 || Android 4, 10
 +
|-
 +
| Avantree DG40S USB Bluetooth  https://www.amazon.fr/dp/B00VWEK4IG || || || MOD Dwarf || || style="background: lightgreen" | Passed || zwabo || 2022-04-21 || Android 11 Samsung Galaxy A32
 +
|-
 +
| Kinivo BTD400 - https://www.amazon.co.uk/dp/B007Q45EF4 || BCM20702 || 0A5C:21E8 || MOD Dwarf || 1.12.1 || style="background: lightgreen" | Passed || sloedowncadet || 2023-01-11 || Windows 11
 +
|-
 +
| Kinivo BTD400 - https://www.amazon.co.uk/dp/B007Q45EF4 || BCM20702 || 0A5C:21E8 || MOD Dwarf || 1.12.1 || style="background: lightgreen" | Passed || sloedowncadet || 2023-01-11 || Android 12 Samsung Galaxy S10e
 +
|-
 +
| tplink UB4A - https://www.amazon.co.uk/dp/B07YLDVM6B || CSR CSR8510 || 0A12:0001 || MOD Dwarf || 1.12.1 || style="background: lightgreen" | Passed || sloedowncadet || 2023-01-11 || Windows 11
 +
|-
 +
| tplink UB4A - https://www.amazon.co.uk/dp/B07YLDVM6B || CSR CSR8510 || 0A12:0001 || MOD Dwarf || 1.12.1 || style="background: lightgreen" | Passed || sloedowncadet || 2023-01-11 || Android 12 Samsung Galaxy S10e
 +
|-
 +
| Olakin BT5.1 - https://www.amazon.co.uk/gp/product/B09ZY2MTXT || Realtek RTL8671b || 0BDA:A725 || MOD Dwarf || 1.12.1 || style="background: pink" | Unsupported || sloedowncadet || 2023-01-11 || -
 +
|}

Latest revision as of 00:16, 12 January 2023

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. Screens might look slightly different for different devices. For example, for MOD Duo / Duo X, 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 your Bluetooth dongle before turning the MOD device on.

Windows

1. Plug a Bluetooth USB dongle into the MOD device

2. Turn on the MOD device

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

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

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

6. 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

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

8. Select your MOD device icon and click 'Connect using' then 'Access point'
Bluetooth-win-5.png

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

10. 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. Plug a Bluetooth USB dongle into the MOD device

2. Turn on the MOD device

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

4. 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

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

6. 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. Plug a Bluetooth USB dongle into the MOD device

2. Turn on the MOD device

3. Wait for it to boot

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

5. Use your Bluetooth manager application to look for Bluetooth devices

6. Select your MOD device and connect to it

7. Join the Bluetooth network created by your MOD device

8. 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. Plug a Bluetooth USB dongle into the MOD device

2. Turn on the MOD device

3. 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

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

5. 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

6. 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

7.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. Plug a Bluetooth USB dongle into the MOD device

2. Turn on the MOD device

3. On the settings of your Android device turn off the internet connection. Normally this is done on the WLAN selector. Also turn off 4G/mobile data too, if you have that.

4. Enable the discovery 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

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

6. 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

7. 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

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

Android MOD pedalboard.png

Bluetooth dongles tested by community

Dongle Dongle chipset Chipset VID:PID MOD Device MOD Release Test User Date Device + OS
Maxuni Bluetooth 5.0 - https://www.amazon.com/dp/B08CMP5LQC MOD Dwarf Passed redcloud 2022-01-26 iPad 7
Maxuni Bluetooth 5.0 - https://www.amazon.com/dp/B08CMP5LQC MOD Dwarf Not passed redcloud 2022-01-26 Android 4, 10
Avantree DG40S USB Bluetooth https://www.amazon.fr/dp/B00VWEK4IG MOD Dwarf Passed zwabo 2022-04-21 Android 11 Samsung Galaxy A32
Kinivo BTD400 - https://www.amazon.co.uk/dp/B007Q45EF4 BCM20702 0A5C:21E8 MOD Dwarf 1.12.1 Passed sloedowncadet 2023-01-11 Windows 11
Kinivo BTD400 - https://www.amazon.co.uk/dp/B007Q45EF4 BCM20702 0A5C:21E8 MOD Dwarf 1.12.1 Passed sloedowncadet 2023-01-11 Android 12 Samsung Galaxy S10e
tplink UB4A - https://www.amazon.co.uk/dp/B07YLDVM6B CSR CSR8510 0A12:0001 MOD Dwarf 1.12.1 Passed sloedowncadet 2023-01-11 Windows 11
tplink UB4A - https://www.amazon.co.uk/dp/B07YLDVM6B CSR CSR8510 0A12:0001 MOD Dwarf 1.12.1 Passed sloedowncadet 2023-01-11 Android 12 Samsung Galaxy S10e
Olakin BT5.1 - https://www.amazon.co.uk/gp/product/B09ZY2MTXT Realtek RTL8671b 0BDA:A725 MOD Dwarf 1.12.1 Unsupported sloedowncadet 2023-01-11 -