COM iMX6ULL Bootloader U-Boot: Difference between revisions

From Wiki-DB
Jump to navigationJump to search
No edit summary
 
(23 intermediate revisions by the same user not shown)
Line 1: Line 1:
== FAQ ==
== FAQ ==
:'''Q: U-Boot doesn't start anymore?'''
:'''Q: U-Boot doesn't start anymore?'''
:'''A:''' See [[UBoot_recovery_for_imx6_via_JTAG#uBoot_Programing| U-Boot recovery]]'''
:'''A:''' See [[U-Boot_recovery_for_i.MX6_Q/D/DL/S/ULL_via_JTAG|U-Boot recovery for i.MX6_Q/D/DL/S/ULL via JTAG]]'''
:'''Q: Initialization of MAC address in the bootloader?'''
:'''Q: Initialization of MAC address in the bootloader?'''
:'''A:''' At the first start, the bootloader reads the MAC address from EEPROM, write it to eFuses and creates env variable ethaddr. The env variable ethaddr could be changed during lifetime to any other MAC address. If you like to get back the original MAC address, please remove ethaddr, save environment and restart the system. In addition to that the env variable ethaddr would be initialized again with eeprom MAC addresss.
:'''A:''' At the first start, the bootloader reads the MAC addresses from the EEPROMs and create env variables ethaddr and eth1addr. The env variables ethaddr and eth1addr could be changed during lifetime to any other MAC addresses. If you like to get back the original MAC addresses, please remove ethaddr and/or eth1addr, save environment and restart the system. In addition to that the env variables ethaddr and/or eth1addr would be initialized again with eeprom MAC addresses.


:'''Q: The automatic update is not executed before the operating system boots!'''
:'''Q: The automatic update is not executed before the operating system boots!'''
:'''A:''' Check if the command <code> update auto </code> is included in the bootloader environment variable <code>bootcmd</code> or in a script-variable which is called within <code> bootcmd </code> before <code> bootm </code>.  
:'''A:''' Check if the command <code> update auto</code> is included in the bootloader environment variable <code>bootcmd</code> or in a script-variable which is called within <code> bootcmd </code> before<code> bootm</code>.  


:'''Q: The automatic update does not work with my desired update-media!'''
:'''Q: The automatic update does not work with my desired update-media!'''
:'''A:''' The command <code> update auto </code> can be configured with flags within the DHCOM settings.bin block. It is possible to disable a interface for the update mechanism. You can run a update from a disabled interface if you use the command <code> update </code> without the argument <code> auto </code>.
:'''A:''' The command <code> update auto</code> can be configured with flags within the DHCOM settings.bin block. It is possible to disable a interface for the update mechanism. You can run a update from a disabled interface if you use the command <code> update</code> without the argument <code> auto</code>.


== Downloads ==
== Downloads ==
Please have a look at the[[COM_iMX6ULL-D2#Download binaries/images| i.MX6ULL Download binaries/images]] section.
Please have a look at the[[DHCOM iMX6ULL-D2#Download binaries/images| i.MX6ULL Download binaries/images]] section.


== Enter Bootloader Console ==
== Enter Bootloader Console ==
:#Connect DHCOM UART1 (FF UART) via null modem cable to the RS232 Port of your PC
:#Connect DHCOM UART1 via null modem cable to the RS232 Port of your PC
:#Start terminal program (e.g. Tera Term) on the Host PC with the following settings:
:#Start terminal program (e.g. [https://www.heise.de/download/product/tera-term-51776 Tera Term]) on the Host PC with the following settings:
:#:Baud rate: 115200
:#:Baud rate: 115200
:#:Data: 8 bit
:#:Data: 8 bit
Line 22: Line 22:
:#:Stop bits: 1 bit
:#:Stop bits: 1 bit
:#:Flow control: none
:#:Flow control: none
:#Press "del" on the Host PC during Core Module system start to enter bootloader console
:#Press "DEL" on the Host PC during Core Module system start to enter bootloader console


== U-Boot recovery ==
== U-Boot recovery ==
See [[UBoot_recovery_for_imx6_via_JTAG#uBoot_Programing| U-Boot recovery]]
See [[U-Boot_recovery_for_i.MX6_Q/D/DL/S/ULL_via_JTAG|U-Boot recovery for i.MX6_Q/D/DL/S/ULL via JTAG]]


==U-boot console commands==
==U-boot console commands==
Line 140: Line 140:


  device nand0 <gpmi-nand>, # parts = 1
  device nand0 <gpmi-nand>, # parts = 1
#: name                size            offset          mask_flags
  #: name                size            offset          mask_flags
0: gpmi-nand          0x20000000     0x00000000      0
  0: main-nand          0x10000000     0x00000000      0
  active partition: nand0,0 - (gpmi-nand) 0x20000000 @ 0x00000000
  active partition: nand0,0 - (main-nand) 0x10000000 @ 0x00000000
 


:'''Set or show active partition'''
:'''Set or show active partition'''
Line 150: Line 151:
|}
|}


:Example: <code>ubi part gpmi-nand</code>
:Example: <code>ubi part main-nand</code>
 
:Description: Show or set current partition. In i.MX6ULL default case this is shold always set to main-nand.
 
:'''Show ubi layout information'''
 
:{| class="wikitable"
|''<code>ubi info layout</code>''
|}
 
:Example: <code>ubi info layout</code>


:Description: Show or set current partition. In i.MX6 default case this is shold always set to gpmi-nand.
:Description: Display ubi layout information.


:'''Mount UBI volume'''
:'''Mount UBI volume'''
Line 162: Line 173:
:Example: <code>ubifsmount ubi0:boot</code>
:Example: <code>ubifsmount ubi0:boot</code>


:Description: Mount UBIFS volume. The default name of the first i.MX6 volume is "boot".
:Description: Mount UBIFS volume. The default name of the first i.MX6ULL volume is "boot".


:'''List files'''
:'''List files'''
Line 202: Line 213:
|}
|}


:Example: <code>mmc dev 0</code>
:Example: <code>mmc dev 1</code>


:Description: Switch between SD/MMC Slots: 0 --> SD/MMC Slot, 1 --> MicroSD Slot, 2 --> eMMC Flash
:Description: Switch between SD/MMC Slots: 1 => MicroSD Slot | 2 => eMMC (0 => SD/MMC Slot is not available on i.MX6ULL)
:Note eMMC flash partition number: 0 --> User partition, 1 --> Boot partition 1, 2 --> Boot partition 2
:Note eMMC hardware partition number: 0 => User partition | 1 => first boot partition | 2 => second boot partition


:'''Initialize SD/MMC Card'''
:'''Initialize SD/MMC Card'''
Line 250: Line 261:
:Description: Read 512kByte (device block size is 512Byte) from the eMMC offset 10MByte.
:Description: Read 512kByte (device block size is 512Byte) from the eMMC offset 10MByte.


=== FAT - EXT2 - EXT4 - Filesystem ===
=== Filesystem ===


:'''NOTE: All EXT2 commands must also be used for ext4'''
:'''NOTE: File system types are recognized automatically'''
 
:'''Show Filesystem information'''
 
:{| class="wikitable"
|''<code>fatinfo <interface> <device></code>''
|}
 
:Example: <code>fatinfo mmc 1</code>
 
Interface: MMC
  Device 1: Vendor: Man 094150 Snr 266e068c Rev: 1.0 Prod: AF UD
            Type: Removable Hard Disk
            Capacity: 121.2 MB = 0.1 GB (248320 x 512)
  Partition 1: Filesystem: FAT16 "NO NAME    "


:'''List files'''
:'''List files'''


:{| class="wikitable"
:{| class="wikitable"
|''<code>fatls <interface> <device> <directory></code>''
|''<code>ls <interface> <device[:partition]> <directory></code>''
|}
|}


:{| class="wikitable"
:Example 1: <code>ls mmc 1</code>
|''<code>ext2ls <interface> <device> <directory></code>''
|}


:Example 1: <code>fatls mmc 1</code>
:Example 2: <code>ls mmc 1 /folder</code>


:Example 2: <code>fatls mmc 1 /folder</code>
:'''Load Files from device to SDRAM'''
 
:'''Load Files from SD Card to SDRAM'''
 
:{| class="wikitable"
|''<code>fatload <interface> <device> <SDRAM address> <directory+filename></code>''
|}


:{| class="wikitable"
:{| class="wikitable"
|''<code>ext2load <interface> <device> <SDRAM address> <directory+filename></code>''
|''<code>load <interface> <device[:partition]> <SDRAM address> <directory+filename></code>''
|}
|}


:Example 1: <code>fatload mmc 1 10100000 nk.gz</code>
:Example 1: <code>load mmc 1 10100000 nk.gz</code>


:Example 2: <code>fatload mmc 1 10100000 /folder/nk.gz</code>
:Example 2: <code>load mmc 1 10100000 /folder/nk.gz</code>


=== Ethernet ===
=== Ethernet ===
Line 329: Line 318:


:Example: <code>ping 192.168.55.32</code>
:Example: <code>ping 192.168.55.32</code>
:'''Read PHY register via MII interface'''
:{| class="wikitable"
|''<code>mii dump <PHY address> <PHY register></code>''
|}
:Example: <code>mii dump 0 0</code>
:Remark: The standard MII registers 0-5 are supported by this command. When you are working with a DHCOM i.MX6 module only PHY address "0" is allowed.


=== Unzip ===
=== Unzip ===
Line 395: Line 374:
|}
|}


=== Show DHCOM Settings ===
=== I2C ===
:'''Set current I2C bus'''


:{| class="wikitable"  
:{| class="wikitable"
|''<code> settings </code>''
|''<code>i2c dev <I2C bus></code>''
|}
|}


:Example:  
:Example: <code>i2c dev 0</code>
  VALIDATION_ID:    "DH"
 
  DISPLAY_ID:      0x00
:Description: Set current I2C bus to 0.
  LENGTH:          0x2c
  X_RESOLUTION:    800 pixel
  Y_RESOLUTION:    480 pixel
  PIXEL_CLOCK:      22200 kHz
  LCD_CONFIG_FLAGS: 0x3e3
  HSW:              64 pixel clocks
  VSW:              2 line clocks
  HFP:              42 pixel clocks
  HBP:              86 pixel clocks
  VFP:              10 line clocks
  VBP:              33 line clocks
  DATALINES:        16
  ACB:             0
  ACBI:             0
  GPIO_DIR:        0x01ff
  GPIO_STATE:      0x0000
  HW_CONFIG_FLAGS:  0x001e


=== I2C ===
Valid buses on i.MX6ULL:
0 = DHCOM I2C port 1
1 = DHCOM I2C port 2


:'''List available devices'''
:'''List available devices'''
Line 430: Line 395:
|}
|}


Valid devices:
:Description: Test for and show device(s) on the I2C bus.
0 = DHCOM I2C port 1
 
1 = DHCOM I2C port 2
  Valid chip addresses: 32 50 51 52 53 58 59
  2 = i.MX6 OnBoard I2C port


:'''Read'''
:'''Read'''
Line 459: Line 423:
:'''Show ENV variables'''
:'''Show ENV variables'''


:{| class="wikitable"
:{| class="wikitable" style="float:left; margin-right:1em"
|-
|''<code>env print</code>''
|''<code>env print</code>''
|}
{| style="float:left; margin-right:1em; margin-top:1em"
|-
|or
|}
{| class="wikitable" style="float:left; margin-right:1em"
|-
|''<code>printenv</code>''
|}
|}


  bootdelay=0
  bootdelay=0
Line 475: Line 451:
:'''Set ENV variables'''
:'''Set ENV variables'''


:{| class="wikitable"
:{| class="wikitable" style="float:left; margin-right:1em"
|-
|''<code>env set <ENV name> <ENV value></code>''
|''<code>env set <ENV name> <ENV value></code>''
|}
|}
{| style="float:left; margin-right:1em; margin-top:1em"
|-
|or
|}
{| class="wikitable" style="float:left; margin-right:1em"
|-
|''<code>setenv <ENV name> <ENV value></code>''
|}
:Example: <code>env set ipaddr 192.168.55.2</code>
:Example: <code>env set ipaddr 192.168.55.2</code>


:Note: If you need to edit "bootcmd" it is necessary to insert ";" between the unique commands. You can enter ";" at the command line with "\;".
:Note: If you need to edit "bootcmd" it is necessary to insert <code>;</code> between the unique commands. Put the whole sequence in quotation marks <code>'...'</code>.


:'''Save ENV variables'''
:'''Save ENV variables'''


:{| class="wikitable"
:{| class="wikitable" style="float:left; margin-right:1em"
|-
|''<code>env save</code>''
|''<code>env save</code>''
|}
{| style="float:left; margin-right:1em; margin-top:1em"
|-
|or
|}
{| class="wikitable" style="float:left; margin-right:1em"
|-
|''<code>saveenv</code>''
|}
|}


:'''Delete ENV variable'''
:'''Delete ENV variable'''
Line 494: Line 495:
|}
|}


:'''Revert to default ENV'''
:'''Revert to default ENV (all)'''


:{| class="wikitable"
:{| class="wikitable"
|''<code>env default -a</code>''
|''<code>env default -a</code>''
|}
:'''Revert to default ENV (almost everything: preserve DH serial numbers and ethernet MAC addresses)'''
:{| class="wikitable"
|''<code>env default -ae</code>''
|}
|}


Line 507: Line 514:


:Example:  
:Example:  
: <code>fatload mmc 0 0x10000000 uEnv.txt</code>
: <code>load mmc 0 0x10000000 uLinuxEnv.txt</code>
: <code>env import -t 0x10000000 $filesize</code>
: <code>env import -t 0x10000000 $filesize</code>


:Important:
:Important:
:The uEnv.txt file should be in unix format. Also make sure that there is an empty line at the end of the file.
:The uLinuxEnv.txt file should have unix line ending. Also make sure that there is an empty line at the end of the file.


bootargs=console=ttyO0,115200n8 root=/dev/mmcblk0p2 mem=128M rootwait
=== USB Mass Storage ===
bootcmd=mmc rescan; fatload mmc 0 0x82000000 uImage; bootm 0x82000000
:'''Use device as USB Mass Storage'''
uenvcmd=boot


==How to do Updates==
:{| class="wikitable"
[[DHCOM Update Mechanism |How to do Updates]]
|''<code>ums <USB_controller> <devtype> <dev[:part]></code>''
|}


== Display and Hardware settings ==
:'''Example: Write an image on PDK2 to the eMMC using the "ums" command:'''
=== DHCOM settings and Splash bitmap ===
:1. Connect the USB OTG on the PDK2 with a suitable cable to a computer running Debian Linux
:The DHCOM settings are used to setup display and special hardware parameters. For detailed description please have a look at [[DHCOM Settings|'''How to create a settings.bin file''']].
:2. Go to the U-Boot console on the module
:The DHCOM settings file and the splash bitmap are loaded via the env variables "'''load_settings_bin'''" and "'''load_splash'''" during startup from boot partition. The default content of these env variables is:
:3. Start UMS by typing:
settings_bin_file=default_settings.bin
:{| class="wikitable"
splash_file=splash.bmp
|''<code>ums 0 mmc 2</code>''
load_settings_bin=load mmc ${mmcdev}:${mmcpart} ${loadaddr} ${settings_bin_file}
|}
load_splash=load mmc ${mmcdev}:${mmcpart} ${loadaddr} ${splash_file}
:4. Eject partitions that may appear
:5. Double klick on the image (*.img.xz file)
:6. Select a destination drive
:7. Press "Start Restoring..."
:8. Stop UMS in U-Boot by pressing CTRL+C


:'''Note:''' The DHCOM display settings can also be stored in external eeprom (address 0x50 / 7bit I2C address) which is connected to DHCOM I2C1 port. If eeprom is available and DISP_ADPT_EEPRM flag is set to 1, the settings from eeprom override the settings from boot partition!
==How to do Updates==
:Next you can see the settings load order:
[[DHCOM Update Mechanism|DHCOM Update Mechanism]]
:[[Image:DISP_ADPT_EE_check.png|700px]]
 
=== Displaying a splash screen with u-boot ===
'''Notes:'''
* This is possible with u-boot version '''v1.0.0.6 or newer'''.
* Only RGB interface and LVDS (only first channel) is supported.
* If you use lvds panel on vendor '''Kernel 3.10.17''' the linux patch <code>“imx6 clk: Init LDB (lvds) parent clock“</code> (19.Jan 2016) is needed, because otherwise the display isn’t working properly in linux.<br/>(https://github.com/dh-electronics/linux-imx6-vendor/commit/6f7cabb4d7504c4d1cfe244d460f9891d5a0e411 )
'''The process to set it up is the following:'''
* Configure your display parameters with DHCOM settings generator ([[DHCOM Settings|'''How to create a settings.bin file''']])<br/>Here you can see an LVDS display example:<br/>[[Image:DHCOM_display_settings_description.png|1000px]]
* Generate settings bin file with settings generator.
* Copy settings bin file to boot partition on boot media (eMMC, NAND or microSD card).
* Generate your splash bitmap (bitmap with 8 bit color depth).
* Copy also bmp file to boot partition.
* Start core module and enter u-boot console.
* Delete env variable “<code>panel</code>”: <code>env delete panel</code>
* Set env variable “<code>settings_bin_file</code>” with settings bin filename:<br/>Example: <code>env set settings_bin_file 10_LG_7inch_LB070WV8.bin</code>
* Set env variable “<code>splash_file</code>” with bitmap filename:<br/>Example: <code>env set splash_file 800x480_splash_DHCOM_iMX6.bmp</code>
* Save u-boot environment to flash: <code>saveenv</code>
* Restart the system --> Splash bitmap should now be displayed from the bootloader.
 
=== Generated Linux boot args for the display by u-boot ===
* U-boot is generating Linux boot args from the display settings file:
[[Image:DHCM_Display_Parameter.jpg|1700px|DHCOM Display Parameter]]
 
=== Display disabled by default ===
:With default u-boot configuration u-boot '''doesn't''' initialize the Display interface. This feature can be activated by deleting the "'''panel'''" environment variable. But also with deactivated display interface, the bootlaoder reads the display settings and pass the settings to the linux kernel.
panel="no_panel": Display interface is deactiveted in u-boot and backlight is powered off.
panel="RGB": Default DH 4,3" display is selected.
panel=deleted: u-boot initialize display by DH settings file.
 
=== Backlight enable GPIO ===
: If ENV variable "panel" is set to "no_panel" the backlight enable GPIO (defined via DHCOM settings file or eeprom settings) will be disabled from the bootloader during startup.
: If ENV variable "panel" is deleted, the backlight enable GPIO is activated or deactivated in relation to BL_ON flag of DHCOM settings file. 
: Note: Supported by U-Boot DH VERSION v0.4.2.5 or higher for iMX6


== Building U-Boot  ==
== Building U-Boot  ==
=== Prepare Build Environment ===
=== Prepare Build Environment ===
* Download and start the Virtual Machine based on Debian 8 (see [[COM_iMX6-D2#Downloads| i.MX6 Downloads]])
{| class="wikitable" style="width: 100%; color: #000000; background: #ffffff;" |
* Install Denx ELDK 5.4 to /opt (Available at [ftp://ftp.denx.de/pub/eldk/5.4/iso/ ftp://ftp.denx.de/pub/eldk/5.4/iso/]: we use eldk-5.4-armv7a.iso)
|
1. Download and start the [[Virtual Machine for Application Development]]
|}
 
=== Get Sources ===
=== Get Sources ===
{| class="wikitable" style="width: 100%; color: #000000; background: #ffffff;" |
{| class="wikitable" style="width: 100%; color: #000000; background: #ffffff;" |
|  
|  
1. Start a terminal on Linux<br/>
2. Start a terminal on Linux<br/>
2. <tt># ''git clone [https://github.com/dh-electronics/u-boot-imx6qdl.git https://github.com/dh-electronics/u-boot-imx6qdl.git]''</tt><br/>
3. <tt># ''git clone [https://github.com/dh-electronics/u-boot-imx6qdl.git https://github.com/dh-electronics/u-boot-imx6qdl.git]''</tt><br/>
3. <tt># ''cd u-boot-imx6qdl''</tt><br/>
4. <tt># ''cd u-boot-imx6qdl''</tt><br/>
4. <tt># ''git checkout release/v1.0.0.6'' # checkout latest/required branch or tag</tt>
5. <tt># ''git checkout dev/2018.05_dhcom''</tt>
|}
|}
=== Start Build===
=== Start Build===
{| class="wikitable" style="width: 100%; color: #000000; background: #ffffff;" |
{| class="wikitable" style="width: 100%; color: #000000; background: #ffffff;" |
|  
|  
6. <tt># ''./uboot_make [q_d dl s s_1g]''</tt> # add argument 'dl' to build for Duallite (if unsure contact DH electronics)<br/>
6. <tt># ''make ARCH=arm CROSS_COMPILE=/opt/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- dh_imx6ull_emmc_defconfig''</tt><br/>
7. <tt># ''make ARCH=arm CROSS_COMPILE=/opt/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- all''</tt>
|}
|}
* Your new <tt>u-boot.imx</tt> file is available in <tt>u-boot-imx6qdl/</tt>
Your new <tt>u-boot-with-spl.imx</tt> file is available in <tt>u-boot-imx6qdl/</tt>
* If your build does fail please check content of uboot_make and adjust PATH.
'''''Attention: Risk of bricking the Device!!'''''

Latest revision as of 07:11, 11 May 2020

FAQ

Q: U-Boot doesn't start anymore?
A: See U-Boot recovery for i.MX6_Q/D/DL/S/ULL via JTAG
Q: Initialization of MAC address in the bootloader?
A: At the first start, the bootloader reads the MAC addresses from the EEPROMs and create env variables ethaddr and eth1addr. The env variables ethaddr and eth1addr could be changed during lifetime to any other MAC addresses. If you like to get back the original MAC addresses, please remove ethaddr and/or eth1addr, save environment and restart the system. In addition to that the env variables ethaddr and/or eth1addr would be initialized again with eeprom MAC addresses.
Q: The automatic update is not executed before the operating system boots!
A: Check if the command update auto is included in the bootloader environment variable bootcmd or in a script-variable which is called within bootcmd before bootm.
Q: The automatic update does not work with my desired update-media!
A: The command update auto can be configured with flags within the DHCOM settings.bin block. It is possible to disable a interface for the update mechanism. You can run a update from a disabled interface if you use the command update without the argument auto.

Downloads

Please have a look at the i.MX6ULL Download binaries/images section.

Enter Bootloader Console

  1. Connect DHCOM UART1 via null modem cable to the RS232 Port of your PC
  2. Start terminal program (e.g. Tera Term) on the Host PC with the following settings:
    Baud rate: 115200
    Data: 8 bit
    Parity: none
    Stop bits: 1 bit
    Flow control: none
  3. Press "DEL" on the Host PC during Core Module system start to enter bootloader console

U-Boot recovery

See U-Boot recovery for i.MX6_Q/D/DL/S/ULL via JTAG

U-boot console commands

SPI Flash

SPI Flash Init
sf probe
Example: sf probe
Description: Initializes the OnBoard SPI Flash
SPI Flash Read
sf read <SDRAM address> <SPI Flash address> <Bytes>
Example: sf read 10000000 0 100
Description: Copies 256Bytes from SPI Flash address 0x0 to SDRAM address 0x1000_0000
SPI Flash Write
sf write <SDRAM address> <SPI Flash address> <Bytes>
Example: sf write 10000000 40000 10000
Description: Copies 64kByte from SDRAM address 0x1000_0000 to SPI Flash address 0x4_0000
SPI Flash Erase
sf erase <SPI Flash address> <Bytes>
Example: sf erase 100000 1000
Description: Deletes SPI Flash content from address 0x10_0000 to 0x10_0FFF
Note: The Bytes information needs to be sector size aligned!

NAND-Flash

Read from NAND-Flash Device
nand read <SDRAM address> <NAND Flash address> <Bytes>
Example: nand read 80000000 400000 b40000
Description: Copies 11,25MByte from NAND Flash address 0x40_0000 to SDRAM address 0x8000_0000
Erase NAND-Flash blocks
nand erase <Block base address> <Bytes>
Example: nand erase 400000 40000
Description: Deletes NAND Flash content from address 0x40_0000 to 0x43_FFFF
Note: The Bytes information needs to be block size aligned!
Write to NAND-Flash Device
nand write <SDRAM address> <NAND-Flash address> <Bytes>
Example: nand write 80000000 400000 b40000
Description: Copies 11,25MByte from SDRAM address 0x8000_0000 to NAND Flash address 0x40_0000
Note: The Bytes information needs to be page size aligned!
Show bad NAND-Flash blocks
nand bad
Description: Shows the bad NAND-Flash blocks.
Show NAND-Flash content
nand dump <NAND-Flash address>
Example: nand dump 400000
Description: Shows the content of the specified NAND-Flash block

UBI Filesystem

Partition Definition
mtdparts
Example: mtdparts
Description: Shows the current nand flash partitions. In case of i.MX6 one default partition set, which includes the entire flash. For linux that partition is used to create two volumes "boot" and "rootfs".
Note: In case of UBIFS it is better to have one big partition with different volumes instead of many small partitions, because the wear leveling process is always applied to every partition.
device nand0 <gpmi-nand>, # parts = 1
 #: name                size            offset          mask_flags
 0: main-nand           0x10000000      0x00000000      0
active partition: nand0,0 - (main-nand) 0x10000000 @ 0x00000000


Set or show active partition
ubi part <partition name>
Example: ubi part main-nand
Description: Show or set current partition. In i.MX6ULL default case this is shold always set to main-nand.
Show ubi layout information
ubi info layout
Example: ubi info layout
Description: Display ubi layout information.
Mount UBI volume
ubifsmount <UBI device>:<volume name>
Example: ubifsmount ubi0:boot
Description: Mount UBIFS volume. The default name of the first i.MX6ULL volume is "boot".
List files
ubifsls <directory>
Example 1: ubifsls
Description: List files in a UBIFS directory.
Load Files from UBI volume
ubifsload <SDRAM address> <directory+filename>
Example 1: ubifsload 10100000 zimage
Description: Load file from an UBIFS filesystem to memory.
Unmount UBI volume
ubifsumount
Example: ubifsumount
Description: Unmount current volume.

SD/MMC Card

Switch between MicroSD, SD Slot and eMMC
mmc dev <Slot number> <Partition number>
Example: mmc dev 1
Description: Switch between SD/MMC Slots: 1 => MicroSD Slot | 2 => eMMC (0 => SD/MMC Slot is not available on i.MX6ULL)
Note eMMC hardware partition number: 0 => User partition | 1 => first boot partition | 2 => second boot partition
Initialize SD/MMC Card
mmc rescan
Description: Initialize new inserted SD Card
Show SD/MMC information
mmcinfo
Description: Shows SD/MMC device information
Device: FSL_SDHC
Manufacturer ID: 45
OEM: 100
Name: SEM08
Tran Speed: 52000000
Rd Block Len: 512
MMC version 4.41
High Capacity: Yes
Capacity: 7.3 GiB
Bus Width: 8-bit
Write to MicroSD, SD Slot and eMMC
mmc write <SDRAM address> <block number> <block count>
Example: mmc write 11000000 5000 400
Description: Write 512kByte (device block size is 512Byte) to the eMMC offset 10MByte.
Read from MicroSD, SD Slot and eMMC
mmc read <SDRAM address> <block number> <block count>
Example: mmc read 11000000 5000 400
Description: Read 512kByte (device block size is 512Byte) from the eMMC offset 10MByte.

Filesystem

NOTE: File system types are recognized automatically
List files
ls <interface> <device[:partition]> <directory>
Example 1: ls mmc 1
Example 2: ls mmc 1 /folder
Load Files from device to SDRAM
load <interface> <device[:partition]> <SDRAM address> <directory+filename>
Example 1: load mmc 1 10100000 nk.gz
Example 2: load mmc 1 10100000 /folder/nk.gz

Ethernet

Load File via TFTP to SDRAM
tftp <SDRAM address> <directory+filename>
Example: tftp 80100000 nk.gz
Example TFTP Server: "Winagents TFTP Server Manager"
Note: For TFTP download it is necessary to config the ENV variables "ipaddr" and "serverip"
Load File via TFTP to SDRAM using DHCP
dhcp <SDRAM address> <directory+filename>
Example: dhcp 80100000 nk.gz
Example TFTP Server: "Winagents TFTP Server Manager"
Note: It is necessary to config the ENV variable "serverip" with the ip-address of your TFTP-Server
Ping
ping <IP address>
Example: ping 192.168.55.32

Unzip

unzip <source address> <destination address>
Example: unzip 12900000 10100000
Note: The unzip command is supporting the gzip file format.

Bitmap

Information
bmp info <Bitmap address>
Image size    : 800 x 480
Bits per pixel: 8
Compression   : 0
Display
bmp display <Bitmap SDRAM address> [x y]
Note: It is necessary to load bitmap file to memory address with an offset of an odd multiple of +2, since the use of a four-byte alignment will cause alignment exceptions at run-time.

Memory

Display
md[.b, .w, .l] <address> [count]
Example: md.b 80100000 100
Write
mw[.b, .w, .l] <address> <value> [count]
Example: mw.b 80100000 aa 100
Description: Writes the value 0xaa to the next 0x100 bytes from the address 0x8010_0000.
Copy
cp[.b, .w, .l] <source> <destination> <count>

I2C

Set current I2C bus
i2c dev <I2C bus>
Example: i2c dev 0
Description: Set current I2C bus to 0.
Valid buses on i.MX6ULL:
0 = DHCOM I2C port 1
1 = DHCOM I2C port 2
List available devices
i2c probe
Description: Test for and show device(s) on the I2C bus.
Valid chip addresses: 32 50 51 52 53 58 59
Read
i2c md <I2C address> <start address> <end address>
Example: i2c md 57 10 20
Description: Reads 16 Bytes from the address 0x10 to address 0x20.
Write
i2c mw <I2C address> <I2C register> <Value> <Bytes>
Example: i2c mw 57 0 aa 5
Description: Writes 0xaa to 5 Bytes from the offset 0.

Environment

Show ENV variables
env print
or
printenv



bootdelay=0
baudrate=38400
ipaddr=192.168.55.230
serverip=192.168.55.36
gatewayip=192.168.55.36
netmask=255.255.255.0
frias=5
...
Environment size: 449/262140 bytes
Set ENV variables
env set <ENV name> <ENV value>
or
setenv <ENV name> <ENV value>



Example: env set ipaddr 192.168.55.2
Note: If you need to edit "bootcmd" it is necessary to insert ; between the unique commands. Put the whole sequence in quotation marks '...'.
Save ENV variables
env save
or
saveenv



Delete ENV variable
env delete <ENV name>
Revert to default ENV (all)
env default -a
Revert to default ENV (almost everything: preserve DH serial numbers and ethernet MAC addresses)
env default -ae
Import ENV from textfile
env import -t <SDRAM address> $filesize
Example:
load mmc 0 0x10000000 uLinuxEnv.txt
env import -t 0x10000000 $filesize
Important:
The uLinuxEnv.txt file should have unix line ending. Also make sure that there is an empty line at the end of the file.

USB Mass Storage

Use device as USB Mass Storage
ums <USB_controller> <devtype> <dev[:part]>
Example: Write an image on PDK2 to the eMMC using the "ums" command:
1. Connect the USB OTG on the PDK2 with a suitable cable to a computer running Debian Linux
2. Go to the U-Boot console on the module
3. Start UMS by typing:
ums 0 mmc 2
4. Eject partitions that may appear
5. Double klick on the image (*.img.xz file)
6. Select a destination drive
7. Press "Start Restoring..."
8. Stop UMS in U-Boot by pressing CTRL+C

How to do Updates

DHCOM Update Mechanism

Building U-Boot

Prepare Build Environment

1. Download and start the Virtual Machine for Application Development

Get Sources

2. Start a terminal on Linux
3. # git clone https://github.com/dh-electronics/u-boot-imx6qdl.git
4. # cd u-boot-imx6qdl
5. # git checkout dev/2018.05_dhcom

Start Build

6. # make ARCH=arm CROSS_COMPILE=/opt/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- dh_imx6ull_emmc_defconfig
7. # make ARCH=arm CROSS_COMPILE=/opt/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- all

Your new u-boot-with-spl.imx file is available in u-boot-imx6qdl/