PTXdist

The following applies to

• PTXdist 2012.07 (BSP 0102 / 0106)
• PTXdist 2012.04 (BSP 0100 / 0101)

To install PTXdist you need a Linux OS like Ubuntu. The BSP needs some additional packages which are normally not installed. These packages are:

• autoconf
• bc
• gawk
• dialog
• ncurses-dev
• bison
• flex
• quilt
• texinfo
• gettext
• g++
• libxml-parser-perl
• zip

For development it is also recommended to have a tftp server for image download and update and an nfs server for network mounted rootfs configured and running.

Please make sure you have the following three components downloaded to your development machine. Otherwise see the download section for links.

1. PTXdist 2011.11 (Build System for Toolchain)
2. OSELAS Toolchain 2011.11.3 (Toolchain project)
3. PTXdist 2012.07 (Build System for Linux BSP)
4. TQ ARM BSP REV0106 (Linux BSP)

After installing all packages on the host machine, extract, configure, compile and install the PTXdist sources.
See download page for links.

Extract the package ptxdist-<version>.tar.bz2 to a temporary directory and call in that directory:

$ ./configure
$ make
$ sudo make install

This will install PTXdist to /usr/local/lib by default. Afterwards please setup PTXdist with:

$ ptxdist setup 

The toolchain must be installed only once before the Linux BSP can be compiled for the target. In case of using a precompiled toolchain install it to /opt. Otherwise carefully follow the documentation for building toolchains found here or in the download section.
By default the toolchain will get installed to /opt/OSELAS.Toolchain-<version>.

To build the toolchain follow these commands:

After downloading OSELAS.Toolchain-2011.11.3.tar.bz2:
$ tar xzf OSELAS.Toolchain-2011.11.3.tar.bz2
$ cd OSELAS.Toolchain-2011.11.3/
$ ptxdist-2011.11.0 select/arm-v5te-linux-gnueabi_gcc-4.6.2_glibc-2.14.1_binutils-2.21.1a_kernel-2.6.39-sanitized.ptxconfig (for TQMa28)
$ ptxdist-2011.11.0 go

This process could take a few hours to complete. For any further information or in case you experience problems, refer to the official toolchain documentation. After compilation the Toolchain normally is already setup in the BSP project. So you can move on to the next step.

Extract the package TQ-ARM-BSP-REV<version>.tgz to any directory (e.g. /opt or /home):

$ cd /opt/projekte
$ tar -xvf TQ-ARM-BSP-REV<version>.zip
$ cd TQ-ARM-BSP-REV<version>

This directory now is the build environment for your BSP.

To configure the system (e.g. add additional packages) you can start the PTXdist menu:

$ ptxdist menu

Select one of the supported hardware platforms, select a software configs and start building the image. On TQMa28 the hardware platform names are:

• configs/platforms/tqma28/tqma28-fsl/platformconfig (TQMa28 on MBa28 with u-boot 2009.08, kernel 2.6.35 and Freescale patches)
• configs/platforms/tqma28/tqma28/platformconfig (TQMa28 on MBa28 on a mainline u-boot 2013.04 and kernel 3.10)

Currently the following software configs are available:

• configs/systems/minimal/ptxconfig (minimal rootfs with busybox)
• configs/systems/qt/ptxconfig (rootfs with busybox and qt)

Selecting configs for tqma28-fsl:

$ ptxdist platform configs/platforms/tqma28/tqma28-fsl/platformconfig
$ ptxdist select configs/platforms/tqma28/tqma28-fsl/ptxconfig
$ ptxdist go
$ ptxdist images

Selecting configs for tqma28:

$ ptxdist platform configs/platforms/tqma28/tqma28/platformconfig
$ ptxdist select configs/systems/minimal/ptxconfig
$ ptxdist go
$ ptxdist images

PTXdist downloads some packages. If it reports some errors please

• verify your internet connection or proxy settings.
• make sure the package source is correct. Some package source pages will change from time to time.
  (You can always try to download the source package manually and copy it to your package pool (by default: <BSP project>\src))
• some packages like bootloaders and kernels where you can select versions need to know about their hash sums. You have to calculate them using md5sum and enter the correct hash in the ptxdist configuration.

PTXdist needs a package for every bit you need in your root FS. To add your software, files etc. you have to provide local packages. Follow the instructions of the developers section in the PTXdist manual. PTXdist provides templates as starting point for own packages. Type

$ ptxdist newpackage

to see what package templates exist.

