Tibbo’s Ubuntu-based distribution for the LTPP3(G2) offers a solid starting point for your development needs. However, you’ll likely want to customize your image with additional components as required by your projects.
Tibbo offers a Docker container with build tools to help you easily customize images for the LTPP3(G2). This tutorial demonstrates how to use Tibbo’s Docker container to build optional kernel components as modules — in this case, the TUN/TAP driver — to allow for new drivers without needing a complete reinstall.
If you prefer to add the driver as built-in driver, please see this article.
- Docker Desktop
- An SSH terminal client (e.g., IO Ninja)
- (Optional) A serial terminal client (e.g., IO Ninja)
Building a Customized Image:
- Pull and run Tibbo’s Docker container, then connect to it via SSH. See this article for a detailed guide on how to perform these steps.
- Run make kconfig. This opens the Kernel Configuration Menu.
- Highlight Universal TUN/TAP device driver support under Device drivers > Network device support. Selecting M enables the driver as a kernel module, while * permanently enables it.
- Exit and save when prompted.
- Run make to build your customized image.
Enabling Kernel Modules
- While in Tibbo’s container, copy tun.ko (located in /root/SP7021/linux/kernel/drivers/net/) to your LTPP3(G2).
There are many ways to do this, such as downloading the file to your computer and copying it to the device via a microSD card or USB flash drive. In this example, we directly copy it to the LTPP3(G2) using SFTP:
- Run sftp ubuntu@<LTPP3(G2) IP address> from the Docker terminal (CLI).
- Once connected, input put /root/SP7021/linux/kernel/drivers/net/tun.ko.
- Input exit to terminate the SFTP session.
- Connect to your LTPP3(G2).
- For instructions on connecting via SSH, see this article.
- For instructions on connecting via serial terminal, see this article.
- Copy tun.ko from your home directory (where it was uploaded via SFTP) to the proper location:
sudo cp ~/tun.ko /lib/modules/`uname -r`/kernel/net/
- To enable the module, add the tun entry in /etc/modules:
sudo nano /etc/modules
- Save, exit, and reboot the system.
- To verify that the module is running, run lsmod.