---
android/README | 84 ++++++++++++++++++++++++++++++++++------------------------
1 file changed, 49 insertions(+), 35 deletions(-)
diff --git a/android/README b/android/README
index b1ac886..aa12e51 100644
--- a/android/README
+++ b/android/README
@@ -9,14 +9,13 @@ replacement to Android provided Bluetooth stack.
More details about BlueZ for Android architecture and components can be found
in android/hal-ipc-api.txt file.
-Supported Android version: 4.4
+Supported Android version: 4.4 KitKat and 5.0 Lollipop
Building and running on Android
===============================
-Steps needed to build and run Android Open Source Project 4.4 with
-integrated BlueZ.
+Steps needed to build and run Android Open Source Project with integrated BlueZ.
Build requirements
@@ -30,11 +29,10 @@ is available at https://code.google.com/p/aosp-bluez.glib/
'external/bluetooth/sbc' directory. Library is build from Android.mk provided
by BlueZ. SBC code is available at git://git.kernel.org/pub/scm/bluetooth/sbc
-- Bionic support - Currently only 'master' branch available at
-https://android.googlesource.com/platform/bionic provides all required
-functionality and running BlueZ on release branch requires backporting missing
-features (currently epoll_create1 and ppoll calls for Android 4.4). Sample
-Bionic for Android 4.4 with all required features backported is available at
+- Bionic support - Android 5.0 provides all required functionality. Running
+BlueZ on Android 4.4 requires backporting missing features (epoll_create1 and
+ppoll calls). Sample Bionic for Android 4.4 with all required features
+backported is available at
https://code.google.com/p/aosp-bluez.platform-bionic/
Runtime requirements
@@ -49,29 +47,44 @@ import init.bluetooth.rc
For convenience examples are provided at:
https://code.google.com/p/aosp-bluez.device-lge-mako/ (Nexus 4)
+https://code.google.com/p/aosp-bluez.device-lge-ham/ (Nexus 5)
https://code.google.com/p/aosp-bluez.device-asus-flo/ (Nexus 7 2013)
+Security-Enhanced Linux in Android
+----------------------------------
+
+Since 5.0 release Android moved to full enforcement of SELinux. This requires
+proper policy to be provided for all BlueZ for Android services (and services
+interacting with BlueZ). Policies should be placed in external/selinux/ path.
+
+Required policy files are provided at <TBD>.
+
+For convenience sepolicy.git with all required policies is available at:
+https://code.google.com/p/aosp-bluez.external-sepolicy/
Downloading and building
------------------------
-Building for Android requires full Android AOSP source tree. Sample Android
-4.4 tree with all required components present is available at
+Building for Android requires full Android AOSP source tree. Sample Android tree
+with all required components present is available at
http://code.google.com/p/aosp-bluez/
-This tree provides support for Nexus4 (target aosp_mako-userdebug) and
-Nexus 7 2013 (target aosp_flo-userdebug). Tree does not provide binary blobs
-needed to run Android on supported devices. Those can be obtained from
+This tree provides support for Nexus4 (mako), Nexus 5 (hammerhead) and
+Nexus 7 2013 (flo, deb). Tree does not provide binary blobs needed to run
+Android on supported devices. Those can be obtained from
https://developers.google.com/android/nexus/drivers. Binary blobs needs to be
unpacked (EULA acceptance required) into 'vendor' directory of Android tree.
Downloading:
-repo init -u https://code.google.com/p/aosp-bluez.platform-manifest -b kitkat
+Android 5.0 - 'lollipop' branch
+Android 4.4 - 'kitkat' branch
+
+repo init -u https://code.google.com/p/aosp-bluez.platform-manifest -b lollipop
repo sync
Building:
source build/envsetup.sh
-lunch aosp_mako-userdebug or lunch aosp_flo-userdebug
+lunch aosp_<target>-userdebug
make -j8
Flashing:
@@ -263,21 +276,23 @@ initial - only initial implementations is present, Android Framework is
able to initialize but most likely not able to use it
not started - no implementation, Android Framework is not able to initialize it
-Profile ID HAL header Status
----------------------------------------
-core bluetooth.h complete
-a2dp bt_av.h complete
-gatt bt_gatt.h complete
- bt_gatt_client.h complete
- bt_gatt_server.h complete
-handsfree bt_hf.h complete
-hidhost bt_hh.h complete
-health bt_hl.h complete
-pan bt_pan.h complete
-avrcp bt_rc.h complete
-socket bt_sock.h complete
-hf_client bt_hf_client.h initial
-map_client bt_mce.h complete
+Profile ID HAL header 4.4 Status 5.0 status
+-------------------------------------------------------------
+core bluetooth.h complete partial
+a2dp bt_av.h complete complete
+gatt bt_gatt.h complete partial
+ bt_gatt_client.h complete partial
+ bt_gatt_server.h complete partial
+handsfree bt_hf.h complete partial
+hidhost bt_hh.h complete complete
+health bt_hl.h complete complete
+pan bt_pan.h complete complete
+avrcp bt_rc.h complete complete
+socket bt_sock.h complete partial
+handsfree_client bt_hf_client.h N/A partial
+map_client bt_mce.h N/A complete
+a2dp_sink bt_av.h N/A partial
+avrcp_ctrl bt_rc.h N/A partial
Implementation shortcomings
@@ -344,11 +359,6 @@ methods:
client->set_adv_data missing kernel support for vendor data
client->connect is_direct parameter is ignored
-HAL HF Client
--------------
-
-Available on Android only when BLUEZ_EXTENSIONS flag set in BoardConfig.mk
-
Audio SCO HAL
=============
@@ -387,6 +397,10 @@ affect qualification or user experience. This section provides list of
recommended Android fixes that are not part of latest AOSP release supported by
BlueZ.
+For Android 5.0 Lollipop:
+<TBD>
+
+For Android 4.4 KitKat:
https://android-review.googlesource.com/82757
https://android-review.googlesource.com/87670
https://android-review.googlesource.com/88384
--
1.9.1
On Thursday 20 November 2014 18:24:55 Szymon Janc wrote:
> ---
> android/README | 84
> ++++++++++++++++++++++++++++++++++------------------------ 1 file changed,
> 49 insertions(+), 35 deletions(-)
>
> diff --git a/android/README b/android/README
> index b1ac886..aa12e51 100644
> --- a/android/README
> +++ b/android/README
> @@ -9,14 +9,13 @@ replacement to Android provided Bluetooth stack.
> More details about BlueZ for Android architecture and components can be
> found in android/hal-ipc-api.txt file.
>
> -Supported Android version: 4.4
> +Supported Android version: 4.4 KitKat and 5.0 Lollipop
>
>
> Building and running on Android
> ===============================
>
> -Steps needed to build and run Android Open Source Project 4.4 with
> -integrated BlueZ.
> +Steps needed to build and run Android Open Source Project with integrated
> BlueZ.
>
>
> Build requirements
> @@ -30,11 +29,10 @@ is available at
> https://code.google.com/p/aosp-bluez.glib/ 'external/bluetooth/sbc'
> directory. Library is build from Android.mk provided by BlueZ. SBC code is
> available at git://git.kernel.org/pub/scm/bluetooth/sbc
>
> -- Bionic support - Currently only 'master' branch available at
> -https://android.googlesource.com/platform/bionic provides all required
> -functionality and running BlueZ on release branch requires backporting
> missing -features (currently epoll_create1 and ppoll calls for Android
> 4.4). Sample -Bionic for Android 4.4 with all required features backported
> is available at +- Bionic support - Android 5.0 provides all required
> functionality. Running +BlueZ on Android 4.4 requires backporting missing
> features (epoll_create1 and +ppoll calls). Sample Bionic for Android 4.4
> with all required features +backported is available at
> https://code.google.com/p/aosp-bluez.platform-bionic/
>
> Runtime requirements
> @@ -49,29 +47,44 @@ import init.bluetooth.rc
>
> For convenience examples are provided at:
> https://code.google.com/p/aosp-bluez.device-lge-mako/ (Nexus 4)
> +https://code.google.com/p/aosp-bluez.device-lge-ham/ (Nexus 5)
> https://code.google.com/p/aosp-bluez.device-asus-flo/ (Nexus 7 2013)
>
> +Security-Enhanced Linux in Android
> +----------------------------------
> +
> +Since 5.0 release Android moved to full enforcement of SELinux. This
> requires +proper policy to be provided for all BlueZ for Android services
> (and services +interacting with BlueZ). Policies should be placed in
> external/selinux/ path. +
> +Required policy files are provided at <TBD>.
> +
> +For convenience sepolicy.git with all required policies is available at:
> +https://code.google.com/p/aosp-bluez.external-sepolicy/
>
> Downloading and building
> ------------------------
>
> -Building for Android requires full Android AOSP source tree. Sample Android
> -4.4 tree with all required components present is available at
> +Building for Android requires full Android AOSP source tree. Sample Android
> tree +with all required components present is available at
> http://code.google.com/p/aosp-bluez/
>
> -This tree provides support for Nexus4 (target aosp_mako-userdebug) and
> -Nexus 7 2013 (target aosp_flo-userdebug). Tree does not provide binary
> blobs -needed to run Android on supported devices. Those can be obtained
> from +This tree provides support for Nexus4 (mako), Nexus 5 (hammerhead)
> and +Nexus 7 2013 (flo, deb). Tree does not provide binary blobs needed to
> run +Android on supported devices. Those can be obtained from
> https://developers.google.com/android/nexus/drivers. Binary blobs needs to
> be unpacked (EULA acceptance required) into 'vendor' directory of Android
> tree.
>
> Downloading:
> -repo init -u https://code.google.com/p/aosp-bluez.platform-manifest -b
> kitkat +Android 5.0 - 'lollipop' branch
> +Android 4.4 - 'kitkat' branch
> +
> +repo init -u https://code.google.com/p/aosp-bluez.platform-manifest -b
> lollipop repo sync
>
> Building:
> source build/envsetup.sh
> -lunch aosp_mako-userdebug or lunch aosp_flo-userdebug
> +lunch aosp_<target>-userdebug
> make -j8
>
> Flashing:
> @@ -263,21 +276,23 @@ initial - only initial implementations is present,
> Android Framework is able to initialize but most likely not able to use it
> not started - no implementation, Android Framework is not able to
> initialize it
>
> -Profile ID HAL header Status
> ----------------------------------------
> -core bluetooth.h complete
> -a2dp bt_av.h complete
> -gatt bt_gatt.h complete
> - bt_gatt_client.h complete
> - bt_gatt_server.h complete
> -handsfree bt_hf.h complete
> -hidhost bt_hh.h complete
> -health bt_hl.h complete
> -pan bt_pan.h complete
> -avrcp bt_rc.h complete
> -socket bt_sock.h complete
> -hf_client bt_hf_client.h initial
> -map_client bt_mce.h complete
> +Profile ID HAL header 4.4 Status 5.0 status
> +-------------------------------------------------------------
> +core bluetooth.h complete partial
> +a2dp bt_av.h complete complete
> +gatt bt_gatt.h complete partial
> + bt_gatt_client.h complete partial
> + bt_gatt_server.h complete partial
> +handsfree bt_hf.h complete partial
> +hidhost bt_hh.h complete complete
> +health bt_hl.h complete complete
> +pan bt_pan.h complete complete
> +avrcp bt_rc.h complete complete
> +socket bt_sock.h complete partial
> +handsfree_client bt_hf_client.h N/A partial
> +map_client bt_mce.h N/A complete
> +a2dp_sink bt_av.h N/A partial
> +avrcp_ctrl bt_rc.h N/A partial
>
>
> Implementation shortcomings
> @@ -344,11 +359,6 @@ methods:
> client->set_adv_data missing kernel support for vendor data
> client->connect is_direct parameter is ignored
>
> -HAL HF Client
> --------------
> -
> -Available on Android only when BLUEZ_EXTENSIONS flag set in BoardConfig.mk
> -
>
> Audio SCO HAL
> =============
> @@ -387,6 +397,10 @@ affect qualification or user experience. This section
> provides list of recommended Android fixes that are not part of latest AOSP
> release supported by BlueZ.
>
> +For Android 5.0 Lollipop:
> +<TBD>
> +
> +For Android 4.4 KitKat:
> https://android-review.googlesource.com/82757
> https://android-review.googlesource.com/87670
> https://android-review.googlesource.com/88384
Pushed (with typo in commit msg fixed).
--
Szymon K. Janc
[email protected]