diff --git a/wiki/linux/raspberry_pi.md b/wiki/linux/raspberry_pi.md new file mode 100644 index 0000000..5c77f8d --- /dev/null +++ b/wiki/linux/raspberry_pi.md @@ -0,0 +1,58 @@ +# Raspberry Pi + +A [Rapberry Pi](https://www.raspberrypi.com) is a single board comuter. + +## Hardware Additions + +There are various hardware additions which can be used with the Raspberry Pi. +This section addresses them. + +### AI HAT+ + +The [AI HAT](https://www.raspberrypi.com/documentation/accessories/ai-hat-plus.html) is an +extension which uses the Hailo AI module for use with the [Raspberry Pi +5](https://www.raspberrypi.com/products/raspberry-pi-5). + +#### AI HAT+ Usage + +This section addresses the usage of the +[AI HAT](https://www.raspberrypi.com/documentation/accessories/ai-hat-plus.html). + +#### Preparing TensorFlow Models for the AI HAT+ + +For neural networks to run on the Hailo AI module and the AI HAT+ they have to be converted to the +`.hef` format. +This section assumes the neural network is using +[TensorFlow](/wiki/programming_language/python.md#tensorflow) and is available as a `.tf` or +`.tflite` file. + +To convert TensorFlow models first the Hailo 8 Software Suite needs to be downloaded. +This can be done from the [official website](https://hailo.ai/developer-zone/software-downloads/) +altough an account is used to be able to download the software. + +After downloading, extracting and then navigating into the folder a heavily customized +[Docker](/wiki/docker.md) container can be started by running the following command. +However it is recommended to slightly modify this file. +Add a volume that contains the TensorFlow model, that is to be converted, to the environment +variable `DOCKER_ARGS` which is set in the file `hailo_ai_sw_suite_docker_run.sh`. + +```sh +./hailo_ai_sw_suite_docker_run.sh +``` + +Using the tools which come in this container a `.tf` or `.tflite` model can be converted to the +`.hef` format. + +For this to work run the following commands inside the Docker container. +The first command takes the path to the tensorflow model (``) and will output a +`.har` model. +The second command is optional but recommended and takes the path to this `.har` model +(` +hailo optimize --use-random-calib-set +hailo compiler +```