Pular para conteúdo

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:

Executar no HOST
pwd

Saída esperada:

Executar no HOST
b2open@treinamento-b2open:~/treinamento$ pwd
/home/b2open/treinamento


Criar o diretorio ~/treinamento/Lab/Busybox e acessar o diretorio criado:

Executar no HOST
mkdir -p ~/treinamento/Lab/Busybox

cd ~/treinamento/Lab/Busybox/


Download do Busybox

Executar download via wget:

Executar no HOST
wget https://busybox.net/downloads/busybox-1.36.1.tar.bz2

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.

Executar no HOST
tar -xjf busybox-1.36.1.tar.bz2 

cd busybox-1.36.1/

make ARCH=arm64 menuconfig

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:

Executar no HOST
make ARCH=arm64 

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:

Executar no HOST
make ARCH=arm64 install

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:

Executar no HOST
mkdir ../output

cp -ra _install/* ../output

cd ../output

ls -l

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:

Executar no HOST
file bin/busybox

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 no HOST
b2open@treinamento-b2open:~/treinamento/Lab/Busybox/output$ 


Executar:

Executar no HOST
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:

Executar no HOST
mkdir -p etc

touch etc/fstab


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.

Executar no HOST
mkdir -p etc

touch etc/passwd


Adicionar:

root::0:0:root:/root:/bin/sh


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.

Executar no HOST
mkdir -p etc

touch etc/inittab


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.

Executar no HOST
mkdir -p etc

touch etc/profile


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.

Executar no HOST
mkdir -p etc

mkdir -p etc/init.d

touch etc/init.d/rcS


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

Executar no HOST
chmod +x etc/init.d/rcS


Criando etc/issue

Informações exibidas no terminal do usuário ao logar.

Executar no HOST
mkdir -p etc


Criar o arquivo Lab/Busybox/output/etc/issue e copiar o conteudo abaixo para ele:

Executar no HOST
touch etc/issue

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:

Executar no HOST
tree -L 1

Resultado esperado:

.
├── bin
├── dev
├── etc
├── home
├── lib
├── lib64
├── linuxrc -> bin/busybox
├── mnt
├── proc
├── root
├── run
├── sbin
├── sys
├── tmp
├── usr
└── var

15 directories, 1 file


Executar no HOST
tree etc/

Resultado esperado:

etc/
├── fstab
├── init.d
│   └── rcS
├── inittab
├── issue
├── passwd
└── profile

1 directory, 6 files


Executar no HOST
ls -l etc/init.d/rcS 

Resultado esperado:

-rwxr-xr-x 1 b2open b2open 355 Mar 03 19:34 etc/init.d/rcS


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.

Executar no HOST
sudo picocom /dev/ttyUSB0 -b115200


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:

Executar no HOST
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:

Executar no HOST
sudo modprobe nfsd
sudo modprobe nfs


Volte para o Container do Treinamento e execute os comandos abaixo:

Executar no HOST
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:

Executar no HOST
##########################################################################################
#                                        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:

Executar no HOST
ls -l /nfs_rootfs/


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:

Executar no HOST
sudo /etc/init.d/tftpd-hpa start

sudo /etc/init.d/rpcbind start

sudo /etc/init.d/nfs-kernel-server start


Saída esperada:

Executar no HOST
 * 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.

Executar no TARGET
setenv bootargs "console=tty1 console=${console},${baudrate} consoleblank=0 earlycon root=/dev/nfs rw nfsroot=10.20.30.40:/nfs_rootfs,tcp,vers=3 ip=10.20.30.50:10.20.30.40:10.20.30.40:255.255.255.0:b2-nfs rootdelay=3 nfsrootdebug"

saveenv

reset
Executar no TARGET
setenv bootargs "console=tty1 console=${console},${baudrate} consoleblank=0 earlycon root=/dev/nfs rw nfsroot=10.0.0.121:/nfs_rootfs,tcp,vers=3 ip=dhcp rootdelay=3 nfsrootdebug"

saveenv

reset


Interrompa o processo de boot e acesse o prompt do Bootloader para executar o comando abaixo:

Executar no TARGET
run bootcmd_tftp


Se o container, rede e configurações estiverem corretos o GNU/Linux com o rootfs customizado sera carregado:

Executar no HOST
...
...
...
[    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!