TDE
/
tdebluez
mirror of https://mirror.git.trinitydesktop.org/gitea/TDE/tdebluez
0
0
Fork 0
Code Issues Releases Wiki Activity

Update on the README.md

Browse Source 
Signed-off-by: Emanoil Kotsev <deloptes@gmail.com>
(cherry picked from commit 5b70d04a09)
r14.1.x
Emanoil Kotsev 2 years ago committed by Michele Calgaro
parent 25926f66c6
commit 9c9a5098d8
Signed by: MicheleC
GPG Key ID: 2A75B7CA8ADED5CF
1 changed files with 161 additions and 15 deletions
Show Stats Download Patch File Download Diff File

176
README.md
Unescape Escape View File

@ -6,7 +6,9 @@ Originally it was introduced around 2008 in SUSE, but it was not included in the
Due to the major API change from Bluez4 to Bluez5 in Linux it was necessary to completely rewrite most of the applications while adding new and removing old parts of the functionality that were obsoleted. Due to the major API change from Bluez4 to Bluez5 in Linux it was necessary to completely rewrite most of the applications while adding new and removing old parts of the functionality that were obsoleted.
Lack of devices for testing and differences in hardware standards make testing even more difficult and suggest unexpected behavior and issues. Please test and report back so that we can improve the application and its components. Lack of devices for testing and differences in hardware standards make testing even more difficult and suggest unexpected behavior and issues.
Please test and report back so that we can improve the application and its components.
# Applications and libraries # Applications and libraries
@ -20,7 +22,7 @@ This is the main application that provides the main functionality.
* Allows to configure bluetooth adapters and devices. * Allows to configure bluetooth adapters and devices.
* User must be member of group netdev for /dev/rfkill access. This is required to make BT adapter switch on/off to work. * User must be member of group netdev for `/dev/rfkill` access. This is required to make BT adapter switch on/off to work.
* pulseaudio-module-bluetooth needs to be installed for a2dp to work * pulseaudio-module-bluetooth needs to be installed for a2dp to work
@ -66,19 +68,22 @@ It provides agent for authentication utilizing several DBus interfaces.
This can be seen as third party application that can be started as stand alone application or by tdebluez. This can be seen as third party application that can be started as stand alone application or by tdebluez.
It provides Obex FTP, OPP, Message Access, PSE. It provides Obex FTP, OPP, Message Access, PSE.
* FTP is working per default in ~/Download directory. * FTP is working per default in `~/Download` directory.
If you want to change this, open .trinity/share/config/tdebluezrc and add/modify entry If you want to change this, open `.trinity/share/config/tdebluezrc` and add/modify entry
downloadDir=Downloads `downloadDir=Downloads`
You can use absolute or relative path. Both absolute and relative can be used, but relative paths are assumed to be relative to user $HOME folder. Default $HOME/Downloads.
You can use absolute or relative path. Both absolute and relative can be used, but relative paths are assumed to be relative to user `$HOME` folder. Default `$HOME/Downloads`.
## openobex ## openobex
This is third party library providing functionality for SyncML like used in SyncEvolution. Please, note that only v1.5 works. v1.7 is broken. This is third party library providing functionality for SyncML like used in SyncEvolution.
Please, note that v1.7 is broken and only v1.5 works.
# Configuration # Configuration
The configuration file is `~/.trinity/share/config/tdebluezrc` The configuration file is `~/.trinity/share/config/tdebluezrc`
Here is an example Here is an example (see details below)
``` ```
[20:xx:xx:xx:xx:xx] [20:xx:xx:xx:xx:xx]
@ -108,6 +113,151 @@ obexSrvExe[$e]=/usr/libexec/bluetooth/obexd
systemtrayquitTDEBluetooth=false systemtrayquitTDEBluetooth=false
``` ```
## General
### authAgent
Start the ```tdebluezauth``` process
Default:
```authAgent=true```
### obexSrv
Start/stop the ```obexSrv``` process
Default:
```obexSrv=true```
obexSrvExe[$e]=/usr/libexec/bluetooth/obexd
### autoStart
Start/stop ```tdebluez``` automatically
Default:
```autoStart=true```
### downloadDir
When using Obex Push where to save the file transfered.
In future it is planned to provide a configurable menu item.
Default:
```downloadDir=Downloads```
## Notification Messages
Default:
```systemtrayquitTDEBluetooth=false```
## Device settings
The selected profiles are stored in the corresponding section for each device
Example:
```
[20:xx:xx:xx:xx:xx]
profile=0000110a-0000-1000-8000-00805f9b34fb,0000111f-0000-1000-8000-00805f9b34fb
```
Following IDs are recognized, but not all of them are for direct use and they are not offered in the GUI.
*Note:*
If you need an ID supported in GUI, let us know.
*Note:*
The application tries to connect all configured profiles.
Please note that some IDs conflict with each other and can not be used together. Most likely you will get some kind of error in such case.
```
"00001203-0000-1000-8000-00805f9b34fb" - "Generic Audio"
"00001108-0000-1000-8000-00805f9b34fb" - "Headset"
"00001112-0000-1000-8000-00805f9b34fb" - "Headset AG"
"0000111e-0000-1000-8000-00805f9b34fb" - "Handsfree"
"0000111f-0000-1000-8000-00805f9b34fb" - "Handsfree AG"
"0000110d-0000-1000-8000-00805f9b34fb" - "Advanced Audio"
"0000110a-0000-1000-8000-00805f9b34fb" - "A2DP Source" //Advanced Audio Distribution Profile
"0000110b-0000-1000-8000-00805f9b34fb" - "A2DP Sink"
"0000110e-0000-1000-8000-00805f9b34fb" - "A/V Remote Ctrl" //Audio/Video Remote Control Profile
"0000110c-0000-1000-8000-00805f9b34fb" - "A/V Remote Ctrl Tgt"
"00001115-0000-1000-8000-00805f9b34fb" - "PANU"
"00001116-0000-1000-8000-00805f9b34fb" - "NAP"
"00001117-0000-1000-8000-00805f9b34fb" - "GN"
"0000000f-0000-1000-8000-00805f9b34fb" - "BNEP Service" //Bluetooth Network Encapsulation Protocol
"00002a50-0000-1000-8000-00805f9b34fb" - "PNPID"
"0000180a-0000-1000-8000-00805f9b34fb" - "Device Information"
"00001801-0000-1000-8000-00805f9b34fb" - "GATT" //Generic Access Profile (Generic Attributes)
"00001802-0000-1000-8000-00805f9b34fb" - "Immediate Alert"
"00001803-0000-1000-8000-00805f9b34fb" - "Link Loss"
"00001804-0000-1000-8000-00805f9b34fb" - "TX Power"
"0000112d-0000-1000-8000-00805f9b34fb" - "SAP"
"0000180d-0000-1000-8000-00805f9b34fb" - "Heart Rate"
"00002a37-0000-1000-8000-00805f9b34fb" - "Heart Rate Measurement"
"00002a38-0000-1000-8000-00805f9b34fb" - "Body Sensor Location"
"00002a39-0000-1000-8000-00805f9b34fb" - "Heart Rate Control Point"
"00001809-0000-1000-8000-00805f9b34fb" - "Health Thermometer"
"00002a1c-0000-1000-8000-00805f9b34fb" - "Temp Measurement"
"00002a1d-0000-1000-8000-00805f9b34fb" - "Temp Type"
"00002a1e-0000-1000-8000-00805f9b34fb" - "Immediate Temp"
"00002a21-0000-1000-8000-00805f9b34fb" - "Measurement Interval"
"00001816-0000-1000-8000-00805f9b34fb" - "Cycling SC"
"00002a5b-0000-1000-8000-00805f9b34fb" - "CSC Measurement"
"00002a5c-0000-1000-8000-00805f9b34fb" - "CSC Feature"
"00002a5d-0000-1000-8000-00805f9b34fb" - "Sensor Location"
"00002a55-0000-1000-8000-00805f9b34fb" - "SC Control Point"
"00000003-0000-1000-8000-00805f9b34fb" - "RFCOMM"
"00001400-0000-1000-8000-00805f9b34fb" - "HDP"
"00001401-0000-1000-8000-00805f9b34fb" - "HDP Source"
"00001402-0000-1000-8000-00805f9b34fb" - "HDP Sink"
"00001124-0000-1000-8000-00805f9b34fb" - "HID"
"00001103-0000-1000-8000-00805f9b34fb" - "DUN Gateway" //Dial-up Networking Profile
"00001800-0000-1000-8000-00805f9b34fb" - "GAP" //Generic Access Profile
"00001200-0000-1000-8000-00805f9b34fb" - "PNP"
"00001101-0000-1000-8000-00805f9b34fb" - "SPP" //Serial Port Profile
"00001104-0000-1000-8000-00805f9b34fb" - "OBEX Sync"
"00001105-0000-1000-8000-00805f9b34fb" - "OBEX OPP"
"00001106-0000-1000-8000-00805f9b34fb" - "OBEX FTP"
"f9ec7bc4-953c-11d2-984e-525400dc9e09" - "OBEX DIR"
"0000112e-0000-1000-8000-00805f9b34fb" - "OBEX PCE"
"0000112f-0000-1000-8000-00805f9b34fb" - "OBEX PSE"
"00001130-0000-1000-8000-00805f9b34fb" - "OBEX PBAP"
"00001132-0000-1000-8000-00805f9b34fb" - "OBEX Msg Access Srv"
"00001133-0000-1000-8000-00805f9b34fb" - "OBEX Msg Notif. Srv"
"00001134-0000-1000-8000-00805f9b34fb" - "OBEX MAP"
// taken from
// https://www.vistax64.com/threads/bluetooth-peripheral-device-cannot-be-found.62944/
// https://together.jolla.com/question/64565/accessing-bluetooth-profiles/
// http://www.sensi.org/~ak/tmp/n95.txt
"00005005-0000-1000-8000-0002ee000001" - "Nokia PC Suite"
"00005601-0000-1000-8000-0002ee000001" - "Nokia SyncML Server"
"00000001-0000-1000-8000-0002ee000001" - "SyncML Server"
"00000002-0000-1000-8000-0002ee000002" - "OBEX Syncevolution"
"00000004-0000-1000-8000-0002ee000002" - "SyncML DM Client"
```
# Known issues # Known issues
Please report back your experience, so that we can improve the code. Please report back your experience, so that we can improve the code.
@ -129,14 +279,10 @@ Please report back your experience, so that we can improve the code.
* it can connect one device at a time * it can connect one device at a time
* some profiles are allowed to connect only once * some profiles are allowed to connect only once
2. flip the mouse press button on the tray icon [**done**] 2. flip the mouse press button on the tray icon [**done**]
3. fix the wizard when pairing (test with Android phone and non 3. fix the wizard when pairing (test with Android phone and non Android also with Headsets) [**done**]
Android also with Headsets) [**done**] 4. add some logic so that sub-processes are killed in case tdebluez crashes [**done**]
4. add some logic so that sub-processes are killed in case tdebluez crashes
After the 14.1 release
5. add obexFTP/OPP support 5. add obexFTP/OPP support
6. add support for multiple adapters 6. add support for multiple adapters [**done**]
7. add autoconnect option 7. add autoconnect option
8. Port the UUID logic from https://codebrowser.dev/qt5/qtconnectivity/src/bluetooth/qbluetoothuuid.h.html 8. Port the UUID logic from https://codebrowser.dev/qt5/qtconnectivity/src/bluetooth/qbluetoothuuid.h.html

Write Preview
Loading…
Cancel
Save