Difference between revisions of "ROM-5721 user guide"

Revision as of 07:29, 11 January 2022

資源特性(Features)

• NXP i.MX 8M Mini processor with up to 4 Arm Cortex A53 cores
• 1 x Arm Cortex-M4 core
• Onboard LPDDR4 memory and eMMC
• 1 x 4 lane MIPI-CSI,1 x Dual channel LVDS or 1 x Display Port
• 4 x USB2.0, 1 x USB 2.0 OTG, 4 x UART, 4 x I2C, 12 x GPIO, 1 x PCIe2.0, 1x Gigabit LAN
• Support OpenGL ES 2.0/1.1 by hardware accelerators
• Low power consumption design
• Support Linux and Android BSP

訂購資訊(Ordering Information)

接口布局和尺寸(Layout and Sizes)

  ROM-5721 接口布局圖 Board Dimension Layout 

  ROM-DB5901 接口布局圖 Board Dimension Layout

  主板内置插针式引脚排序方式 (Pin Header defination) 

  Internal I/O

  Rear I/O 

  接口引脚定義 (Pin definitions)

• 電池(BAT1) & 電池扣(BH1)
• CAN(CAN1,CAN2)
• 串口(COM_DB(COM3)、COM1、UART0 、UART2)
• 显示接口(LVDS、LVDS Backlight、HDMI、DP)
• LAN接口(LAN)
• USB接口(USB1-2、USB-4-5、USB Type C、USB OTG)
• 音频接口(Audio Output &Audio Codec)
• 电源及指示灯和开关机复位按钮(Power 、LED、Power Button、Reset Button、Sleep Button) 
• GPIO接口
• MINI_PCIE接口_M.2接口_SPI、I2C_接口

  机械尺寸  (Mechanical Characteristics)

ROM-5721 

快速入门 (Quick Start)

  系统下载 (OS Download)

• Linux系统 (Linux OS)

​Yocto 2.5: IoTGateway/BSP/Linux/iMX8/OS Support List - ESS-WIKI (advantech.com.tw)

Yocto 3.0:IoTGateway/BSP/Linux/iMX8/OS Support List 3.0

  Linux 燒錄方法 (Linux Flash eMMC Method)

使用Flash tool 燒錄鏡像到eMMC (Flash image into eMMC by Flash Tools) 

Step0: 檢查SD卡在Linux 環境的代號 (check SD card symbol in Linux system) 

Step1: 創造一張可開機的SD 卡 (Create a bootable SD card)

