RootFS
Nesta etapa será feito o download, configuração e compilação do Kernel(linux-toradex) para Placa alvo do Treinamento - Colibri iMX8X.
Note
Diretório de Trabalho: ~/treinamento/Lab/Busybox
Warning
Caso o Container Docker não esteja iniciado, crie a instância, e crie os seguintes diretórios:
Antes de continuar, confirme que esteja dentro do CONTAINER e no diretorio /home do usuário, com o comando abaixo:
Saída esperada:
Criar o diretorio ~/treinamento/Lab/Busybox e acessar o diretorio criado:
Download do Busybox
Executar download via wget:
Warning
Antes de iniciar a configuração e compilação, lembre-se de configurar o PATH para o toolchain, pode utilizar source preparar_ambiente.sh.
Customizando o projeto BusyBox
Em seguida, descompactar o projeto e executar make menuconfig para personalizar a compilação do Busybox.
O que deverá ser configurado:
Settings --->
[ ] Enable compatibility for full-blown desktop systems (8kb)
Settings --->
[*] Build static binary (no shared libs)
Debian Utilities --->
[*] start-stop-daemon
Network Utilities --->
[ ] Enable IPv6 support
Network Utilities --->
[*] telnetd
Salvando as modificações, selecione <Exit>, confirmar com <Yes> para salvar as modificações.
Iniciando compilação do projeto:
Resultado esperado:
...
...
...
LINK busybox_unstripped
Static linking against glibc, can't use --gc-sections
Trying libraries: crypt m resolv rt
Library crypt is not needed, excluding it
Library m is needed, can't exclude it (yet)
Library resolv is needed, can't exclude it (yet)
Library rt is not needed, excluding it
Library m is needed, can't exclude it (yet)
Library resolv is needed, can't exclude it (yet)
Final link with: m resolv
DOC busybox.pod
DOC BusyBox.txt
DOC busybox.1
DOC BusyBox.html
Gerando a estrutura e link-simbolico dos comandos:
Resultado esperado:
...
...
./_install//usr/sbin/tftpd -> ../../bin/busybox
./_install//usr/sbin/ubiattach -> ../../bin/busybox
./_install//usr/sbin/ubidetach -> ../../bin/busybox
./_install//usr/sbin/ubimkvol -> ../../bin/busybox
./_install//usr/sbin/ubirename -> ../../bin/busybox
./_install//usr/sbin/ubirmvol -> ../../bin/busybox
./_install//usr/sbin/ubirsvol -> ../../bin/busybox
./_install//usr/sbin/ubiupdatevol -> ../../bin/busybox
./_install//usr/sbin/udhcpd -> ../../bin/busybox
--------------------------------------------------
You will probably need to make your busybox binary
setuid root to ensure all configured applets will
work properly.
--------------------------------------------------
Criando o diretório ../output e copiando o resultado da compilação/instalação para dentro dele:
Resultado esperado:
total 12
drwxr-xr-x 2 b2open b2open 4096 Mar 03 19:04 bin
lrwxrwxrwx 1 b2open b2open 11 Mar 03 19:04 linuxrc -> bin/busybox
drwxr-xr-x 2 b2open b2open 4096 Mar 03 19:04 sbin
drwxr-xr-x 4 b2open b2open 4096 Mar 03 19:04 usr
Analisando o binario busybox gerado:
Resultado esperado:
bin/busybox: ELF 64-bit LSB executable, ARM aarch64, version 1 (GNU/Linux), statically linked, for GNU/Linux 3.7.0, stripped
Criando diretórios do FHS RootFS
Criando diretórios de acordo com padrão FHS, copiando os módulos após compilação do Kernel que devem ser instalado em /lib e copiando a libC gerado pela Toolchain.
Note
Diretório de Trabalho: ~/treinamento/Lab/Busybox/output
Confirme estar no diretório abaixo:
Executar:
mkdir -p dev etc etc/init.d lib lib64 proc run sys var/volatile home mnt root run/volatile tmp
chmod 700 root
cp -ra ../../Kernel/output_modules/lib/* lib/
cp -ra ~/treinamento/toolchain/aarch64-unknown-linux-gnu/aarch64-unknown-linux-gnu/sysroot/lib64/* lib64/
cp -ra ~/treinamento/toolchain/aarch64-unknown-linux-gnu/aarch64-unknown-linux-gnu/sysroot/lib/* lib/
Customizando arquivos do RootFS
As etapas realizadas até agora são suficientes para um boot completo de um Sistema Linux Embarcado, no entanto, algumas configurações adicionais, melhorias e personalizações serão realizadas nos arquivos a seguir.
Note
Diretório de Trabalho: ~/treinamento/Lab/Busybox/output
Warning
Os diretório e arquivos a serem criados a partir de agora atente-se a criar dentro do ~/treinamento/Lab/Busybox/output e não no Host!
Criando etc/fstab
Arquivo responsável por montar todos sistemas de arquivos e pontos de montagem especificados, crie o arquivo e adicione:
Adicionar:
proc /proc proc defaults 0 0
tmpfs /run tmpfs mode=0755,nodev,nosuid,strictatime 0 0
tmpfs /var/volatile tmpfs defaults 0 0
tmpfs /tmp tmpfs defaults 0 0
Criando etc/passwd
Arquivo que contem a lista de usuários do Sistema, segue o formato usuario:"senha":UID:GID:DIRETÓRIO:TERMINAL.
Adicionar:
Criando etc/inittab
Após a inicialização do init o /etc/inittab é o próximo arquivo a ser carregado e configurar ou processar sua inicialização ou setup do Sistema.
Adicionar:
# Apos inicializar o sistema ira carregar rcS
::sysinit:/etc/init.d/rcS
# Ao inicializar o Sistema de não houver terminal
# ou login ira escrever "Enter key is pressed" para continuar
#::askfirst:-/bin/sh
# Quando pressiona Ctrl+Alt+Del
::ctrlaltdel:/sbin/reboot
# Ira lançar um terminal, podera ser um script/aplicacao
# ::respawn:-/bin/sh
# Rotina quando o sistema é desligado
::shutdown:/bin/umount -a -r
# Rotina quando o sistema é reiniciado
::restart:/sbin/init
# Conectando a SerialPorta para um Terminal
ttyLP3:12345:respawn:/sbin/getty -L ttyLP3 115200 vt100
Criando etc/profile
Arquivo que é processado por cada usuário ao logar, exportando recursos e variáveis ambientes configuradas.
Adicionar:
# Configurando Hostname
export HOSTNAME=tdxBoard
# Configurando Username
export USER=root
# Configurando Diretorio HOME do root
export HOME=/root
# String do Terminal ao logar
# basic
# export PS1='$USER@$HOSTNAME:\w \$ '
# custom
export PS1='\[\e[1;32m\][$USER@$HOSTNAME]\[\e[0m\] \[\e[1;34m\]\w\[\e[0m\] \$ '
export PATH=/bin:/sbin:/usr/bin:/usr/sbin
export LD_LIBRARY_PATH=/lib64:/lib:/usr/lib64:/usr/lib:$LD_LIBRARY_PATH
export TERM=linux
eval $(resize)
Criando etc/init.d/rcS
Após o init carregar o arquivo /etc/inittab este é o arquivo que segue a inicialização de serviços ou ele como um script de inicialização.
Adicionar:
#!/bin/sh
/bin/mount -a
# Monta o VSF – devpts e SysFS
/bin/mkdir -p /dev/pts
/bin/mount -t devpts devpts /dev/pts
/bin/mount -t sysfs sysfs /sys
# Usando mdev para gerenciar dinamicamente dispositivos hotplug
/bin/echo /sbin/mdev > /proc/sys/kernel/hotplug
# Varre por dispositivos e cria os nós em /dev
/sbin/mdev -s
/bin/mount -o remount,rw /
Lembre-se de dar a permissão de execução: chmod +x rcS
Criando etc/issue
Informações exibidas no terminal do usuário ao logar.
Criar o arquivo Lab/Busybox/output/etc/issue e copiar o conteudo abaixo para ele:
Conteúdo:
------------------------------------------------------
Treinamento Linux Embarcado
`o.o´
O
____ ____ ___
| __ ) |___ \\ / _ \\ _ __ ___ _ __
| _ \\ __) | | | | | | '_ \\ / _ \\ | '_ \\
| |_) | / __/ | |_| | | |_) | | __/ | | | |
|____/ |_____| \\___/ | .__/ \\___| |_| |_|
|_|
____ _
/ ___| _ _ ___ | |_ ___ _ __ ___ ___
\\___ \\ | | | | / __| | __| / _ \\ | '_ ` _ \\ / __|
___) | | |_| | \\__ \\ | |_ | __/ | | | | | | \\__ \\
|____/ \\__, | |___/ \\__| \\___| |_| |_| |_| |___/
|___/
Kernel: \r
Date : \d
TTY : \l
------------------------------------------------------
Estrutura Final do RootFS
Analisando o rootfs gerado no laboratório:
Resultado esperado:
.
├── bin
├── dev
├── etc
├── home
├── lib
├── lib64
├── linuxrc -> bin/busybox
├── mnt
├── proc
├── root
├── run
├── sbin
├── sys
├── tmp
├── usr
└── var
15 directories, 1 file
Resultado esperado:
etc/
├── fstab
├── init.d
│ └── rcS
├── inittab
├── issue
├── passwd
└── profile
1 directory, 6 files
Resultado esperado:
Finalizamos o laboratório de RootFS e já temos um RootFS funcional para o hardware.
Acessar Bootloader, Carregar o Kernel e RootFS via Rede (TFTP)
Utilizar um cabo usb e conectar na porta USB X4 da Aster Board, utilizar as ferramentas minicom ou picocom para acessar o bootloader u-boot via Serial Console.
Info
Em caso de duvida veja o tópico Serial Console Colibri iMX8X no menu do lado esquerdo.
Neste momento conecte o plug de alimentação na placa e pressione qualquer tecla para interromper o processo de boot e entar na Interface de Comandos do Bootloader U-Boot:
sudo picocom /dev/ttyUSB0 -b115200
U-Boot 2022.04-6.8.0-devel+git.a1eb18d157f4 (Jul 16 2024 - 20:38:08 +0000)
CPU: NXP i.MX8QXP RevC A35 at 1200 MHz at 41C
DRAM: 2 GiB
Core: 240 devices, 20 uclasses, devicetree: separate
MMC: FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... OK
In: serial
Out: serial
Err: serial
Model: Toradex 0038 Colibri iMX8QXP 2GB WB IT V1.0D
Serial#: 07330376
BuildInfo:
- SCFW f407904f, SECO-FW c9de51c0, IMX-MKIMAGE 3bfcfccb, ATF 3c1583b
- U-Boot 2022.04-6.8.0-devel+git.a1eb18d157f4
flash target is MMC:0
Net: eth0: ethernet@5b040000
Fastboot: Normal
Normal Boot
Hit any key to stop autoboot: 0
Colibri iMX8X #
Carregar e dar boot no Kernel e RootFS via Rede (TFTP)
ATENÇÃO
Muita atenção, minimize o Container do Treinamento, abra um Terminal no Linux Host ou outro WSL2 como Administrador e execute os comandos abaixo para iniciar os módulos do Kernel para suporte a NFS:
Volte para o Container do Treinamento e execute os comandos abaixo:
cd ~/treinamento
mkdir -p ${HOME}/treinamento/Lab/nfs_rootfs
sudo ln -s ${HOME}/treinamento/Lab/nfs_rootfs/ /nfs_rootfs
./treinamento-b2open/Scripts/preparar_tftpboot_nfs.sh
Saída esperada:
##########################################################################################
# B2OPEN SYSTEMS #
# #
# Pressione qualquer tecla para iniciar a instalacao e #
# configuracao do TFTP e NFS Server #
# #
##########################################################################################
[1] Instalando pacotes...
[2] Criando Diretorios...
[3] Copiando arquivos de Bootloader, Kernel e RootFS...
[4] Ajustando permissoes...
[5] Configurando /etc/exports
/nfs_rootfs/ *(rw,no_root_squash,no_subtree_check,sync)
[6] Ajustando configuracoes /etc/default/tftpd-hpa
[7] Exportando exportfs...
exporting *:/nfs_rootfs
[8] Iniciar tftpserver execute:
sudo /etc/init.d/tftpd-hpa start
[9] Iniciar nfs server execute:
sudo /etc/init.d/rpcbind start
sudo /etc/init.d/nfs-kernel-server start
Verificando se o /nfs/rootfs/ esta populado:
Saída esperada:
O comando ls -l /nfs_rootfs/deverá retornar:
total 60
drwxr-xr-x 2 root root 4096 May 9 16:22 bin
drwxr-xr-x 2 root root 4096 May 9 16:58 dev
drwxr-xr-x 3 root root 4096 May 9 17:00 etc
drwxr-xr-x 2 root root 4096 May 9 16:58 home
drwxr-xr-x 3 root root 4096 May 9 16:58 lib
drwxr-xr-x 2 root root 4096 May 9 16:58 lib64
lrwxrwxrwx 1 root root 11 May 9 16:22 linuxrc -> bin/busybox
drwxr-xr-x 2 root root 4096 May 9 16:58 mnt
drwxr-xr-x 2 root root 4096 May 9 16:58 proc
drwx------ 2 root root 4096 May 9 16:58 root
drwxr-xr-x 3 root root 4096 May 9 16:58 run
drwxr-xr-x 2 root root 4096 May 9 16:22 sbin
drwxr-xr-x 2 root root 4096 May 9 16:58 sys
drwxr-xr-x 2 root root 4096 May 9 16:58 tmp
drwxr-xr-x 4 root root 4096 May 9 16:22 usr
drwxr-xr-x 3 root root 4096 May 9 16:58 var
Inicio o TFTP Server e em seguida o NFS Server:
sudo /etc/init.d/tftpd-hpa start
sudo /etc/init.d/rpcbind start
sudo /etc/init.d/nfs-kernel-server start
Saída esperada:
* Starting HPA's tftpd in.tftpd [ OK ]
* Starting RPC port mapper daemon rpcbind [ OK ]
* Exporting directories for NFS kernel daemon... [ OK ]
* Starting NFS kernel daemon
Configurando o Bootloader U-Boot para utilizar NFS
Neste ponto temos o bootcmd_tftp configurado na pratica do Kernel com TFTP Server, abaixo deve-se configurar a variavel bootargs para montar o rootfs via NFS:
Atenção
Escolha abaixo a opção que melhor se encaixa ao setup e infraestrutura do treinamento.
Interrompa o processo de boot e acesse o prompt do Bootloader para executar o comando abaixo:
Se o container, rede e configurações estiverem corretos o GNU/Linux com o rootfs customizado sera carregado:
...
...
...
[ 4.883177] IP-Config: Complete:
[ 4.886417] device=eth0, hwaddr=00:14:2d:6f:da:48, ipaddr=10.20.30.50, mask=255.255.255.0, gw=10.20.30.40
[ 4.896478] host=b2-nfs, domain=, nis-domain=(none)
[ 4.901828] bootserver=10.20.30.40, rootserver=10.20.30.40, rootpath=
[ 4.902091] clk: Disabling unused clocks
[ 4.918608] ALSA device list:
[ 4.921653] No soundcards found.
[ 4.925690] Waiting 3 sec before mounting root device...
[ 8.059490] VFS: Mounted root (nfs filesystem) on device 0:21.
[ 8.066677] devtmpfs: mounted
[ 8.070928] Freeing unused kernel memory: 3328K
[ 8.075928] Run /sbin/init as init process
Treinamento Linux Embarcado
`o.o´
O
____ ____ ___
| __ ) |___ \ / _ \ _ __ ___ _ __
| _ \ __) | | | | | | '_ \ / _ \ | '_ \
| |_) | / __/ | |_| | | |_) | | __/ | | | |
|____/ |_____| \___/ | .__/ \___| |_| |_|
|_|
____ _
/ ___| _ _ ___ | |_ ___ _ __ ___ ___
\___ \ | | | | / __| | __| / _ \ | '_ ` _ \ / __|
___) | | |_| | \__ \ | |_ | __/ | | | | | | \__ \
|____/ \__, | |___/ \__| \___| |_| |_| |_| |___/
|___/
b2-nfs login:
Role as mensagens do kernel e localize as entradas:
Kernel command line:
IP-Config: Complete:
VFS: Mounted root (nfs filesystem) on device
Run /sbin/init as init process
Finalizada a Prática com Busybox, RootFS e validação do boot completo!