Adding Custom Files

Custom files can be added on top of the basic installation. With this it’s possible to add only a part without corrupting the basic mechanism. Files of these categories can be added separately:

  • U-Boot
  • DTB
  • Linux Kernel
  • RFS
  • Linux Modules
  • Splash Image
  • Environment
  • Windows Image

MfgToolSetup.bat searches for files in dedicated folders. A custom folder exists in every profile separately:

../../../_images/customfolder2.png

Put your files in there and start MfgToolSetup.bat to add them to your cfg.ini. Follow the file name rules below.

Type Filename Match Supported Formats Remarks
U-Boot u-boot .bin  
DTB *.dtb    
Kernel uImage uimage  
Rootfs *.tgz *.bz2 *.tar .tgz .bz2 .tar Filename does not include “modules”””
Modules modules .tgz .bz2  
Splash *.bmp 8-bpp / 24-bppBitmap  
Environment *.env text See below
Windows *.bin *.nb0 NK.bin / NK.nb0 not available in TX6UL profile

Environment settings

Environment settings can be added or overridden by definitions listed in a custom .env file. Put a name and value on each line like this:

append_bootargs=init=/sbin/init
video_mode=VGA
baseboard=ulmb-v1

Note

It doesn’t matter which kind of line breaks are used, MfgToolSetup.bat converts it to LF-only line endings. In addition to this leading and trailing spaces are omitted preventing from a suspect behaviour of U-Boot later.

Change mtdparts - NAND partition layout

With MfgTool version 2016-12 it is also possible to change the rootfs partition size simply by redefining the mtdparts environment variable in a custom .env file. The rootfs UBI filesystem will be initialised accordingly.

The default partition layout looks like this:

device nand0 <gpmi-nand>, # parts = 7
 #: name                size            offset          mask_flags
 0: u-boot              0x00100000      0x00020000      0
 1: env                 0x00060000      0x00120000      0
 2: linux               0x00600000      0x00180000      0
 3: rootfs              0x02000000      0x00780000      0
 4: userfs              0x05780000      0x02780000      0
 5: dtb                 0x00080000      0x07f00000      0
 6: bbt                 0x00080000      0x07f80000      1

This layout is defined by:

mtdparts=mtdparts=gpmi-nand:1024k@0x20000(u-boot),384k(env),6m(linux),32m(rootfs),89600k(userfs),512k@0x7f00000(dtb),512k@0x7f80000(bbt)ro

The total usable space of 122368k is occupied by 32m(rootfs) and 89600k(userfs). Lets as an example increase the rootfs size to 64m and add a logo partition of 1m. In this case the size of the userfs partition has be reduced by 33*1024k => 89600k-33792k=55808k:

mtdparts=mtdparts=gpmi-nand:1024k@0x20000(u-boot),384k(env),6m(linux),64m(rootfs),55808k(userfs),1m(logo.bmp),512k@0x7f00000(dtb),512k@0x7f80000(bbt)ro