Step2: 將可開機的SD 卡插入底板SD卡卡槽(Plug the SD card into Carrier board 's SD card slot)

Step4: 確認開機選擇指撥開關 (Check the boot switch)

           SD 卡開機模式(SD boot mode):

Step3:打開電源 和 終端機 (Turn on the Power & Terminal)

Step4: 解壓縮flash tools 檔案,並複製到U盤中(Unzip the flash tools file , then copy to USB Disk) 

    解壓縮(Unzip the file ) 

複製檔案到U盤中 (Copy the flash file to USB Disk) 

  1. 插入U盤到你的Ubuntu 電腦上 (Plug the USB Disk into you Linux PC

  2. 檢視U盤在Ubuntu 系統代號 (Check the USB Disk's symbol in Ubuntu System) 

 3. 掛載U盤在Ubuntu 系統中 (Mount the USB Disk's in Ubuntu System) 

4. 複製檔案到U盤(Copy the file to USB disk)

5. 將U盤連接到ROM-5721系統, 進入flash tool下的mk_inand資料夾, 執行指令./mksd-linux.sh /dev/mmcblk2燒錄image到eMMC (Connect USB Disk to ROM-5721 system, browser to mk_inand folder and execute flash shell script "./mksd-linux.sh /dev/mmcblk2"

6. 切換開機switch 1:on 2,3,4,5,6:off來設定成從eMMC開機(Change boot switch to "1:on 2,3,4,5,6:off" to boot from eMMC. Reboot system).

  Debug 串口調試 (Debug port Setting)

以 Tera Term  为例介绍如何使用串口调试功能

   Baud Rate波特率：115200
   Data 数据位：8
   Parity 奇偶校验：无
   Stop 停止位：1
   Flow Control流控：无

Tera Term Tool 

Check the Sriel port in Device Manager (查看PC端的串口号)：

if you can not identify the Serial device , please check your serial driver. 

Debug port connection (串口連接) 

Log into Terminal  Tool (进入串口调试终端)：

Linux系统的基本使用(Linux System Basic Operating Method)

  UUU 使用方法(USB Connection (OTG port))

Download uuu tool from (Release [ADVv20200619 · ADVANTECH-Corp/uuu · GitHub]) or in the folder.

The “imx-boot-imx8mmrom5721a1-sd.bin-flash_evk” file be included in 5721A1AIM20LIV90XXX_iMX8MM_misc.tgz. XXX is the version.

Connect USB cable to USB OTG port.

Change boot switch to "4:on 1,2,3,5,6:off" to boot from force recovery mode.

Type command below to flash eMMC:

  Display Setting (ROM-5721)

      U-boot Command :

                          setenv fdt_file xxxx.dtb
                          env save
                          boot

     U-boot load fefault setting:

                          env default -a
                          env save
                          reset

• Display: Default support g070vw01 LVDS panel on LVDS0
  • DSI to LVDS
    • g070vw01(LVDS0)
      • adv-imx8mm-rom5721-a1.dtb
    • g150xgel05(LVDS0)
      • adv-imx8mm-rom5721-a1-dsi2lvds-g150xgel05.dtb
    • g215hvn01(LVDS0+LVDS1,dual channel)
      • adv-imx8mm-rom5721-a1-dsi2lvds-g215hvn01.dtb
  • DSI to DP
    • adv-imx8mm-rom5721-a1-dsi2dp.dtb
  • DSI to HDMI(LVDS0)
    • adv-imx8mm-rom5721-a1-adv7535.dtb
  • DSI
    • auog101uan02(LVDS0)
      • adv-imx8mm-rom5721-a1-auog101uan02.dtb
• M.2 SDIO
  • Adjust CN43~CN48
  • adv-imx8mm-rom5721-a1-m2-sdio.dtb
• M.2 I2S
  • adv-imx8mm-rom5721-a1-m2-i2s.dtb

  乙太網路使用方法(Ethernent Testing Method)

Command : ifconfig 

Command: Ping - I eth1 8.8.8.8  or Ping - I eth0 8.8.8.8  

  WiFi使用方法(WIFI Testing Method)

Command : 

# killall wpa_supplicant
# ifconfig wlan0 up
# iwlist mlan0 scan
WEP:
# iwconfig mlan0 txpower auto essid "SSID" channel 4
# udhcpc -i mlan0

WPA/WPA2:
# wpa_passphrase "SSID" > wpa.conf
Type password
# wpa_supplicant -B -Dwext -imlan0 -c/home/root/wpa.conf
# udhcpc -i mlan0

ping 8.8.8.8
PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
64 bytes from 8.8.8.8: icmp_seq=1 ttl=54 time=2.10 ms
64 bytes from 8.8.8.8: icmp_seq=2 ttl=54 time=2.10 ms

  GPIO使用方法(GPIO Operating Method)

Loop-back Test (Take GPIO0 and GPIO2 as examples)  

Step 1: Connect GPIO0 and GPIO2
Step 2: Export GPIO interface

root@imx8mmrom5721a1: ~# echo 496 > /sys/class/gpio/export
root@imx8mmrom5721a1: ~# echo 497 > /sys/class/gpio/export

Step 3: Set direction

root@imx8mmrom5721a1: ~# echo out > /sys/class/gpio/gpio1/direction
root@imx8mmrom5721a1: ~# echo in > /sys/class/gpio/gpio2/direction

Step 4: Read value and set output value then check

root@imx8mmrom5721a1: ~# cat /sys/class/gpio/gpio2/value
0
root@imx8mmrom5721a1: ~# echo 1 > /sys/class/gpio/gpio1/value
root@imx8mmrom5721a1: ~# cat /sys/class/gpio/gpio2/value
1

  串口使用方法(Serial Port Operating Method)

RS-232 Test

CN15上(SER0/UART3): /dev/ttymxc2

CN15 下(SER2/UART1): /dev/ttymxc0

COM 3 (A53 debug/SER3/UART2): /dev/ttymxc1

COM 1 (M4 debug/SER1/UART4): /dev/ttymxc3

SW7 Setting (SW7設置) 

MODE1  MODE0
    0            0            LOOPBACK
    0            1            RS232
    1            0            RS485
    1            1            RS422

Loopback test (eg. ttymxc0)
Connect loopback test tool

1. stty ‐F /dev/ttymxc0 115200
   # stty ‐F /dev/ttymxc0 ‐echo
   # cat /dev/ttymxc0 &
   # echo test > /dev/ttymxc0

  蓝牙使用方法(BlueTooth Operating Method)

Command : 

$ hciconfig hci0 up
$ bluetoothctl
$ discoverable on
$ pairable on
$ scan on
[NEW] FC:18:3C:8D:75:F4 myphone
$ scan off
$ pair FC:18:3C:8D:75:F4
$ connect FC:18:3C:8D:75:F4

  遠程訪問及文件傳輸(Remote Access and File Transimmion)

              查看主板IP位址 ( Chech IP Address )：​

        Command : ifconfig

Windows下SSH访问及文件传输

SSH Remote Log into Device 

• SSH远程登录,以putty选择putty.exe(或者使用Xshell、SecureCRT等类似软件)
• 需要设置远程设备的IP、通讯端口(默认22)、通讯方式，登录后验证用户名密码

通用方法(General Method)

  查看CPU温度(Check CPU Temperature)

    root@imx8mmrom5721a1:/# cat /sys/devices/virtual/thermal/thermal_zone0/temp 44600

    # 或者直接以度爲單位顯示 echo $[$(cat /sys/class/thermal/thermal_zone0/temp)/1000]° >>> 45°

  查看CPU频率(Check CPU Frequency)

           cat /sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_cur_freq 
           >> 900000
           cat /sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_max_freq    
           >> 1200000

  查看内存容量(Check Memory Capacity)

root@imx8mmrom5721a1:/# busybox free -m
             total       used       free     shared    buffers     cached
Mem:       1794920     516080    1278840      17252      9852        80292
-/+ buffers/cache:     425936    1368984
Swap:            0          0          0

  查看存储容量(Check Storage Capacity)

root@imx8mmrom5721a1:/# busybox df -h
Filesystem                Size      Used Available Use% Mounted on
/dev/root                13.4G      1.7G     11.1G  13% /
devtmpfs                395.8M      4.0K    395.8M   0% /dev
tmpfs                   876.4M         0    876.4M   0% /dev/shm
tmpfs                   876.4M     16.5M    859.9M   2% /run
tmpfs                   876.4M         0    876.4M   0% /sys/fs/cgroup
tmpfs                   876.4M      4.0K    876.4M   0% /tmp
tmpfs                   876.4M    280.0K    876.2M   0% /var/volatile
/dev/mmcblk0p2           13.6G      1.7G     11.3G  13% /run/media/mmcblk0p2
/dev/mmcblk0p1           63.9M     23.4M     40.5M  37% /run/media/mmcblk0p1
/dev/mmcblk1p1           63.9M     23.4M     40.5M  37% /run/media/mmcblk1p1
tmpfs                   175.3M     88.0K    175.2M   0% /run/user/0
root@imx8qxprom5620a1:/#

  網路Ping測試(Ping Network Testing)

     ping 8.8.8.8
     PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
     64 bytes from 8.8.8.8: icmp_seq=1 ttl=54 time=2.10 ms
     64 bytes from 8.8.8.8: icmp_seq=2 ttl=54 time=2.10 ms

  設置RTC (RTC Setting) 

     root@imx8mmrom5721a1:/# systemctl stop ntpdate.service
     root@imx8mmrom5721a1:/# date 090816072021 && hwclock -w && date
             Wed Sep  8 16:07:00 UTC 2021
             Wed Sep  8 16:07:00 UTC 2021
     root@imx8mmrom5721a1:/# date
             Wed Sep  8 16:07:06 UTC 2021
     root@imx8mmrom5721a1:/#'''

Linux BSP編譯方法(Linux BSP Compile Method)

  Yocto 2.5

  Yocto 3.0

• 如果有驗證上的錯誤 請使用以下的方法

### repo sync failed with Server certificate verification failed. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none ERROR: gstreamer1.0-1.14.4.imx-r0 do_unpack: Fetcher failure: Fetch command export PSEUDO_DISABLED=1; export PATH="/hom e/adv/adv-release-bsp/build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot-native/usr/bin/py thon3-native:/home/adv/adv-release-bsp/sources/poky/scripts:/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-poky-l inux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot-native/usr/bin/aarch64-poky-linux:/home/adv/adv-release-bsp/build_x11/tm p/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot/usr/bin/crossscripts:/home/adv/adv-release-bsp/buil d_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot-native/usr/sbin:/home/adv/adv-release-bsp/b uild_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot-native/usr/bin:/home/adv/adv-release-bsp /build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot-native/sbin:/home/adv/adv-release-bsp/ build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/recipe-sysroot-native/bin:/home/adv/adv-release-bsp/so urces/poky/bitbake/bin:/home/adv/adv-release-bsp/build_x11/tmp/hosttools"; export HOME="/home/adv"; git -c core.fsyncob jectfiles=0 submodule update --init --recursive failed with exit code 1, output:

Submodule 'common' (

https://anongit.freedesktop.org/git/gstreamer/common.git) registered for path 'common'

Cloning into '/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/git/common'...

fatal: unable to access '

https://anongit.freedesktop.org/git/gstreamer/common.git/': server certificate verification fa iled. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none

fatal: clone of '

https://anongit.freedesktop.org/git/gstreamer/common.git' into submodule path '/home/adv/adv-release-b sp/build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/git/common' failed

Failed to clone 'common'. Retry scheduled

Cloning into '/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/git/common'...

fatal: unable to access '

https://anongit.freedesktop.org/git/gstreamer/common.git/': server certificate verification fa iled. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none

fatal: clone of '

https://anongit.freedesktop.org/git/gstreamer/common.git' into submodule path '/home/adv/adv-release-b sp/build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14.4.imx-r0/git/common' failed

Failed to clone 'common' a second time, aborting

ERROR: gstreamer1.0-1.14.4.imx-r0 do_unpack: Function failed: base_do_unpack

ERROR: Logfile of failure stored in: /home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-poky-linux/gstreamer1.0/1.14. 4.imx-r0/temp/log.do_unpack.42631

ERROR: Task (/home/adv/adv-release-bsp/sources/meta-fsl-bsp-release/imx/meta-bsp/recipes-multimedia/gstreamer/gstreamer 1.0_1.14.imx.bb:do_unpack) failed with exit code '1'

ERROR: gstreamer1.0-plugins-base-1.14.4.imx-r0 do_unpack: Fetcher failure: Fetch command export PSEUDO_DISABLED=1; expo rt PATH="/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/ recipe-sysroot-native/usr/bin/python3-native:/home/adv/adv-release-bsp/sources/poky/scripts:/home/adv/adv-release-bsp/b uild_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/recipe-sysroot-native/usr/bin/aarch6 4-poky-linux:/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx -r0/recipe-sysroot/usr/bin/crossscripts:/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer 1.0-plugins-base/1.14.4.imx-r0/recipe-sysroot-native/usr/sbin:/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8m m-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/recipe-sysroot-native/usr/bin:/home/adv/adv-release-bsp/build_x11/ tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/recipe-sysroot-native/sbin:/home/adv/adv-rele ase-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/recipe-sysroot-native/bin:/ home/adv/adv-release-bsp/sources/poky/bitbake/bin:/home/adv/adv-release-bsp/build_x11/tmp/hosttools"; export HOME="/hom e/adv"; git -c core.fsyncobjectfiles=0 submodule update --init --recursive failed with exit code 1, output:

Submodule 'common' (

https://anongit.freedesktop.org/git/gstreamer/common.git) registered for path 'common'

Cloning into '/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.im x-r0/git/common'...

fatal: unable to access '

https://anongit.freedesktop.org/git/gstreamer/common.git/': server certificate verification fa iled. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none

fatal: clone of '

https://anongit.freedesktop.org/git/gstreamer/common.git' into submodule path '/home/adv/adv-release-b sp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/git/common' failed

Failed to clone 'common'. Retry scheduled

Cloning into '/home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.im x-r0/git/common'...

fatal: unable to access '

https://anongit.freedesktop.org/git/gstreamer/common.git/': server certificate verification fa iled. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none

fatal: clone of '

https://anongit.freedesktop.org/git/gstreamer/common.git' into submodule path '/home/adv/adv-release-b sp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0-plugins-base/1.14.4.imx-r0/git/common' failed

Failed to clone 'common' a second time, aborting

ERROR: gstreamer1.0-plugins-base-1.14.4.imx-r0 do_unpack: Function failed: base_do_unpack

ERROR: Logfile of failure stored in: /home/adv/adv-release-bsp/build_x11/tmp/work/aarch64-mx8mm-poky-linux/gstreamer1.0 -plugins-base/1.14.4.imx-r0/temp/log.do_unpack.51633

ERROR: Task (/home/adv/adv-release-bsp/sources/meta-fsl-bsp-release/imx/meta-bsp/recipes-multimedia/gstreamer/gstreamer 1.0-plugins-base_1.14.imx.bb:do_unpack) failed with exit code '1'

============================================================
export GIT_SSL_NO_VERIFY=1
#or
git config --global http.sslverify false
============================================================

• Build error with git protocal:

ERROR: ExpansionError during parsing /home/adv/adv-release-bsp/sources/meta-advantech/meta-tools/recipes-utils/mdio-tool/mdio-tool_1.0.bb

fatal: remote error:
  The unauthenticated git protocol on port 9418 is no longer supported.
Please see https://github.blog/2021-09-01-improving-git-protocol-security-github/ for more information.

Modify: "/home/adv/adv-release-bsp/sources/meta-advantech/meta-tools/recipes-utils/mdio-tool/mdio-tool_1.0.bb" file to

SRC_URI = "git://github.com/PieVo/mdio-tool.git;protocol=https;branch=master"