diff --git a/docs/docs/frigate/installation.md b/docs/docs/frigate/installation.md index 70b4b5bc1..8bd8c6875 100644 --- a/docs/docs/frigate/installation.md +++ b/docs/docs/frigate/installation.md @@ -112,42 +112,47 @@ The Hailo-8 and Hailo-8L AI accelerators are available in both M.2 and HAT form :::warning -The Raspberry Pi kernel includes an older version of the Hailo driver that is incompatible with Frigate. You **must** follow the installation steps below to install the correct driver version, and you **must** disable the built-in kernel driver as described in step 1. +On Raspberry Pi OS **Bookworm**, the kernel includes an older version of the Hailo driver that is incompatible with Frigate. You **must** follow the installation steps below to install the correct driver version, and you **must** disable the built-in kernel driver as described in step 1. + +On Raspberry Pi OS **Trixie**, the Hailo driver is no longer shipped with the kernel. It is installed via DKMS, and the conflict described below does not apply. You can simply run the installation script. ::: -1. **Disable the built-in Hailo driver (Raspberry Pi only)**: +1. **Disable the built-in Hailo driver (Raspberry Pi Bookworm OS only)**: :::note - If you are **not** using a Raspberry Pi, skip this step and proceed directly to step 2. + If you are **not** using a Raspberry Pi with **Bookworm OS**, skip this step and proceed directly to step 2. + + If you are using Raspberry Pi with **Trixie OS**, also skip this step and proceed directly to step 2. ::: - If you are using a Raspberry Pi, you need to blacklist the built-in kernel Hailo driver to prevent conflicts. First, check if the driver is currently loaded: + First, check if the driver is currently loaded: ```bash lsmod | grep hailo ``` - + If it shows `hailo_pci`, unload it: ```bash - sudo rmmod hailo_pci + sudo modprobe -r hailo_pci ``` - - Now blacklist the driver to prevent it from loading on boot: - + + Then rename the built-in driver so it can be restored later if needed: + ```bash - echo "blacklist hailo_pci" | sudo tee /etc/modprobe.d/blacklist-hailo_pci.conf + sudo mv /lib/modules/$(uname -r)/kernel/drivers/media/pci/hailo/hailo_pci.ko.xz \ + /lib/modules/$(uname -r)/kernel/drivers/media/pci/hailo/hailo_pci.ko.xz.bak ``` - - Update initramfs to ensure the blacklist takes effect: - + + Now refresh the kernel module map so the system recognizes the change: + ```bash - sudo update-initramfs -u + sudo depmod -a ``` - + Reboot your Raspberry Pi: ```bash @@ -160,7 +165,7 @@ The Raspberry Pi kernel includes an older version of the Hailo driver that is in lsmod | grep hailo ``` - This command should return no results. If it still shows `hailo_pci`, the blacklist did not take effect properly and you may need to check for other Hailo packages installed via apt that are loading the driver. + This command should return no results. 2. **Run the installation script**: @@ -212,6 +217,17 @@ The Raspberry Pi kernel includes an older version of the Hailo driver that is in lsmod | grep hailo_pci ``` + Verify the driver version: + + ```bash + modinfo hailo_pci | grep version + ``` + + Verify that the firmware was installed correctly: + + ```bash + ls -l /lib/firmware/hailo/hailo8_fw.bin + #### Setup To set up Frigate, follow the default installation instructions, for example: `ghcr.io/blakeblackshear/frigate:stable`