This project is an example on how to use your Toradex SoM as a pdf viewer and/or slideshow presentation viewer. It was first developed for a Toradex talk in MiniDebConf Brasília 2023.
In this example you will learn:
- How to install a pdf viewer application;
- How to launch it in the container (fullscreen or not);
- How to enable weston's developer mode;
- How to launch the pdf viewer automatically after boot.
- Apalis iMX8 Toradex SoM;
- Ixora Carrier Board;
- Display, TV or projector.
This project contains 2 folders, each of then corresponds to one container image that will be generated and used.
- The
presentation-appfolder contains the instructions to build a container image which will display a slideshow (or any pdf) in the screen. - The
weston-custom-bgfolder contains the instructions to build a custom weston image, allowing one to set a custom background image, setting additional weston configuration, etc.
For a detailed description about each image, check out the instructions in the folder's README.
To use this demo as is, you can use docker compose to launch the default
container images listed in docker-compose.yml file. If you are in this repo's
top level folder, just copy docker-compose.yml to your board and execute:
docker compose -f /path/to/docker-compose.yml upAs an alternative, you can upload docker-compose.yml to our Torizon
Platform and get it working on your board, boards or
fleet in seconds!
If you want to automatically start the PDF viewer on boot, you can copy
docker-compose.yml to /var/sota/storage/docker-compose/ and reboot the
board.
- Debian Containers for Torizon
- Modifying TorizonCore Debian Based Container Images
- Working with Weston on TorizonCore
- Deploying Container Images to TorizonCore
- Using Multiple Containers with TorizonCore
- How to Autorun an Application With TorizonCore
- Torizon Best Practices Guide - Sharing a Pluggable Device
The initial demo was constructed to showcase our product and its potential in a conference (MiniDebConf Brasília 2023), so it has some different aspects than one might want. For example, we set a custom background image to show to the audience we are running Debian. We also set a 5 seconds sleep before launching the application to emphasize the last point. We use the --developer option to have a navigation bar and a easy way to launch a terminal, this was done so we could show it as a demo in the end of the talk. Regardless of these aspects, the demo still brings important aspects like how to launch a slideshow in fullscreen mode, how to run it automatically after boot, how to customize weston to one own needs, how to use a multi-container setup with docker compose, etc.
This demo was developed by Carlos Henrique Lima Melara with the help of many other colleagues (thank you all)!
This project is licensed under the terms of the MIT License.