diff options
author | 2018-12-17 09:37:38 -0800 | |
---|---|---|
committer | 2018-12-17 09:37:38 -0800 | |
commit | a4013befcbb2c82273067e401d3d393445a5a100 (patch) | |
tree | 18a48f2d66cabbbc55c47729c3bbd4184033d8be | |
parent | 4d1915579f5bfbab1c596f9b105f1c10184eef31 (diff) |
Building for Raspberry PI: Added touchscreen configuration info.
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
-rw-r--r-- | docs/getting-started/machines/raspberrypi.md | 78 |
1 files changed, 76 insertions, 2 deletions
diff --git a/docs/getting-started/machines/raspberrypi.md b/docs/getting-started/machines/raspberrypi.md index b1b31cb..7727267 100644 --- a/docs/getting-started/machines/raspberrypi.md +++ b/docs/getting-started/machines/raspberrypi.md @@ -39,9 +39,36 @@ $ source meta-agl/scripts/aglsetup.sh -m raspberrypi2 agl-demo agl-netboot agl-a $ source meta-agl/scripts/aglsetup.sh -m raspberrypi3 agl-demo agl-netboot agl-appfw-smack ``` -## 2. Using BitBake +## 2. Configuring the Build to Include Packages Under a Commercial License + +Before launching the build, it is good to be sure your build +configuration is set up correctly (`/build/conf/local.conf` file). +The +"[Customizing Your Build](./image-workflow-cust-build.html)" +section highlights some common configurations that are useful when +building any AGL image. + +For the Raspberry PI platforms, you need to take an additional +configuration step if you want to include any packages under a +commercial license. + +For example, suppose you want to include an implementation of the +[OpenMAX](https://www.khronos.org/openmax/) Intagration Library +(`libomxil`) under a commercial license as part of your AGL image. +If so, you must include the following two lines in your +`/build/conf/local.conf` file: + +```bash +# For libomxil +LICENSE_FLAGS_WHITELIST = "commercial" + +IMAGE_INSTALL_append = " libomxil" +``` + +## 3. Using BitBake This section shows the `bitbake` command used to build the AGL image. + Before running BitBake to start your build, it is good to be reminded that AGL does provide a pre-built image for developers that want to use the Raspberry PI 3 board. @@ -54,6 +81,7 @@ For the supported image, the filename has the following form: <release-name>/<release-number>/raspberrypi3/deploy/images/raspberrypi3/* ``` + Start the build using the `bitbake` command. **NOTE:** An initial build can take many hours depending on your @@ -75,7 +103,7 @@ Here is example for the Raspberry PI 3 board: If you build for the Raspberry PI 2 board, the location uses "raspberrypi2" in the path. -## 2. Deploying the AGL Demo Image +## 4. Deploying the AGL Demo Image Deploying the AGL demo image consists of copying the image on a MicroSD card, plugging the card into the Raspberry PI board, and then booting the board. @@ -147,3 +175,49 @@ the image on the Raspberry PI 2 or 3 board: ``` 4. Plug your MicroSD card into the Raspberry PI board and boot the device. + +## 5. Raspberry PI Touch Display + +If you have connected the official +[Raspberry PI Touch Display](https://www.raspberrypi.org/products/raspberry-pi-touch-display/), +you can configure the display by editing the `weston.ini` file. + +Plenty of information exists on how to configure and use this touchscreen. +See the following references for more information: + +* For information on where the `weston.ini` file is located, see + [location](https://jlk.fjfi.cvut.cz/arch/manpages/man/weston.ini.5#DESCRIPTION). + +* For information on the `weston.ini` file in general, see the + [manpage](https://jlk.fjfi.cvut.cz/arch/manpages/man/weston.ini.5). + +* For information on Weston, which is the reference implementation of Wayland, see + [Wayland](https://wiki.archlinux.org/index.php/wayland). + +As an example on how to configure and manipulate the touchscreen, consider +the following edits to the `weston.ini` file used to rotate the +display: + +```bash +root@raspberrypi3:/etc/xdg/weston# cat weston.ini +[core] +backend=drm-backend.so +shell=desktop-shell.so + +[shell] +locking=true +# Uncomment below to hide panel +#panel-location=none + +[launcher] +icon=/usr/share/weston/terminal.png +path=/usr/bin/weston-terminal + +[launcher] +icon=/usr/share/weston/icon_flower.png +path=/usr/bin/weston-flower + +[output] +name=DSI-1 +transform=270 +``` |