reformationpro / bluez-rfcomm-example

An example to register an RFCOMM server using dbus-mock

bluez-rfcomm-example

An example to register an RFCOMM server using my dbus-glue library. But this is useful for everyone trying to implement a bluez serial service. You can use the sdbus++ library, or any dbus lib. The code should be understandable enough for that.

This provides a simplified example project from which a more powerful and useful server can be build upon.

Since getting to this point in C++ was an absolute nightmare, I decided to share my efforts here.

Could contain bugs.

What have I learned.

1. The bluez documentation is a HUGE pain.

2. The sdbus documentation is a HUGE pain.

3. The name of all interfaces registered with "sd_bus_add_object_vtable" are gathered under the given sd_bus* instance. This instance can be named with "sd_bus_request_name" (which has no documentation). The naming is possible without any further work on the session (user) bus, but requires special permissions on the system bus. https://stackoverflow.com/questions/32828468/sd-bus-api-sd-bus-request-name-returns-permission-denied

4. Despite all the horribly outdated sources, creating and binding your own socket is not needed. Bluez does that for you. Scrap all that legacy code and just use the dbus methods.

5. In order to create a rfcomm server, you have to first register a new interface on the bus with a given object path and the type "org.bluez.Profile1". The "NewConnection" function is called whenever a new connection is made. You then take control of the file descriptor and handle read/writes from there.

6. To tell bluez that you just registered/exposed this new Profile1 interface, you have to call "RegisterProfile". this method takes an object_path (to the "Profile1" interface of yours that you created), A uuid and options. this uuid cannot be chosen willy nilly - it identifies the bluetooth service and is unique to this service. The client connects to a specific id. Use the SerialPortServiceClass uuid if you want to be THE serial bluetooth service of your device. The function also takes a dictionary with options, for which the documentation is somewhat sufficient for once: https://github.com/pauloborges/bluez/blob/master/doc/profile-api.txt

7. I dont know if the passed channel matters at all. In my testing with common android apps, it doesn't. I dont know how the handle their connect.

Building

Everything will be contained within "bluetoot_project".

• mkdir bluetooth_project
• cd bluetooth_project
• git clone --recurse-submodules -j2 https://github.com/5cript/bluez-rfcomm-example.git
• mkdir build
• cd build
• cmake ../bluez-rfcomm-example
• cmake --build . -j4

Troubleshooting

Unit dbus-org.bluez.service not found

Start the bluetooth service that exposes the dbus interfaces: sudo systemctl start bluetooth.

could not give myself a name: Permission denied

See point 3) above