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/customfolder21.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