Embedded module TQMa6x - PTXdist Linux BSP documentation

This page refers to the BSP and ancillary tools listed in the following table:

Show details for previous revisions of the BSP

rankdir=BT
node [shape=box style=filled]

subgraph FSL {
  node [fillcolor="#E66A08" fontcolor="#FFFFFF"]
  "imx6q.dtsi";
  "imx6dl.dtsi";
  "imx6qdl.dtsi";
}

subgraph TQM {
  node [fillcolor="#1D8EC6" fontcolor="#FFFFFF"]
  "imx6qdl-tqma6x.dtsi";
  "imx6q-tqma6q.dtsi";
  "imx6dl-tqma6s.dtsi";
}

subgraph MB {
  node [fillcolor="#8F8F8F" fontcolor="#FFFFFF"]
  "imx6qdl-mba6x.dtsi";
  "imx6q-mba6x.dts" [shape=oval color="#FF0000"];
  "imx6dl-mba6x.dts" [shape=oval color="#FF0000"];
}

{rank=same; 6; "imx6q.dtsi"; "imx6dl.dtsi"}
{rank=same; 5; "imx6qdl-tqma6x.dtsi"}
{rank=same; 4; "imx6q-tqma6q.dtsi"; "imx6dl-tqma6s.dtsi"}
{rank=same; 3; "imx6qdl-mba6x.dtsi"}
{rank=same; 2; "imx6q-mba6x.dts"; "imx6dl-mba6x.dts"}
{rank=same; 1; "imx6q-mba6x-hdmi.dts"; "imx6dl-mba6x-hdmi.dts" }

{"imx6q.dtsi" "imx6dl.dtsi"} -> "imx6qdl.dtsi";

"imx6q-tqma6q.dtsi" -> {"imx6qdl-tqma6x.dtsi" "imx6q.dtsi"};
"imx6dl-tqma6s.dtsi" -> {"imx6qdl-tqma6x.dtsi" "imx6dl.dtsi"};

"imx6q-mba6x.dts" -> {"imx6qdl-mba6x.dtsi" "imx6q-tqma6q.dtsi"};
"imx6dl-mba6x.dts" -> {"imx6qdl-mba6x.dtsi" "imx6dl-tqma6s.dtsi"};

"imx6q-mba6x-hdmi.dts" -> "imx6q-mba6x.dts";
"imx6dl-mba6x-hdmi.dts" -> "imx6dl-mba6x.dts";

rankdir=BT
node [shape=box style=filled]

subgraph FSL {
  node [fillcolor="#E66A08" fontcolor="#FFFFFF"]
  "imx6q.dtsi";
  "imx6dl.dtsi";
  "imx6qdl.dtsi";
}

subgraph TQM {
  node [fillcolor="#1D8EC6" fontcolor="#FFFFFF"]
  "imx6qdl-tqma6.dtsi";
  "imx6q-tqma6<a|b>.dtsi";
  "imx6dl-tqma6<a|b>.dtsi";
  "imx6qdl-tqma6<a|b>.dtsi";
}

subgraph MB {
  node [fillcolor="#8F8F8F" fontcolor="#FFFFFF"]
  ordering=out;
  "imx6qdl-mba6.dtsi";
  subgraph MBq {
  rankdir=LR;
  "imx6q-mba6.dtsi";
  "imx6q-mba6<a|b>.dts" [shape=oval color="#FF0000"];
  }
  "imx6qdl-mba6<a|b>.dtsi";
  subgraph MBdl {    
  "imx6dl-mba6<a|b>.dts" [shape=oval color="#FF0000"];
  "imx6dl-mba6.dtsi";
  }
}

{rank=same; 8; "imx6q.dtsi"; "imx6dl.dtsi"}
{rank=same; 7; "imx6qdl-tqma6.dtsi"}
{rank=same; 6; "imx6q-tqma6<a|b>.dtsi"; "imx6dl-tqma6<a|b>.dtsi"}
{rank=same; 5; "imx6qdl-tqma6<a|b>.dtsi"}
{rank=same; 4; "imx6qdl-mba6.dtsi"}
{rank=same; 3; "imx6q-mba6.dtsi"; "imx6q-mba6<a|b>.dts"; "imx6dl-mba6<a|b>.dts"; "imx6dl-mba6.dtsi"}
{rank=same; 2; "imx6qdl-mba6<a|b>.dtsi" }

{"imx6q.dtsi" "imx6dl.dtsi"} -> "imx6qdl.dtsi";

