Background ========== - Priority scale: High, Medium and Low - Complexity scale: C1, C2, C4 and C8. The complexity scale is exponential, with complexity 1 being the lowest complexity. Complexity is a function of both task 'complexity' and task 'scope'. The general rule of thumb is that a complexity 1 task should take 1-2 weeks for a person very familiar with BlueZ codebase. Higher complexity tasks require more time and have higher uncertainty. Higher complexity tasks should be refined into several lower complexity tasks once the task is better understood. General ======= - UUID handling: Use the new functions created for UUID handling in all parts of BlueZ code. Currently, the new bt_uuid_* functions are being used by GATT-related code only. Priority: high Complexity: C4 - Update PBAP client/server implementation to 1.2 and create necessary APIs for new features it introduces. Priority: Medium Complexity: C4 - Create GOEP unit tests based on its test specification: https://www.bluetooth.org/docman/handlers/DownloadDoc.ashx?doc_id=230559 Priority: Medium Complexity: C2 - Function in src/adapter.c to convert old storage files to new ini-file format should be removed 6-8 months after first BlueZ 5 release. Priority: Low Complexity: C1 - Remove usage of symlinks for drivers, such as profiles/input/suspend.c and profiles/sap/sap.c. Instead, select drivers at runtime by using config options or probing for running D-Bus services (using e.g. g_dbus_add_service_watch()). Idea first mentioned on http://thread.gmane.org/gmane.linux.bluez.kernel/30175/focus=30190. - Reuse connection handling code of src/profile.c also for built-in profiles so plugins would only need to register their btd_profile and the core takes care of the rest including listen to the right channel and manages the sdp record. Once btd_profile manages the connection it can also notify about their state, this probably remove the need of having callbacks to .connect/.disconnect since their state can be tracked, it also enables any plugin to track any profile state change which can be useful for e.g. a connection policy plugin in case one is needed. Priority: Low Complexity: C2 - Add queueing support for src/agent.c, currently if there is any request pending the code fail with error EBUSY which is very inconvenient. Priority: Low Complexity: C2 Low Energy ========== - Connection modes. Adapter interface needs to be changed to manage connection modes and adapter type. See Volume 3, Part C, section 9.3. 1. Mode management: Peripheral / Central Priority: Medium Complexity: C2 - Advertising data. The D-Bus interface needs to be updated to enable setting scan response data, and to read the advertising and scan response data which has been broadcast from other LE devices. Priority: Medium Complexity: C2 - Static random address setup and storage. Once this address is written in a given remote, the address can not be changed anymore. Priority: Low Complexity: C1 - Device Name Characteristic is a GAP characteristic for Low Energy. This characteristic shall be integrated/used in the discovery procedure. The idea is to report the value of this characteristic using DeviceFound signals. Discussion with the community is needed before to start this task. Other GAP characteristics for LE needs to follow a similar approach. It is not clear if all GAP characteristics can be exposed using properties instead of a primary service characteristics. See Volume 3, Part C, section 12.1 for more information. Priority: Low Complexity: C2 ATT/GATT (new shared stack) =========================== - Add complete GATT test coverage in unit/test-gatt following the GATT test spec. This could use shared/gatt-client and shared/gatt-server at the same time to test both against eachother. We should definitely have tests for gatt-server and gatt-client simultaneously on one side of the connection. Priority: High Complexity: C4 - Write an example using client D-Bus API using C. Priority: High Complexity: C2 - Write an example using client D-Bus API using python. Priority: High Complexity: C2 - Define packed structs for ATT protocol PDUs in shared/att-types to improve readability. We should probably do this once there are extensive unit tests for gatt-client/gatt-server so that we don't accidentally break working code. Priority: Medium Complexity: C2 - Use struct iovec to pass around byte buffers that will be sent over the wire, instead of passing uint8_t and size_t parameters everywhere. Priority: Medium Complexity: C1 - Persist client attribute cache across reboots. Priority: Medium Complexity: C4 - Move all daemon plugins and profiles that are GATT based to use shared/gatt-client instead of attrib/*. This is a complicated task that potentially needs a new plugin/profile probing interface and a lot of rewriting that can cause regressions in existing functionality. Priority: Medium Complexity: C4 - Introduce a way for shared/gatt-server to check security permissions on the current connection through bt_att. Priority: Medium Complexity: C2 - Implement other low-priority ATT protocol operations for shared/gatt-server: Read Multiple Request Priority: Low Complexity: C1 - Implement the server portion of doc/gatt-api.txt using shared/gatt-server once it exists. Priority: Medium Complexity: C4 - Send out indications from the "Service Changed" characteristic upon reconnection if a bonded device is not connected when the local database is modified. Priority: High Complexity: C2 - Unify the GATT server and client D-Bus implementations into a single module. While these don't share a lot of code, keeping them all in src/gatt-dbus seems to make more sense from an organizational perspective. Priority: Low Complexity: C1 - Isolate all GATT code inside the daemon into its own module and perform interaction with other modules (e.g. src/device.c) via callbacks. This includes client/server management, tracking incoming/outgoing connections for ATT, and callbacks to perform profile probing. Priority: Low Complexity: C4 - Support included services in the GATT D-Bus client API. Priority: Medium Complexity: C1 - The recently added support for ATT signed writes requires the following kernel modules to be enabled: CONFIG_CRYPTO_USER_API CONFIG_CRYPTO_USER_API_HASH CONFIG_CRYPTO_USER_API_SKCIPHER Currently, if these are not enabled, bt_att_new silently returns NULL. We should handle this more gracefully by not supporting signed writes if we can't initialize bt_crypto while succeeding bt_att initialization regardless. This behavior should be documented in the README. Priority: High Complexity: C1 ATT/GATT (old/outdated) ======================= - At the moment authentication and authorization is not supported at the same time, read/write requirements in the attribute server needs to be extended. According to Bluetooth Specification a server shall check authentication and authorization requirements before any other check is performed. Priority: Medium Complexity: C1 - Implement ATT PDU validation. Malformed PDUs can cause division by zero when decoding PDUs. A proper error PDU should be returned for this case. See decoding function in att.c file. Priority: Medium Complexity: C1 - Refactor read_by_group() and read_by_type() in src/attrib-server.c (they've grown simply too big). First step could be to move out the long for-loops to new functions called e.g. get_groups() and get_types(). Priority: Low Complexity: C1 - Agent for characteristics: Agent interface should be extended to support authorization per characteristic if the remote is not in the trusted list. Priority: Low Complexity: C1 - gatttool should have the ability to wait for req responses before quitting (some servers require a small sleep even with cmd's). Maybe a --delay-exit or --timeout command line switch. Priority: Low Complexity: C1 - Client needs to export a property in the Device Characteristic hierarchy to manage characteristic value changes reports in the remote device. Currently, Client Characteristic Configuration attribute is not exposed as an object. The user needs to use gatttool to change the value of the this attribute to receive notification/indications. Export this attribute as a property is a proposal that needs further discussion. Priority: Low Complexity: C1 - Attribute server should process queued GATT/ATT commands if the client disconnects. The client can simply send a command and quit, without wait for a response(ex: Write Command). For this scenario that the client disconnects the link quickly the queued received command is ignored. Priority: Low Complecity: C1 - Implement Server characteristic Configuration support in the attribute server to manage characteristic value broadcasting. There is a single instance of the Server Characteristic Configuration for all clients. See Volume 3, Part G, section 3.3.3.4 for more information. Priority: Low Complexity: C1 - Long write is not implemented. Attribute server, client and command line tool shall be changed to support this feature. Priority: Low Complexity: C2 Management Interface ====================