PTXdist uses release tar balls for software it loads from the net. You have to work with patches, if you need to make changes of the source code. Follow the instructions of the developers section in the PTXdist manual (chapter 4 PTXdist Developer's Manual).

-The BSP was developed for the Starterkit.-
To use it in a product with special requirements or a different basebord we suggest to define a custom platform (platformconfig).
It is also recommended to define a custom software config (ptxconfig) using one of the supplied configs as a starting point.

To start make a copy of the platform definition and select the new platform definition

$ cd <BSPROOT>
$ mkdir <BSPROOT>/configs/platforms/tqma28/<your-custom-platform>
$ cp -r <BSPROOT>/configs/platforms/tqma28/tqma28 <BSPROOT>/configs/platforms/tqma28/<your-custom-platform>
$ ptxdist platform <BSPROOT>/configs/platforms/tqma28/<your-custom-platform>/platformconfig

To start configuring your new platform type

$ ptxdist platformconfig

The first thing to change should be the platform name. Adapt things like kernel configuration, image creation etc. to your needs.

The new system will be built under <BSPROOT>/platform-<platformname_from_platformconfig>

To create a new software config based on an existing one, copy and select the new software config:

$ cd <BSPROOT>
$ mkdir <BSPROOT>/configs/systems/<your-custom-platform>
$ cp -r <BSPROOT>/configs/systems/minimal/ptxconfig <BSPROOT>/configs/<your-custom-platform>/ptxconfig
$ ptxdist select platform <BSPROOT>/configs<your-custom-platform>/ptxconfig

To start configuring your new software config

$ ptxdist menuconfig

The following partition scheme is used for SD / eMMC images

• sector size = 512 Byte

The partition scheme is defined for platforms TQMa28/TQMa28L/TQMa28-fsl using the config file
<BSPROOT>/configs/platforms/tqma28/tqma28/config/images/tqma28-hd.config

The creation of the image is controlled using the project local PTXdist package image-hd2. To create the image the genimage host tool is used. This tool is automatically selected and built. You can find the build directory under <BSPROOT>/platform-<tqma28-fsl | tqma28>/build-host/genimage. There is also a README file documenting how to use this tool and the config file.

Finally, you will find the built images in platform-<platformname>/images.

To update bootloader / kernel in a running system you have to copy the images in your tftp directory and download them to the eMMC.

To install a new firmware use SD cards. To copy the built images on the host system to a connected card type:

$ cd <BSP project>/platform-<platform_name>/images
$ sudo dd if=tqma28_hd.img of=/dev/sdf bs=1M conv=fsync #Assuming the SD card is assigned to /dev/sdf

To find out what device file the SD card has, type “dmesg” after you connect the card to see the system messages. At the bottom you'll see some “Attached scsi …” messages along with something like:

[ 8197.588395]  sdf: sdf1

1. When U-Boot on eMMC is not available: set boot mode to SD card: LCD_DATA[4..0] = {0,1,0,1,0}
   (On MBa28, set DIP Switches S4.4 and S5.1 to ON, the others to OFF.)
2. Plug in card, power on device and stop autoboot
3. Type command: run install_firmware
4. Set boot mode back to eMMC

Current U-Boot versions provide a script that copies the MBR and partition contents from the SD card to the eMMC. This script is called via “run install_firmware” command at the U-Boot prompt. Due to memory limitations the root partition must be copied in a loop, each run copies the maximum memory amount available. To tell the script the size of your rootfs partition you have to use the rootblks16 variable.

This variable holds the hexadecimal number of 512-byte blocks your rootfs partition has in size.

setenv rootblks16 0x40000 

This sets a 128MB partition.

1. Boot from eMMC
2. Plug in card, power on device and stop autoboot
3. To update U-Boot type:
   run upd_uboot_sd
4. To update device tree type:
   run upd_fdt_sd
5. To update Kernel type:
   run upd_kernel_sd

1. Boot from eMMC and stop autoboot
2. Connect device via ethernet to a tftp server supplying the image
3. Provide the correct network configuration:
   setenv serverip 0.0.0.0
   setenv netmask 255.255.255.0
   setenv ipaddr 0.0.0.0
4. Provide U-Boot the file name of the desired image on the server:
   For U-Boot: setenv uboot filename
   For device tree: setenv dtb filename
   For Kernel: setenv kernel filename
5. Perform Update:
   For U-Boot: run upd_uboot_net
   For device tree: run upd_fdt_net
   For Kernel: run upd_kernel_net

Starting with REV0106 the TQ-ARM-BSP offers the creation of profiles for Freescale Manufacturing Tool.
Currently these profiles can be created for platforms TQMa28, TQMa28-fsl, TQMa28L, TQMa28L-AA.

This is enabled by default but can be switched using

$ ptxdist platformconfig

in the menu new image creation options –> [ ] Create profile for Freescale MFGTool

The profile is built during images stage and named TQ_ARM_BSP-Update-<platform>.zip in the images/ directory.

To use it simply extract the zip into the Profiles/ subdirectory in the MfgTool folder.
When starting MfgTool you will see the profile appear in the selection box:

In the Options - Configuration menu each profile has the option to flash

• the Boot EEPROM and the complete e-MMC (eMMC+EEPROM) - only for TQMa28 modules REV0200
• the Boot EEPROM only (EEPROM only) - only for TQMa28 modules REV0200
• the complete firmware (eMMC only) (default)
• the device tree only (DTB only)
• the kernel only (Kernel only)
• and for debugging purposes load the U-Boot into RAM (U-Boot→RAM)

1. To download you need the target hardware to be connected via USB0 to the PC running MfgTool.
2. The boot mode must be set to USB recovery mode.
3. Power up.
4. The MfgTool should show a HID-compliant device.
   Otherwise the target is either not connected or not in USB recovery mode.
5. Hit 'Start' and wait until Finished.

To boot the TQMa28 from network you need a working bootloader in eMMC or SD-card which is able to get the kernel image over tftp and to provide the kernel with commandline settigns for NFS. You have to provide the images via tftp and nfs and to configure the bootloader (cf. U-Boot variables boot_nfs, addnfs, kernel, dtb, serverip, rootpath) to work with your tftp-server and your nfs-server.