Embedded module TQMa6x - PTXdist Linux BSP documentation
Using PTXdist to create the BSP firmware
Getting help
- The manual is your friend. See Downloads where to get it.
- See the README in your BSP root folder
PTXdist 2018.05.0 Build System for Embedded Linux Systems ptxdist <action [args]> [options] Setup and Project Actions: menu enter main control menu setup setup per-user preferences boardsetup setup per-board preferences projects show available projects clone <from> <to> create a new project, cloned from <from>. nconfig menuconfig configure the project's filesystem menuconfig kernel kernelconfig configure the kernel menuconfig platform platformconfig configure the platform menuconfig collection configure the collection ...
To configure the system (e.g. add additional packages) you can start the 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.
Configure and Build the BSP
First of all you need to choose for which platform you want to build and which userland configuration should be used.
The commands in the following sections have to be executed within the BSP root directory.
Configuration
The BSP provides helper scripts for automatic configuration according to the following table:
Platform | Configuration | Command |
---|---|---|
MBa6x | linux/mainline ¦ systemd init ¦ Qt5 | tools/config-mba6x |
linux/mainline ¦ busybox init | tools/config-mba6x.tiny |
Example:
$ tools/config-mba6x
This will effectively do
- check for the configured ptxdist version
- create a symlink to the configured ptxdist version (
./p
→/usr/local/bin/ptxdist-<version>
) - call
./p platform configs/platform-tq-tqma6x[-fsl]/mba6x/platformconfig
- call
./p select configs/<ptxconfig>
For manual configuration please refer to ./p –help
and use the platformconfig
and ptxconfig.*
files listed in the table above.
Example:
$ ptxdist platform configs/platform-tq-tqma6x/mba6x/platformconfig $ ptxdist select configs/platform-tq-tqma6x/ptxconfig.qt5
Build
Finally, to build the BSP and create the image files simply execute
$ ./p images
or (in case of a manual configuration)
$ ptxdist images
Older BSP Revisions
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.
- run
$ ptxdist get