Using PTXdist to create the BSP firmware

Getting help

The manual is your friend. See Downloads where to get it.

Configuration

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

$ ptxdist menu

PTXdist menu

To add additional packages to your root filesystem simply use the ptxdist tool. The ncurses based UI is the same that is used by the linux kernel with “make menuconfig”. It can be used the following way:

  • use the up / down arrow keys to navigate in the menu
  • use the left / right arrow keys to navigate between buttons
  • select / deselect packages and options using the SPACE key
  • enter submenus or press buttons using the ENTER key

Dependencies between packages should be “automagically” resolved. Software is organized in sections.

Compilation

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

  • configs/platforms/@mod_name_code@/@mod_name_code@-fsl/platformconfig (@mod_name@ on <label mb_name>MB_NAME> with u-boot 2009.08, kernel 2.6.35 and Freescale patches)
  • configs/platforms/@mod_name_code@/@mod_name_code@/platformconfig ( on @mb_name@ 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 <label mod_name>MOD_NAME>/label>-fsl: 

$ ptxdist platform configs/platforms/@mod_name_code@/<label mod_name_code>MOD_NAME_CODE>-fsl/platformconfig
$ ptxdist select configs/platforms/@mod_name_code@/@mod_name_code@-fsl/ptxconfig
$ ptxdist go
$ ptxdist images

Selecting configs for @mod_name@: 

$ ptxdist platform configs/platforms/@mod_name_code@/@mod_name_code@/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.

Disclaimer
TQ-Systems GmbH provides the Board Support Packages (BSP) free of charge. The software included in the shipment has been configured individually for the starter kits. The software is only intended to evaluate the module. The use of the Board Support Packages (BSP) is only allowed within the scope of functionality described by TQ-Systems GmbH. TQ-Systems GmbH does not accept any liability for all further changes of the Board Support Package and for any damage resulting from its use.