ubuntu: initial release note updates for 14.12

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>

1 files changed, 45 insertions, 7 deletions

diff --git a/ubuntu/boards/snapdragon/README.textile.in b/ubuntu/boards/snapdragon/README.textile.in
index b7ab8b7..e992e79 100644
--- a/ubuntu/boards/snapdragon/README.textile.in
+++ b/ubuntu/boards/snapdragon/README.textile.in
@@ -2,15 +2,16 @@ The Linaro Qualcomm Landing Team is pleased to announce the new release of the _
 
 h4. What's new in this release
 
-* This release is based on Ubuntu 14.10
-* This release is based on Linux kernel v3.17
-* The release supports the following boards: Inforce IFC6410, Compulab CM-QS600.
-* The graphic stack has been updated and is using Mesa master branch as of 11/12/2014, and libdrm 2.4.58
+* This release is based on Linux kernel v3.18
+* Bluetooth support is enabled for IFC6410 using the mainline ar3k BT drivers and Bluez stack. File transfer, keyboard, mouse and PAN have been validated in this release.
+* The graphic stack has been updated and is using Mesa master branch as of 12/10/2014
 * The serial device node name has been changed from ttyHSL to ttyMSM since Linux kernel 3.14
 * Bug fixed:
-** N/A
+** "cpufreq wrongly configured CLK in Linaro 3.17 integration branch":https://bugs.linaro.org/show_bug.cgi?id=998
+** "On IFC6410 CPUIDLE v14 driver patches do not work with latest trustzone firmware":https://bugs.linaro.org/show_bug.cgi?id=981
+** "Verify USB functionality without DRM_MSM on 3.18 tracking branch":https://bugs.linaro.org/show_bug.cgi?id=898
 
-This is the first release of a new series for the Linaro Linux release for Snapdragon 600 processor. Going forward, the Linaro member monthly builds for Snapdragon 600 processor will be providing a kernel based on the current Linux kernel ("www.kernel.org":https://www.kernel.org) available at the time of the release. The goals of the Linaro Linux releases for Snapdragon 600 processor are to align with the latest Linux Kernel, close the gaps in features provided and migrate from the existing 3.4 vendor kernel. One immediate consequence of this migration is that some regressions are expected. Current regressions include: lack of audio support, video hardware acceleration, bluetooth and support for running CPU beyond 1Ghz. Developers can continue to use the "Linaro Linux release 14.10 for Snapdragon 600 processor":http://releases.linaro.org/14.10/ubuntu/ifc6410/, which is based on Linux kernel v3.4 and Ubuntu 14.04 if needed.
+This is the second release of a new series for the Linaro Linux release for Snapdragon 600 processor. Going forward, the Linaro member monthly builds for Snapdragon 600 processor will be providing a kernel based on the current Linux kernel ("www.kernel.org":https://www.kernel.org) available at the time of the release. The goals of the Linaro Linux releases for Snapdragon 600 processor are to align with the latest Linux Kernel, close the gaps in features provided and migrate from the existing 3.4 vendor kernel. One immediate consequence of this migration is that some regressions are expected. Current regressions include: lack of audio support, video hardware acceleration and support for running CPU beyond 1Ghz. Developers can continue to use the "Linaro Linux release 14.10 for Snapdragon 600 processor":http://releases.linaro.org/14.10/ubuntu/ifc6410/, which is based on Linux kernel v3.4 and Ubuntu 14.04 if needed.
 
 h4. Features
 
@@ -37,7 +38,7 @@ The Linaro Linux version ##RELEASE## for the Snapdragon 600 supports the followi
 ** HDMI display
 ** UART, Ethernet, SD, eMMC, SATA
 ** USB2.0 (Mouse, Keyboard, Storage)
-** Wifi using on-board QCA6234x
+** Wifi and Bluetooth using on-board QCA6234x
 
 h4. Information about the IFC6410 board
 
@@ -193,6 +194,42 @@ Note: The default bootargs enable the kernel messages to be displayed on the ser
 
 Once you have a root prompt on the serial console, you have a functional Ubuntu system.
 
+h4. Configuring and using Bluetooth and WLAN
+
+Firmware are required for Bluetooth and WLAN to work properly. If you have followed the instructions so far, the firmware have been installed. For both WLAN and Bluetooth appropriate mainline drivers are used, respectively ath6kl and ar3k.
+
+WLAN should be up and running out of the box, using the releases images. If you are building your own kernel, please be aware that the WLAN driver and some mac802.11 drivers are compiled as modules, and need to be deployed into the root file system. WLAN can be configured either on the command line, or using the graphical Gnome applet once the desktop is started.
+
+For Bluetooth, it is for now not enabled by default in the image, and you need to run the following command on the root prompt to properly start and configure the Bluetooth chip:
+
+bc. hciattach -s 115200 /dev/ttyMSM1 ath3k 115200
+
+And this command will return, if everything is working properly:
+
+bc. Device setup complete
+
+Finally to make sure the Bluetooth chip is configured correctly, you can run the @hciconfig@ tool, which should return something along these lines:
+
+bc. hciconfig
+hci0:   Type: BR/EDR  Bus: UART
+BD Address: 00:3C:7F:F0:F0:0A  ACL MTU: 1021:8  SCO MTU: 124:0
+UP RUNNING PSCAN
+RX bytes:558 acl:0 sco:0 events:27 errors:0
+TX bytes:866 acl:0 sco:0 commands:27 errors:0
+
+You can also scan for Bluetooth devices nearby, from the command line, e.g.:
+
+bc. hcitool scan
+Scanning ...
+        BC:5F:BC:44:FB:AC       Nexus 5
+
+If you configure the Bluetooth chip before starting the graphical desktop (e.g. Gnome), then you should be able to use the Gnome Bluetooth applet to connect to any device and use Bluetooth functions.
+
+Note that if you are using the developer image you might need to install the Bluez applications and librairies:
+
+bc. sudo apt-get update
+sudo apt-get install bluez
+
 h4. How to get and customize the kernel source code
 
 The Linux kernel used in this release is available via tags in the Linaro Qualcomm Landing Team git repository:
@@ -271,6 +308,7 @@ adb can be used to connect to the target, for example it can be used to reboot t
 
 h4. Known issues and limitations
 
+* The serial/uart driver does not support high speed transfer, and is limited to 115200 speed. Since UART is used between the on-boart Bluetooth devices and the SoC, this limits the bandwidth between Bluetooth device and the Snapdragon 600. Some use cases such as Bluetooth audio cannot work properly at such low speed. Some other use cases such as data transfer will work but slower than expected. Suppport for high speed UART is being implemented, and will be released in a future release.
 * On Compulab QS-600, do not flash the released root filesystem images (gnome or developer) with fastboot into eMMC. The eMMC partition layout is different than on IFC6410, and userdata partition is too small, and you might end up with corruption, instead you can use the method to install the image on external storage (USB, SATA, SD card).
 * Audio is currently not supported in this release.
 * Some recent IFC6410 or Compulab QS-600 boards come with more recent bootloaders pre flashed (e.g. the bootloaders from Inforce Android Kit Kat release), and display clocks cannot be enabled properly. See "this email":http://lists.freedesktop.org/archives/freedreno/2014-November/000135.html for more information. The solution is to downgrade the bootloader, as explained in the email above.