Select the version of your OS from the tabs below. If you don't know the version you are using, run the command cat /etc/os-release or cat /etc/issue on the board.
Crank Software is the company that develops Crank Storyboard, a GUI design and development tool created exclusively for embedded systems. Storyboard’s designer-developer parallel workflow environment accelerates design iteration and the overall development process by up to 50% while retaining design vision with maximum performance.
Crank has now added support for the Toradex Linux platform Torizon. Supporting Toradex System on Modules based on the NXP® i.MX 6, i.MX 7 and i.MX 8
Crank Software has created a Storyboard Container for Torizon and uploaded it to Docker hub. Some of the advantages of using containers are as follows:
The following Computer on Modules are supported:
While you can use a wide variety of displays and monitors, additional configuration may be required for a specific setup.
A section at the end of this guide provides instructions about the display and touch screen configuration.
In order to provide a good experience with the Crank Demonstration, due to the static resolution (1280x720) of the demo, Toradex advises you to use the following hardware combination:
Note: Multiple displays will just extend the demo application, making it show up only on one display in case you have both HDMI and LVDS connected at the same time.
Warning: While it's recommended to use this hardware combination for this specific demonstration, all Toradex displays and Torizon compatible modules should work with Crank.
This partner demo container is meant for the evaluation of the technology. It is suitable for development, but not for production.
This section provides instructions for you to quickly get started with Crank Storyboard.
docker run command optionsThe image TorizonCore with evaluation containers has many different demos. For instructions about how to install Torizon on your board, refer to Toradex Quickstart Guide.
With Portainer opened, explore it by going to the App Templates section in Portainer and click on the Crank template.
Available Container Examples in Portainer
The Storyboard container has been built to interface with Weston, so we need to launch the Weston interface. Fortunately, this has been built into a handy container that can be downloaded and run.
Open a shell connection to the Torizon system (serial or ssh).
$ ssh torizon@<ip address>
Now you can run the Weston Container. Just choose your architecture from the boxes below:
Warning: Make sure you have a head (display or an HDMI screen) connected to the board before starting it, otherwise the application will not start. Check the Setting up Displays with Torizon article if you need more information.
From your board's terminal, download the docker-compose file:
$ wget https://raw.githubusercontent.com/toradex/torizon-samples/bullseye/crank/docker-compose.armhf.yml
Now we can run the Storyboard container working with the Weston interface. This has been configured to leverage the OpenGL hardware acceleration on the platform.
$ docker-compose -f docker-compose.armhf.yml up
Note: This command will download the container and then run it, once it’s downloaded it will launch directly.
This container has been built to automatically launch one of our oven demo applications using Crank Storyboard.
Warning: Make sure you have a head (display or an HDMI screen) connected to the board before starting it, otherwise the application will not start. Check the Setting up Displays with Torizon article if you need more information.
Attention: By executing the following command you are accepting the terms and conditions of the NXP's End-User License Agreement (EULA).
From your board's terminal, download the docker-compose file:
$ wget https://raw.githubusercontent.com/toradex/torizon-samples/bullseye/crank/docker-compose.arm64.yml
Now we can run the Storyboard container working with the Weston interface. This has been configured to leverage the OpenGL hardware acceleration on the platform.
$ docker-compose -f docker-compose.arm64.yml up
Note: This command will download the container and then run it, once it’s downloaded it will launch directly.
This container has been built to automatically launch one of our medical demo applications using the Crank Storyboard.
The following video shows the walkthrough of these steps and how you can deploy your own custom application using Storyboard.
Download your full-featured free trial of Crank Storyboard on Crank's Website.
For the displays recommended by Toradex, go to Setting up Recommended Displays with Torizon page.
Displays and Monitors used in Embedded Systems are available in a myriad of configuration possibilities - resistive, capacitive or without touch, single or multi-touch, different resolution, density of pixels, pin-out and clock frequency are some examples.
To make things easy for you, Toradex provides specific instructions on how to use its display offerings as well as comprehensive information about how to interface your custom display or monitor to Toradex modules.
There are three tested and recommended displays by Toradex:
You can easily set-up and get them running with 3 steps explained on Setting up Recommended Displays with Torizon. If you prefer to configure a specific display, it is suggested the reading about the easy to use Torizon device tree overlays container on Device Tree Overlays. If you need to calibrate the touch screen, learn how on Touch Screen Calibration (Torizon).
These release notes are strictly related to the test of the Crank Storyboard container in Toradex hardware.
Crank Software is the company that develops Crank Storyboard, a GUI design and development tool created exclusively for embedded systems. Storyboard’s designer-developer parallel workflow environment accelerates design iteration and the overall development process by up to 50% while retaining design vision with maximum performance.
Crank has now added support for the Toradex Linux platform Torizon. Supporting Toradex System on Modules based on the NXP® i.MX 6, i.MX 7 and i.MX 8
Crank Software has created a Storyboard Container for Torizon and uploaded it to Docker hub. Some of the advantages of using containers are as follows:
The following Computer on Modules are supported:
While you can use a wide variety of displays and monitors, additional configuration may be required for a specific setup.
A section at the end of this guide provides instructions about the display and touch screen configuration.
In order to provide a good experience with the Crank Demonstration, due to the static resolution of the demo, Toradex advises you to use the following hardware combination:
Note: Multiple displays will just extend the demo application, making it show up only on one display in case you have both HDMI and LVDS connected at the same time.
Warning: While it's recommended to use this hardware combination for this specific demonstration, all Toradex displays and Torizon compatible modules should work with Crank.
This partner demo container is meant for the evaluation of the technology. It is suitable for development, but not for production.
This section provides instructions for you to quickly get started with Crank Storyboard.
docker run command optionsAttention: please use the tag buster-20200415 if you are using the TorizonCore Monthly release from April, a.k.a 4.0.0-devel-202004+build.3. At the moment you should only use the tag buster if you are using a newer release of TorizonCore.
The Storyboard container has been built to interface with Weston, so we need to launch the Weston interface. Fortunately, this has been built into a handy container that can be downloaded and run.
Open a shell connection to the Torizon system (serial or ssh).
$ ssh torizon@<ip address>
Now you can run the Weston Container. Just choose your architecture from the boxes below:
$ docker run -d -it --restart=always --privileged -v /tmp:/tmp -v /run/udev/:/run/udev torizon/arm32v7-debian-weston:buster weston-launch --tty=/dev/tty7 --user=root
Note: This command will download the container and then run it, once it’s downloaded it will launch directly.
Validate that the container is running by typing the following command:
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2911ace7f39f torizon/arm32v7-debian-weston:buster "/usr/bin/entry.sh w…" 14 minutes ago Up 14 minutes wizardly_jepsen
Now we can run the Storyboard container working with the Weston interface. This has been configured to leverage the OpenGL hardware acceleration on the platform.
$ docker run -it --privileged -v /home/torizon/crank/scp:/usr/crank/scp -v /dev:/dev -v /tmp:/tmp cranksoftware/torizon_imx6:6_1
$ docker run -d -it --restart=always --privileged -v /tmp:/tmp -v /run/udev/:/run/udev torizon/arm64v8-debian-weston-vivante:buster weston-launch --tty=/dev/tty7 --user=root
Note: This command will download the container and then run it, once it’s downloaded it will launch directly.
Validate that the container is running by typing the following command:
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2911ace7f39f torizon/arm32v7-debian-weston:buster "/usr/bin/entry.sh w…" 14 minutes ago Up 14 minutes wizardly_jepsen
Now we can run the Storyboard container working with the Weston interface. This has been configured to leverage the OpenGL hardware acceleration on the platform.
$ docker run -it --privileged -v /home/torizon/crank/scp:/usr/crank/scp -v /dev:/dev -v /tmp:/tmp cranksoftware/torizon_imx8:6_1
This container has been built to automatically launch one of our medical demo applications using the Crank Storyboard 6.1 release.
The following video shows the walkthrough of these steps and how you can deploy your own custom application using Storyboard.
Download your full-featured free trial of Crank Storyboard on Crank's Website.
For the displays recommended by Toradex, go to Setting up Recommended Displays with Torizon page.
Displays and Monitors used in Embedded Systems are available in a myriad of configuration possibilities - resistive, capacitive or without touch, single or multi-touch, different resolution, density of pixels, pin-out and clock frequency are some examples.
To make things easy for you, Toradex provides specific instructions on how to use its display offerings as well as comprehensive information about how to interface your custom display or monitor to Toradex modules.
There are three tested and recommended displays by Toradex:
You can easily set-up and get them running with 3 steps explained on Setting up Recommended Displays with Torizon. If you prefer to configure a specific display, it is suggested the reading about the easy to use Torizon device tree overlays container on Device Tree Overlays. If you need to calibrate the touch screen, learn how on Touch Screen Calibration (Torizon).
These release notes are strictly related to the test of the Crank Storyboard container in Toradex hardware.
