Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Custom_table_size_100 |
---|
Some of the reference designs from Trenz Electronics include a preconfigured yocto bsp layer that can be used to generate a Linux image and a prebuilt yocto linux image, that can be copied directly to sd card.
Generate image with predefined yocto BSP layerYocto BSP layer. This is a short description of how to use the BSP layer to create a Linux image with the Yocto project for the Board.
Prepare Yocto Project
Scroll Ignore | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
The yocto bsp Yocto BSP layer will be generated with the quartus project in the <project name>/os/yocto/meta-<module> folder. The generated layers depends on the meta-altera layer (for more information see: Yocto KICKstart#Used source files).
- Download a reference design that includes yocto bsp a Yocto BSP layer
- Generate the quartus Quartus project as described in the wiki description of the downloaded reference design or in Project Delivery - Intel devices#Quick Start
- Copy the generated meta-<module> folder from <project name>/os/yocto/meta-<module> to the path/to/yocto/poky/ directory
- Follow the steps from Yocto KICKstart#Create a project for an Intel FPGA device without running the 'bitbake' command
Add the generated bsp BSP layer meta-<machine> to /yocto/poky/build/conf/bblayers.conf with:
Code Block theme Midnight linenumbers true bitbake-layers add-layer ../meta-<module>
Generate linux image
Scroll Ignore | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
There are two options to generate an image with the provided Yocto BSP layer:
- Generate an image with a minimal RAM-based root filesystem, which is bundled inside the kernel image.
- Generate an image with a root filesystem on sd card with its own partition.
For the reference design, the generation of an image with an init RAM filesystem is preferred.
Image with initial RAM filesystem
- Redefine the variable MACHINE with '<module>-<Board-Part-Short-Name>' in path/to//yocto/poky/build/conf/local.conf
- A list with the correct MACHINE names can be found in the wiki description of the reference design: Overview→Requirements→Hardware
e.g. for the board TEI0022-03 see TEI0022 Test Board#Hardware → here the MACHINE name is tei0022-a5-c8-2gb.
run following commands to redefine 'MACHINE':
Code Block theme Midnight linenumbers true sed -i '/^MACHINE/s/MACHINE/#MACHINE/g' conf/local.conf echo -e '\nMACHINE = "<module>-<Board-Part-Short-Name>"' >> conf/local.conf
- A list with the correct MACHINE names can be found in the wiki description of the reference design: Overview→Requirements→Hardware
Define the variables INITRAMFS_IMAGE_BUNDLE and INITRAMFS_IMAGE to create an image with initial RAM filesystem
Code Block theme Midnight linenumbers true echo -e '\nINITRAMFS_IMAGE_BUNDLE = "1"' >> conf/local.conf echo -e 'INITRAMFS_IMAGE = "te-initramfs"' >> conf/local.conf
Build the image with following command (the image recipes are located in meta-<module>/recipes-core/images/):
Code Block theme Midnight linenumbers true bitbake te-image-minimal
Image with root filesystem on SD card
- Redefine the variable MACHINE with '<module>-<Board-Part-Short-Name>' in path/to/yocto/poky/build/conf/local.conf
- A list with the correct MACHINE names can be found in the wiki description of the reference design: Overview→Requirements→Hardware
e.g. for the board TEI0022-03 see TEI0022 Test Board#Hardware → here the MACHINE name is tei0022-a5-c8-2gb.
run following commands to redefine 'MACHINE':
Code Block theme Midnight linenumbers true sed -i '/^MACHINE/s/MACHINE/#MACHINE/g' conf/local.conf echo -e '\nMACHINE = "<module>-<Board-Part-Short-Name>"' >> conf/local.conf
- A list with the correct MACHINE names can be found in the wiki description of the reference design: Overview→Requirements→Hardware
Build the image with following command (the image recipes are located in meta-<module>/recipes-core/images/):
Code Block theme Midnight linenumbers true bitbake <module>te-image-minimal
Copy
image.wic file to SD card
Scroll Ignore | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Yocto generates a full sd card image with .wic file which contains all needed files like u-boot, zImage , rootfs etc. included.The generated image and so on. This file is stored in path/to/yocto/poky/build/tmp/deploy/images/<machine>/<image_name>.wic. If you downloaded a reference design with prebuilt files, you can find a generated yocto linux image in <project name>/prebuilt/Board_Part_Short_Name/os/yocto/images/generate the linux yocto project yourself, using the .wic file is a very simple way to prepare the SD card for booting linux.
Do following steps to copy the image .wic file to the SD card:
- Insert the sd SD card into a sd SD card reader connected to the computer
Run following command to get the device name of the SD card (e.g. /dev/sdx):
Code Block theme Midnight linenumbers true lsblk
Copy the generated *.wic image to the sd SD card (replace 'sdx' in 'of=/dev/sdx' with the correct sd card device name:
Code Block theme Midnight linenumbers true sudo dd if=path/to/yocto_image/poky/build/tmp/deploy/images/<machine>/<image_name>.wic of=/dev/sdx bs=1M seek=0
Insert the SD card into your board, set boot mode to sd card (if the setting is available) and boot it.
Serial Console
Scroll Ignore | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
- Open Serial Console (e.g. PuTTY)
select COM Port
Info Win OS: see device manager
Linux OS: see dmesg | grep tty (UART is *USB1)
- Speed: 115200
- Press reset button on the board
- Linux Console:
Login data:
Info Note: Wait until Linux boot finished
Code Block theme Midnight linenumbers true Username: root Password: root
You can use Linux shell now.
Code Block theme Midnight linenumbers true i2cdetect -y -r 1 (check I2C 1 Bus, if available) dmesg | grep rtc (RTC check, if available) udhcpc (ETH0 check, if available) lsusb (USB check, if available)
Scroll Only | ||
---|---|---|
|
Scroll pdf ignore | ||||||
---|---|---|---|---|---|---|
|