====== TQMa91xxCA - YOCTO Linux BSP documentation ======
<nav type="tabs" justified="true">
  * [[.:overview|Overview]]
  * [[.:quickstart_yocto|Quickstart BSP]]
  * [[.:deployment_yocto|Deployment]]
  * [[.:target|How-To]]
  * [[.:known-issues|Known Issues]]
</nav>

<nav type="pills" justified="true">
  * [[.:target|Starterkit Interfaces]]
  * [[.:development-host|Development Host]]
  * [[.:build-system|Yocto Build System]]
</nav>

===== Starterkit Interfaces and Functions =====
<callout type="danger">
This page is work in progress and therefore subject to change
</callout>
==== Ethernet ====
<panel type="default" title="Ethernet">
The STKa91xxCA provides two Gigabit Ethernet interfaces. \\
{{:en:arm:tqma91xxca:yocto:mba91_ethernet.jpg?400 |}} \\
\\
\\
\\
\\
\\
<accordion collapsed="true">
<panel title="U-Boot">
In U-Boot eth0 is configured as default interface. The IP configuration can be done statically or by a DHCP server in the network.

** IP configuration via DHCP **

For a configuration via a DHCP server, use the ''dhcp'' command in U-Boot.

** Static IP configuration **
For a static IP configuration the following, U-Boot environment variables must be set:
<code>setenv ipaddr <ipaddr> 
(e.g.: setenv ipaddr 192.168.100.111)
setenv netmask <netmask> 
(e.g.: setenv netmask 255.255.255.0)
</code>

</panel>
<panel title="Linux">
Both Ethernet interfaces are activated and configured by systemd-networkd. The configuration files for the interfaces are located in /lib/systemd/network/ these configuration files can be altered to customize the default interface configuration. A documentation of the configuration files can be found [[https://www.freedesktop.org/software/systemd/man/systemd.network.html|here]].

For a temporary static configuration the ip command can be used, below some useful ip commands are listed:\\ 
\\
**Activate a specific interface**\\
e.g. eth0
<code>
ip link set eth0 up
</code>
\\
**Disable a specific interace**\\
e.g. eth0
<code>
ip link set eth0 down
</code>
\\
**Show ip address for a specific interface**\\
e.g. eth0
<code>
ip addr show eth0
</code>
\\
**Show statistic for a specific interface**\\
e.g. eth0

<code> 
ip -s link show eth0 
</code>
\\
**Set ip address for a specific interface**\\
e.g. eth0

<code>
ip addr add 192.168.1.100/24 dev eth0
</code>
\\
**Show statistic of all interfaces**\\

<code>
ip -s link
</code>
\\
**Set default gateway for a specific interfaces**\\
e.g. set gateway ip 192.168.1.1 for eth0 
<code>
ip route add default via 192.168.1.1 dev eth0
</code>
----

If a DHCP server is available in the network environment the ip configuration can be received from it. To do so execute the ''udhcpc'' command, by default eth0 is used.\\
To configure another interface via dhcp the parameter ''-i''  followed by the interface name e.g. eth1 must be given.\\
e.g. eth1

<code>
udhcpc -i eth1 
</code>

</panel>
</accordion>
</panel>

==== GPIO Buttons ====
<panel type="default" title="Buttons">
The MBa8MPxL has two GPIO buttons, they are bound to the gpio-keys driver.
<grid>
<col sm="6">
<panel height="350px" type="primary" title="GPIO Button Overview">
^ Reference  ^ Button  ^ 
| TBD | S8 |
| TBD | S9 |
The buttons are available in the sysfs via the device /dev/input/event1 and can be tested with the evtest tool.
<code>
evtest /dev/input/event1
</code>
</panel>
</col>
<col sm="6">
<panel height="350px" type="primary" title="GPIO Button Location">
{{ {{:en:arm:tqma91xxca:yocto:mba91_buttons.jpg?400 |}}
</panel>
</col>
</grid>
</panel>
<callout type="primary" icon="true">
The information provided on this wiki page is subject to change due to circumstances beyond our control. While we strive to keep all details as accurate and up-to-date as possible, it is possible that certain updates or changes may go unnoticed for some time. As a result, some sections of this page may contain outdated information. If you notice any mistakes in the documentation, we kindly ask you to inform the TQ Support through our ticket system.
</callout>