meta-thunder-framework

Introduction

Welcome to the meta-thunder-framework repository! This project serves as a Yocto Project layer, enabling you to include a minimal Thunder into your Open Embedded/Yocto based embedded Linux systems. Thunder provides a comprehensive framework for developing and deploying web-based applications, bringing rich, interactive experiences to embedded devices. Thunders functionality is extendable by adding plugins. Whether you're developing smart appliances, digital signage, or any other embedded web application, this layer equips you with the essential tools and recipes to seamlessly integrate Thunder framework into your Yocto-based project.

Prerequisites

Before you begin, make sure you have the following prerequisites installed on your development machine:

• Yocto Project - Ensure that you have Yocto Project installed and configured on your system.
• Git - You'll need Git for version control.
• A compatible embedded Linux target platform or emulator.

Summary of commands on Ubuntu

sudo apt install gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libsdl1.2-dev python3-subunit mesa-common-dev zstd liblz4-tool file locales

sudo locale-gen en_US.UTF-8

Quick Setup for RaspberryPi

To get started with meta-thunder-framework and begin building thunder based applications for your embedded Linux project, follow these quick setup instructions:

1. Create a workspace:

   mkdir ${HOME}/thunder-yocto/{build-rpi,download,source}

2. Enter the source folder

3. Get generic layers

   git clone -b scarthgap git://git.yoctoproject.org/poky
   git clone -b scarthgap git://git.openembedded.org/openembedded-core
   git clone -b scarthgap git://git.openembedded.org/meta-openembedded

4. Get our meta layers

   git clone -b main git@github.com:Metrological/meta-thunder-framework.git

5. Get a BSP layer for RaspberryPi

   git clone -b scarthgap git://git.yoctoproject.org/meta-raspberrypi

6. From your work dir run source source/poky/oe-init-build-env ./build-rpi

7. Add these layers to build

   bitbake-layers add-layer ../source/meta-openembedded/meta-oe
   bitbake-layers add-layer ../source/meta-openembedded/meta-python
   bitbake-layers add-layer ../source/meta-openembedded/meta-multimedia
   bitbake-layers add-layer ../source/meta-openembedded/meta-networking
   bitbake-layers add-layer ../source/meta-raspberrypi
   bitbake-layers add-layer ../source/meta-thunder-framework

8. Add your target to <build-dir>/conf/local.conf

   # define you machine accordingly 
   MACHINE = "raspberrypi3-64"
   
   # set download location up so we can reuse sources for other builds  
   DL_DIR = "${TOPDIR}/../downloads"
   

9. Check you config

   bitbake-layers show-layers
   bitbake core-image-thunder -n

10. If you get: ERROR: PermissionError: [Errno 1] Operation not permitted

    sudo apparmor_parser -R /etc/apparmor.d/unprivileged_userns

11. Download packages bitbake core-image-thunder --runonly=fetch

12. Run bitbake core-image-thunder to build the image

13. Flash image file

    The raw disk image is core-image-thunder-raspberrypi3-64.wic.bz2 and located in tmp/deploy/images/raspberrypi3-64/.

    Using Etcher you can write the wic.bz image directly to a SD-card.

    Another way is using dd

    1. Extract the WIC file:

       cd tmp/deploy/images/raspberrypi3-64
       bzip2 -d -f core-image-thunder-raspberrypi3-64.wic.bz2

    2. Dump image to the SD Card at /dev/sdd

       sudo dd bs=4M if=core-image-thunder-raspberrypi3-64.wic of=/dev/sdd status=progress conv=fsync 

Documentation

For detailed documentation, including advanced configuration options and usage examples, please refer to the official Thunder documentation

Issues and Contributions

If you encounter issues or have suggestions for improvements, please open an issue on the GitHub issue tracker. Contributions, such as bug fixes or new features, are always welcome. Please review our contribution guidelines before submitting a pull request.

License

This project is licensed under the MIT License. Please review the LICENSE file for more details.