# AI@EDGE Workshop

Course materials for AI@EDGE workshop.

# Raspberry Pi OS image

This workshop is optimised to run on a Raspberry Pi 400 (opens new window) or any other Raspberry Pi 4 (opens new window) device. Make sure to install the 64-bit Raspberry OS (Buster version from 2021.05.07). The image can be downloaded here (opens new window). Use Raspberry Pi Imager (opens new window), Win32DiskImager (opens new window) or BalenaEtcher (opens new window) to flash the SD card. Change the keyboard layout to your preference, in the workshop case: French (azerty).

# Install software packages

Setup script to install all requirements and dependencies to do the AI@EDGE workshop. Make sure you have an internet connection when doing this!

bash <(curl -sL ai-edge-workshop.netlify.app/setup.sh)

Installing all prerequisites can take a long time

Some parts of the script can take quite a while (installation of setup.py bdist_wheel of h5py, numpy, etc) to install. The setup may take up to 1 to 2 hours to complete, depending on your system.

Possible errors

When running the setup script it is possible that there are some errors and warnings indicated by red text. This is normal due to compatibility issues with the current Raspberry Pi OS. Fortunately we don't need those dependencies for the examples in the workshop and these errors can be ignored.

# Hardware requirements

Necessary hardware to do the workshop:

Raspberry Pi 4 (opens new window) or Raspberry Pi 400 (opens new window) with Screen, Mouse, Keyboard, SD card with the correct OS. Only Raspbian buster 64 bit (opens new window) is supported.
Nucleo-L476RG (opens new window) or any other STM board with programmer (opens new window) and USB cable
STM Sensortile (opens new window) with programming cable, cradle, USB cable
Mounting system to mount the Sensortile to a pen (3D printed holder (opens new window))

Workshop hardware setup

# Project files

All project files can be found in the repository of the AI@EDGE workshop. The files are cloned in the "Documents" directory when running the installation script.

# Getting started

We are getting started with a small example which goes through all the steps from data creation to running your model on a microcontroller in the introduction.

# Issues

Feel free to submit issues and enhancement requests.

# Contributing

Please refer to each project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.

Fork the repo on GitHub
Clone the project to your own machine
Commit changes to your own branch
Push your work back up to your fork
Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

# License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License (opens new window).

(opens new window)