Skip to main content

Yocto Linux BSP User Guide

Introduction​

本文件說明 Advantech i.MX8 系列在 Yocto 4.0 (kirkstone) 的 BSP 使用方式與常見作業流程。

Getting Started

Building Yocto Image — System Requirements​

  • CPU：建議 4 核以上
  • 記憶體：8 GB RAM（更多更佳）
  • 磁碟：350 GB 以上（建議 SSD）

Conventions​

  • ${PREBUILT_IMAGE}：預先編好的壓縮映像（*.img.gz）

  • ${CONTAINER_NAME}：Docker container 名稱（例如：imx8LBVC0016）

  • ${BSP_TARBALL}：BSP 壓縮檔（*.tgz）

  • ${BSP_HOME}：BSP 根目錄

  • ${BDIR}：build 目錄（例如：build_x11）

  • ${MX8PROC}：i.MX8 型號

    • mx8mq（i.MX8M Quad / Dual Core）、mx8mm（i.MX8MM）、mx8mp（i.MX8MP）、
      mx8qm（i.MX8QM）、mx8qxp（i.MX8QXP）、mx8ulp（i.MX8ULP）

  • ${IMX8PROC}：i.MX8 處理器字首
    imx8mq / imx8mm / imx8qm / imx8qxp / imx8mp / imx8ulp

  • ${BOARD}：可用目標板
    rom5720 rom5721 rom7720 rom5620 rom3620 rom5722 rsb3720 rom2620 epcr5710

  • ${BOARD_REV}：板子版本，例如 a1

  • ${MC}：machine code，通常由 `${IMX8PROC}${BOARD}${BOARD_REV}` 組成
    例如：imx8mqrom5720a1、imx8qmrom7720a1、imx8qxprom5620a1、imx8mmrom5721a1、
    imx8mprom5722a1、imx8mprsb3720a1、imx8ulprom2620a1、imx8mpepcr5710a1。
    也可用下列指令檢視支援機種：

    source setup-environment

  • ${MEM_SIZE}：記憶體大小（2G / 4G）

  • ${UC}：U-Boot 設定（1G / 2G / 4G / FSPI_1G / FSPI_2G ...）

  • ${SD_DEVICE}：Linux 下 SD 裝置（例如：/dev/sdf）

  • ${SDCARD_IMAGE}：bitbake 產生的 sdcard 映像（*.wic.bz2）

  • ${WORKSPACE}：宿主機 workspace 路徑

  • ${UBOOT}：U-Boot 版本（例如：v2022.04_5.15.52_2.1.0）

  • ${KERNEL}：Linux kernel 版本（例如：5.15.52_2.1.0）

  • ${TOOLCHAIN}：SDK 工具鏈安裝目錄（例如：/opt/fsl-imx-wayland/5-15-kirkstone/environment）

  • Serial console：115200 8N1（minicom / PuTTY / TeraTerm）

  • Terminal console：gnome-terminal / xfce4-terminal …

Docker — Install & Setup​

若系統尚未安裝 Docker，請先依官方文件安裝 Docker Engine。

拉取 Ubuntu 20.04 映像​

docker pull advrisc/u20.04-imx8lbv1

建立 Container​

docker run --privileged -it   --name ${CONTAINER_NAME}   -v ${WORKSPACE}:/home/adv/adv-release-bsp   -v /dev:/dev   advrisc/u20.04-imx8lbv1 /bin/bash