This shows you the differences between two versions of the page.
— |
rpiatsc [2025/05/02 14:04] (current) steve created |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | == Introduction == | ||
+ | This is a description of how to build an RDK hybrid image for the Raspberry Pi 3 Model B/B+ that includes the DTVKit ATSC 1.0 stack and related RDK modules. To use the resulting image a USB ATSC tuner will be needed, along with the appropriate firmware file, as this isn't provided in the RDK repositories. The firmware for many devices can be obtained from [[https:// | ||
+ | |||
+ | == Build Environment == | ||
+ | The build environment is based on a 64-bit Ubuntu 18.04 installation and should be set up as defined for a Yocto 3.1 (Dunfell) release on the [https:// | ||
+ | |||
+ | == Building the image == | ||
+ | You need to be an RDK member to access the build repositories. The image to be built uses the RDK-V **rdkv-2023q1-dunfell** release. RDK releases after this use the Raspberry Pi 4 which haven' | ||
+ | |||
+ | All commands to be run directly are shown in // | ||
+ | |||
+ | - Create a directory for the build, into which the RDK recipes and source files will be downloaded. This will be referred to as < | ||
+ | - //cd < | ||
+ | - Checkout the release to be built, where ' | ||
+ | * //repo init -u %%https:// | ||
+ | * //repo sync %%--no-clone-bundle%%// | ||
+ | - //git clone %%git@github.com: | ||
+ | - //git switch atsc_main// | ||
+ | - //source meta-dtvkit-rpi/ | ||
+ | - Select the " | ||
+ | - //bitbake rdk-generic-hybrid-dtv-image// | ||
+ | |||
+ | == Flashing the image == | ||
+ | When the build has completed, the following steps can be followed to install and run the image on the Pi. It's assumed this is being done from a Linux desktop, so the instructions will be different for other operating systems. | ||
+ | |||
+ | - The image to be flashed will be found in < | ||
+ | - The Pi's SD card needs to be inserted into a card reader on a PC that also has access to the above file. | ||
+ | - If the SD card already contains partitions with valid filesystems then they will probably be mounted, so all partitions need to be unmounted, leaving the card still accessible at the device level. | ||
+ | - Copy the image to the SD card using the following command, ensuring the correct device name is used in place of ' | ||
+ | * //bzcat < | ||
+ | - When the copy is complete, the partitions on the SD card will probably be auto mounted. At this stage the firmware for the USB tuner can be copied to the SD card, or it can be done after the Pi has booted up. The firmware file(s) need to be copied to '/ | ||
+ | - Select the option to eject the SD card from the Linux desktop, insert it into the Pi, connect it to a TV/monitor with an HDMI cable, connect the USB tuner and a USB keyboard, and power on the Pi. | ||
+ | - If the USB tuner firmware wasn't installed above, then it can be done now, either by copying the firmware from a USB drive on the Pi, or by copying it across the network (assuming the Pi is connected to a wired network). Either way, you will need to find the IP address of the Pi by some means, probably from whatever is acting as a DHCP server on the network. | ||
+ | - You can login to the Pi (no password) using ' | ||
+ | * //ssh root@< | ||
+ | - To copy the firmware file(s) over the network (no password), do: | ||
+ | * //scp < | ||
+ | |||
+ | == Running the image == | ||
+ | Occasionally the DTV application doesn' | ||
+ | * //systemctl restart dtvapp// | ||