Changes

Jump to: navigation, search

DESK-MX6-L-AN-0001: Crank Storyboard engine and application

1,811 bytes added, 07:52, 20 September 2021
Introduction
| 1.0.0
| May 2021
|[[DESK-MX6-L/General/Release_Notes#DESK-MX6-L_1.0.0|DESK -MX6-L 1.0.0]]
|-
|}
[https://www.cranksoftware.com/ Crank Storyboard] is a cross-platform embedded GUI development framework, which will help the Customer to create aspirational GUI experiences. Crank Software has become the trusted embedded GUI framework across the wearables, industrial, healthcare, smart home, and appliances industries.
DAVE [[AXEL Lite SOM ]] is able ready to run Crank Storyboard engine in its bundled root file system: the following Application Note shows how to integrate the <code>sbengine</code> runtime and then executing the Storyboard application in the targte target platform.  [[File:Crank-and-Ametek.jpg | 500px | thumb| center| link=https://www.cranksoftware.com/| Crank Software Embedded graphical user interface framework]]
==Installing Crank Storyboard==
First of all, watch and follow the [https://www.cranksoftware.com/learn/video-library/getting-started-with-storyboard Getting started with Storyboard] page for learning how to install and learn the about Crank Software Storyboard.
==Installing sbengine in the root file system==
For installing the right [[DESK-MX6-L/General | DESK-MX6-L]] BSP version, create a proper [[AXEL_Lite_SOM/DESK-MX6-L/Development/How_to_create_a_bootable_microSD_card | SD card]] or download the already built version present into our [https://mirror.dave.eu/desk-mx-l/desk-mx6-l-1.0.0/ mirror cloud] services. More information on how to install <code>sbengine</code> in the target can be found in the [http://resources.cranksoftware.com/cranksoftware/v6.1.0/docs/webhelp/index.html#ch40.html resources Crank Software] web site. A simple but detailed description on how to install it is depicted for the [http://resources.cranksoftware.com/cranksoftware/v6.1.0/docs/webhelp/index.html#ch40s02.html Raspberry Pi] target.
=== SD card===
The proper SD card image should be selected, i.e.: <code>desk-image-qt5-desk-mx6.sdcard.gz</code> and then create the SD card using - for example - Linux or Windows [https://www.balena.io/etcher/ balenaEtcher] tool.
 
This image contains the OpenGL ES 2.0 driver required for running ''sbengine'' at the best performance on the framebuffer.
 
The SD card image can be downloaded from [https://mirror.dave.eu/desk-mx-l/desk-mx6-l-1.0.0/desk-image-qt5-desk-mx6.sdcard.gz our mirror] cloud service.
=== runtime installation ===
<pre class="board-terminal">
root@desk-mx6:~# mkdir -p /usr/share/crankroot@desk-mx6:~# mkdir -p /usr/share/crank/runtimes
root@desk-mx6:~# cp -aR /run/media/mmcblk0p1/linux-imx6yocto-armle-opengles_2.0-obj/ /usr/share/crank/runtimes
root@desk-mx6:~#
</pre>
Then, copy a Storyboard exmaple example in another directory, for examplee.g.:
<pre class="board-terminal">
root@desk-mx6:~# mkdir -p /usr/share/crank/apps
root@desk-mx6:~# cp -aR /run/media/mmcblk0p1/Launcher2016_FullScreen /usr/share/crank/apps
root@desk-mx6:~#
</pre>
 
=== touchscreen ===
Storyboard ''sbengine'' uses <code>mtdev</code> for accessing the touchscreen device. The mtdev library is then required.
 
For adding the mtdev package it is enough to build it with Yocto following the [[DESK-MX6-L/Development/Building_the_Yocto_BSP#Building_additional_packages | Building additional packages]] instructions. Otherwise, you can find the package [http://yocto.dave.eu/desk-mx6-l-1.0.0/cortexa9hf_neon/mtdev-1.1.5-r0.cortexa9hf_neon.rpm here] in our <code>yocto</code> server with pre-built packages.
 
Once the package has been built, just install it with <code>rpm</code>
 
<pre class="board-terminal">
root@desk-mx6:~# rpm -i mtdev-1.1.5-r0.cortexa9hf_neon.rpm
root@desk-mx6:~#
</pre>
 
thus enabling the touchscreen device.
== Script for automatic application startup==
* <code>storyboard_launcher.sh</code>
<pre classsyntaxhighlight lang="board-terminalbash">#!/bin/sh 
set -e
$ENGINE/bin/gstreamer-backend &
$ENGINE/bin/sbengine -omtdev,device=/dev/input/event0,points=1 -orender_mgr,multisample=0,scale=aspect $SB_APP
</presyntaxhighlightand then set the correct attribute  chmod +x /etc/init.d/storyboard_launcher.sh
=== systemd service ===
systemctl enable storyboard.service
== Results ==
At the next reboot, the ''service'' will start <code>sbengine</code> with the selected application:
desk-mx6 login:
</pre>
 
[[File:Crank.jpg |thumb|center|700px | Crank Software Storyboard Launcher demo]]
8,154
edits

Navigation menu