"imx6q-tqma6<a|b>.dtsi" -> {"imx6qdl-tqma6.dtsi" "imx6qdl-tqma6<a|b>.dtsi" "imx6q.dtsi"};
"imx6dl-tqma6<a|b>.dtsi" -> {"imx6qdl-tqma6.dtsi" "imx6qdl-tqma6<a|b>.dtsi" "imx6dl.dtsi"};

"imx6q-mba6<a|b>.dts" -> {"imx6q-tqma6<a|b>.dtsi" "imx6qdl-mba6<a|b>.dtsi" "imx6qdl-mba6.dtsi" "imx6q-mba6.dtsi"};
"imx6dl-mba6<a|b>.dts" -> {"imx6dl-tqma6<a|b>.dtsi" "imx6qdl-mba6<a|b>.dtsi" "imx6qdl-mba6.dtsi" "imx6dl-mba6.dtsi"};

The BSP is available as a project ready to use with the PTXdist¹⁾ build system. As PTXdist runs on linux, first of all you need a development workstation (or a virtual machine) with a (preferably) recent Linux distribution installed. The distribution of your choice, however, may not have installed all required packages by default. Commonly missing packages (package names taken from Debian based systems) include:

Although not required by PTXdist, we also recommend to configure and run a tftp server (for image download / update) and an nfs server (for network mounted rootfs) on your development host.

Make sure the development host meets the prerequisites and download the required PTXdist tarball(s) (see Downloads page for URLs).

Extract the tarball ptxdist-2019.09.1.tar.bz2 and install as follows:

$ tar xvf ptxdist-2019.09.1.tar.bz2
$ cd ptxdist-2019.09.1
$ ./configure
$ make
$ sudo make install

This will install PTXdist to /usr/local/lib by default.

After installing PTXdist it can be configured by:

$ ptxdist setup 

 .config - PTXdist 2020.01.0
 ──────────────────────────────────────────────────────────────────────────────
  ┌─────────────────────────── PTXdist 2020.01.0 ───────────────────────────┐
  │  Arrow keys navigate the menu.  <Enter> selects submenus --->.          │  
  │  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes, │  
  │  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help, </> │  
  │  for Search.  Legend: [*] built-in  [ ] excluded  <M> module  < >       │  
  │ ┌─────────────────────────────────────────────────────────────────────┐ │  
  │ │    --- PTXDIST Setup Menu                                           │ │  
  │ │        User                --->                                     │ │  
  │ │        Proxies             --->                                     │ │  
  │ │        Project Searchpath  --->                                     │ │  
  │ │        Source Directories  --->                                     │ │  
  │ │        Source Download     --->                                     │ │  
  │ │        IPKG Repository     --->                                     │ │  
  │ │        Java SDK            --->                                     │ │  
  │ │        Developer Options   --->                                     │ │  
  │ │                                                                     │ │  
  │ └─────────────────────────────────────────────────────────────────────┘ │  
  ├─────────────────────────────────────────────────────────────────────────┤  
  │        <Select>    < Exit >    < Help >    < Save >    < Load >         │  
  └─────────────────────────────────────────────────────────────────────────┘  

To personalise your PTXdist installation, please fill out:

• User (username and mail address)

Depending on your environment, the most important settings are:

• Proxies (ftp / http / hhtps proxies)
• Source Directories (path for archive of downloaded source packages (aka local package pool))

For further details on setup options, please see the PTXdist manual.

See download page for links to toolchain download. If using precompiled toolchain install 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>.

Follow chapter “Building a toolchain” in the PTXdist manual and keep in mind:

• When you are asked to run the command

  $ ptxdist select ptxconfigs/...

  select this ptxconfig: ptxconfigs/arm-v7a-linux-gnueabihf_gcc-<version>_glibc-<version>_binutils-<version>_kernel-<version>-sanitized.ptxconfig (for TQMa6x)

• To build the toolchain project you should install the corresponding PTXdist version for the Toolchain (as told in the documentation).

Extract the tarball ptxdist-2020.01.0.tar.bz2 and install as follows:

$ tar xvf ptxdist-2020.01.0.tar.bz2
$ cd ptxdist-2020.01.0
$ ./configure
$ make
$ sudo make install

Afterwards you can configure PTXdist

Extract the package TQ-TQMa6x-BSP.REV0120.zip to any directory (e.g. /opt or /home):

$ cd ~/home/workspace
$ tar -xvf TQMa6x.BSP.SW.SRC.0120.tar.gz
$ cd TQMa6x.BSP.SW.SRC.0120