Changes between Version 5 and Version 6 of HardwareInfo/Bluetooth

Timestamp:

Mar 15, 2013, 9:52:00 AM (12 years ago)

Author:

modeenf

Comment:

--

HardwareInfo/Bluetooth

@@ -34 +34 @@
 [https://www.bluetooth.org/Technical/Specifications/adopted.htm Bluetooth docs][[BR]]
 [http://svnweb.freebsd.org/base/head/sys/netgraph/ FreeBSD Bluetooth][[BR]]
+[http://www.acm.org/crossroads/xrds9-4/blue.html Document approach][[BR]]
 
 [[Image(BT.png)]]
+
+'''Overview:'''
+
+Bluetooth is wireless low-power network stack. The target is implement Bluetooth 2.0, although the major differences between 2.0 and 1.1 are in the HW specs. 
+The Project has been divided in 3 phases. The specifications document for Bluetooth, depending its version, very between 1200 and 1500 pages which 
+covers phase 1 and 2 plus hardware device specifications.
+
+The development of the stack will be done keeping an eye to another operating systems, such as Linux and FreeBSD bluetooth kernel land implementations. And MacOS for the user land integration, and SymbianOS or JSR-82 for the possible bluetooth kit.
+
+The reading specs process can be mostly skipped, although is being using as well as other OS source code as consulting material. All non started parts are still to be designed before implementation
+
+Troubleshooting:[[BR]]
+1. Strong dependency with Haiku network stack, which is making hard to keep the development in R5. With the self compiling problem that it implies.[[BR]]
+2. Hardware availability(2 dongle(1damaged), 1 telephone, 2 PCMCIA)[[BR]]
+
+
+As many of you know from my blog, the project started from scratch with some success. 
+
+
+Technical Info:
+
+'''Phase 1: Base Stack:'''
+
+In this phase the intention would be give a a base for further development, user feedback of the technology and real communication.
+
+In an overview provide:
+* Physical layer of the architecture[[BR]]
+* User interaction for managing with devices local & remote(discovery, pairing, properties)[[BR]]
+* Connection oriented / Connectionless services through L2CAP[[BR]]
+
+H2: USB Transport driver (Commands/Events/ACL) 90%[[BR]]
+
+HCI:
+* Core layer 80%[[BR]]
+* Userland interface(ioctls/rawsocket) 70%[[BR]]
+* Managing tools(bluetoot_server, bluetooth kit) 70%[[BR]]
+
+L2CAP:
+* (core protocol/sockets) 65%[[BR]]
+
+Milestones:
+1. Real comunication with the driver (27/09/07)[[BR]]
+2. Stack allowing devices to discover the Haiku node (17/03/08)[[BR]]
+3. Stack allowing discover remote devices through an inquiry process (19/04/08)[[BR]]
+4. Stack handling correctily a pairing process between 2 devices (23/07/08)[[BR]]
+5. L2CAP connection-oriented channels (23/11/08)[[BR]]
+6. L2CAP connection-less  channels (23/11/08) (no device available for testing)[[BR]]
+
+'''Phase 2: Basic Stack:'''
+
+The intention of this phase would be complete the stack, and let all prepared for the 3rd phase.
+
+H2: USB Transport driver (SCO)
+
+HCI:
+* SCO interface[[BR]]
+* Managing tools(SDP server & client)[[BR]]
+
+RFCOMM: (core protocol/sockets)
+
+
+'''Phase 3: Upper Protocols, Profiles and Applications:'''
+
+Bluetooth profiles define how the bluetooth technology functionality is used, while the protocols is the implementation of the technology.
+An overview of all these functionalities:
+http://bluetooth.com/Bluetooth/Technology/Works/Profiles_Overview.htm
+
+Approximately, the specifications for each of these profiles do not go beyond the 100 pages. So Individuals could implement easily one of those functionalities.
+
+'''Bluetooth Identified tasks:'''
+
+Haiku Bluetooth Stack implements basic functionality on lower and middle layers, this functionality needs to be completed and all Bluetooth 2.X possibilities explored.
+
+Requirement: Bluetooth enabled Haiku system
+
+Skill set: C++ kernel development, userland development, overview bluetooth stack knowledge(optional)
+
+* New Tasks:
+ * RemoteDevices Database
+  * Implement RemoteDevice Archivability (Code-In)
+ * Manage server existence depending of LocalDevices (Code-In)
+* Fixes:
+ * Fix monitoring of incoming LocalDevices(USB)
+ * LocalDevices allocation/leaking LocalDevice::GetLocalDevice
+ * Wrong Create Connection parameters(paging) for Bluetooth 2.X
+* Improvements
+ * UI
+  * Improve Deskbar Addon
+  * Improve PinCode Window, move to kit? (Code-In)
+  * Improve Incomming connection Window, move to kit? (Code-In)
+  * Add Remaining Features in DeviceView
+  * Put non relevant information under a ToolTip (Code-In)
+ * Functionality
+  * UserLand tools(Preferences)
+  * Retrieve Discovery and DevClass (other settings?) in Startup (Code-In)
+  * Store information
+  * Window position
+  * Default LocalDevice
+  * Settings (Inquiry time, Policy)
+  * WriteLocal name to devices
+  * Pairing/Auth/Encryption use cases ...
+
+Bluetooth UI Requirements[[BR]]
+Server Classes:[[BR]]
+
+PincodePanel (implemented)[[BR]]
+ConnectionPanel (implemented)[[BR]]
+Deskbar Applet (implemented)[[BR]]
+
+User Classes:
+
+LocalDeviceView: View that shows a LocalDevice (implemented)
+* Icon with the type of device (from device class)
+* BDADDR
+* FriendlyName
+* …
+* HCIDelegate Control Flow
+* l2cap make sched connection to use portListener
+* addtoExpected → protect
+
+InquiryPanel: Window to perform a discovery of devices
+
+Preferences:
+* Connections & Channels List
+
+ Table Of Devices (Archived RemoteDevices classes)  (to be reviewed):
+* Known devices
+* Trusted devices
+* Blocked devices
+* Connected Devices
+ 
+ExtendedLocalDeviceView
+* Set LocalName
+* View LinkKeys
+
+General settings  (implemented):
+* Connections acceptation policy 
+* Identify current host as... (set localDeviceClass)
+* Start/Stop server
+* Show debug window
+* About
+
+Device-specific settings:
+* Enable/disable device
+* Enable/disable services
+
+Documentation[[BR]]
+AFAIR in the software layers point of view there were not important changes from 1.2 until 4.0. Most of them were focused in the physical layers. 
+
+
+Currently on the Kernel area there is the L2CAP[1] and HCI[5] implementations and there is the HCI transport protocol H2[2] (hardware support for usb dongles). 
+In the userland area we have the bluetooth_server[3] which interfaces with the kernel. Then there is a kit[4] which provides an API for applications development.[[BR]]
+Currently the best example of an application using this API would be the bluetooth preferences[6].[[BR]]
+[1]http://dev.haiku-os.org/browser/haiku/trunk/src/add-ons/kernel/network/protocols/l2cap[[BR]]
+[2]http://dev.haiku-os.org/browser/haiku/trunk/src/add-ons/kernel/drivers/bluetooth/h2/h2generic[[BR]]
+[3]http://dev.haiku-os.org/browser/haiku/trunk/src/servers/bluetooth[[BR]]
+[4]http://dev.haiku-os.org/browser/haiku/trunk/src/kits/bluetooth[[BR]]
+[5]http://dev.haiku-os.org/browser/haiku/trunk/src/add-ons/kernel/bluetooth[[BR]]
+[6]http://dev.haiku-os.org/browser/haiku/trunk/src/preferences/bluetooth[[BR]]