O projeto Caninos Loucos fornece uma imagem mínima para Labrador 32 bits, abaixo você encontrará instruções para baixá-la e usá-la.

Para criar sua própria imagem consulte: [https://wiki.caninosloucos.org.br/index.php/Labrador_32_bits_-_Criando_uma_imagem Labrador 32 bits - Criando uma imagem]
Para configurar o Wi-Fi: [https://wiki.caninosloucos.org.br/index.php/Configurando_o_Wi-Fi_na_linha_de_comando Wi-Fi]

Obs¹.: Em todo o procedimento você deve substituir mmcblkX pelo descritor correto para o seu caso.

Obs².: As credenciais da imagem mínima são:
<pre>
usuário: caninos
senha: caninos
</pre>

= Baixando a imagem mínima =

A imagem mínima encontra-se no repositório do Caninos Loucos: [https://downloads.caninosloucos.org.br/labrador_32_bits/minimal_image/lab32_4.14.13_minimal.img.xz lab32_4.14.13_minimal.img.xz]

Baixe a imagem:
<pre>$ wget https://downloads.caninosloucos.org.br/labrador_32_bits/minimal_image/lab32_4.14.13_minimal.img.xz</pre>

Confira a integridade do arquivo baixado:
<pre>
$ md5sum lab32_4.14.13_minimal.img.xz
b26f2ce0a0b63713e2d14d10c80ea482 lab32_4.14.13_minimal.img.xz
</pre>

= Gravando a imagem mínima em um cartão SD =
Grave a imagem em um cartão SD de pelo menos 1G:
<pre># xzcat lab32_4.14.13_minimal.img.xz | dd of=/dev/mmcblkX bs=3M conv=fsync</pre>

= Redimensionando a partição do Sistema de Arquivos =
A imagem mínima pode ser gravada em cartões SD a partir de 1G. Se você gravar em cartões com capacidade maior, deverá redimensionar a partição do sistema de arquivos (rootfs). Para isso, faça:

'''i) Exclua e recrie a partição com o tamanho adequado'''
<pre>
# fdisk /dev/mmcblkX

Welcome to fdisk (util-linux 2.33.1).
Changes will remain in memory only, until you decide to write them.
Be careful before using the write command.

GPT PMBR size mismatch (1843199 != 15523839) will be corrected by write.
The backup GPT table is not on the end of the device. This problem will be corrected by write.

Command (m for help): p

Disk /dev/mmcblkX: 7,4 GiB, 7948206080 bytes, 15523840 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 5BF8A5BA-95B2-4128-B53F-36E7DF26053C

Device Start End Sectors Size Type
/dev/mmcblkXp1 16384 114687 98304 48M Linux filesystem
/dev/mmcblkXp2 114688 1843166 1728479 844M Linux filesystem

Command (m for help): d
Partition number (1,2, default 2): 2

Partition 2 has been deleted.

Command (m for help): n
Partition number (2-128, default 2): 2
First sector (34-15523806, default 114688): 114688
Last sector, +/-sectors or +/-size{K,M,G,T,P} (114688-15523806, default 15523806):

Created a new partition 2 of type 'Linux filesystem' and of size 7,4 GiB.
Partition #2 contains a ext4 signature.

Do you want to remove the signature? [Y]es/[N]o: No

Command (m for help): p

Disk /dev/mmcblkX: 7,4 GiB, 7948206080 bytes, 15523840 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 5BF8A5BA-95B2-4128-B53F-36E7DF26053C

Device Start End Sectors Size Type
/dev/mmcblkXp1 16384 114687 98304 48M Linux filesystem
/dev/mmcblkXp2 114688 15523806 15409119 7,4G Linux filesystem

Command (m for help): w
The partition table has been altered.
Calling ioctl() to re-read partition table.
Syncing disks.
</pre>

Obs.: Há dois pontos importantes aqui: a partição recriada deve se iniciar '''exatamente''' onde a anterior se iniciava, o final, porém, será diferente. Ao fazer isso, o fdisk encontrará a assinatura do sistema de arquivos e dará a opção de removê-la. '''Não remova''' a assinatura.

'''ii) Altere o tamanho do sistema de arquivos'''

Assim que a partição tiver sido redimensionada é preciso redimensionar o sistema de arquivos contido na partição, para isso:
<pre>
# fsck.ext4 -f /dev/mmcblkXp2
# resize2fs /dev/mmcblkXp2
</pre>

Glhrm:

Nesta página você encontrará instruções de como criar uma imagem mínima para Labrador 32 bits. Esse processo compreende compilar o bootloader, o Kernel Linux e gerar um sistema de arquivos de uma distribuição GNU/Linux ''Debian-like''. Compreende também os passos para escrever essa imagem em um cartão SD.

Para encontrar a versão mais atualizada dos softwares aqui citados, acesse nosso [http://github.com/caninos-loucos/ Github].

Para a versão 64 bits acesse a seguinte página: [[Labrador_64_bits_-_Criando_uma_imagem]]

= Pré-requesitos =

== Bootloader ==
O primeiro passo é obter o bootloader. É possível usar um binário pré-compilado ou compilá-lo a partir do código-fonte, seguindo as instruções da página do [https://github.com/caninos-loucos/labrador-uboot-32 github/labrador-uboot-32].

Ao final desse processo você terá um arquivo ''u-boot-dtb.img'' ou ''u-boot-dtb-no-UART3-console.img''.

Obs.: Se você quer ter a UART3 (/dev/ttyS3) ativada para console de debug, que é o recomendado para a maior parte dos casos, use o ''u-boot-dtb.img''. Caso você tenha intenção de usar o UART3 para alguma outra finalidade, use o ''u-boot-dtb-no-UART3-console.img''.

== Kernel Linux ==
Para obter o kernel, acesse [https://github.com/caninos-loucos/labrador-linux github/labrador-linux]. Novamente aqui você tem a opção de usar binários pré-compilados ou compilá-los a partir do código-fonte, conforme as instruções do arquivo README.md.

Obs.: Se você está fazendo compilação cruzada do kernel, é possível usar o arm-linux-gnueabihf-gcc disponível no repositório do bootloader. Nesse caso adicione o caminho para o compilador ao PATH. Por exemplo, se você fez o clone do u-boot em $HOME:

<pre>$ export PATH=$PATH:$HOME/labrador-uboot-32/toolchain/arm-linux-gnueabihf/bin</pre>

Ao final desse processo você terá:
* kernel.dtb
* uImage
* lib/modules

== Sistema de Arquivos ==

Você pode usar qualquer rootfs compatível com a arquitetura arm. Nesse procedimento descreveremos o processo para criação de um rootfs usando o [https://wiki.debian.org/pt_BR/Debootstrap debootstrap].

'''i) debootstrap primeiro estágio'''

Para gerar um sistema base Debian Buster:
<pre># debootstrap --arch=armhf --foreign buster rootfs</pre>

'''ii) debootstrap segundo estágio'''
<pre>
# cp /usr/bin/qemu-arm-static rootfs/usr/bin
# cp /etc/resolv.conf rootfs/etc
# chroot rootfs
# export LANG=C
# /debootstrap/debootstrap --second-stage
</pre>

'''iii) configurando o repositório de pacotes'''
<pre>
# cat << EOT > /etc/apt/sources.list
deb http://ftp.br.debian.org/debian/ buster main contrib non-free
deb-src http://ftp.br.debian.org/debian/ buster main contrib non-free

deb http://security.debian.org/debian-security buster/updates main contrib non-free
deb-src http://security.debian.org/debian-security buster/updates main contrib non-free

# buster-updates, previously known as 'volatile'
deb http://ftp.br.debian.org/debian/ buster-updates main contrib non-free
deb-src http://ftp.br.debian.org/debian/ buster-updates main contrib non-free
EOT
</pre>

'''iv) instalando pacotes adicionais'''
<pre>
# apt-get update
# apt-get upgrade
# apt-get install sudo
</pre>

'''v) definindo o hostname'''
<pre># echo labrador > /etc/hostname</pre>

'''vi) adiocionar o hostname ao hosts'''

Você deve adicionar o nome definido no passo anterior (''hostname'') ao arquivo /etc/hosts, da seguinte forma:

127.0.1.1 labrador

Ao final seu arquivo /etc/hosts deve se parecer com esse:
<pre>
# cat /etc/hosts
127.0.0.1 localhost
127.0.1.1 labrador
::1 localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

'''vii) criar um usuário e adicioná-lo ao grupo sudo'''

Criaremos um usuário chamado caninos:
<pre>
# useradd -m caninos
# usermod -aG sudo caninos
</pre>

Definiremos uma senha para esse usuário:
<pre># passwd caninos</pre>

'''viii) demais ajustes'''

Você pode fazer outros ajustes aqui que julgar necessário. Os passos descritos até aqui são os mais essenciais para se ter uma versão mínima em modo texto.

'''ix) finalizando'''
<pre>
# apt-get autoclean
# apt-get clean
</pre>

Para sair do chroot:
<pre># exit</pre>

Limpando:
<pre>
# rm -f rootfs/root/.bash_history rootfs/usr/bin/qemu-arm-static
# cat /dev/null > rootfs/etc/resolv.conf
</pre>

== Salvando o sistema num cartão SD ==
'''i) Criar a tabela de partições'''

Obs.: Você deve substituir mmcblkX pelo descritor correto para o seu caso.

<pre>
# parted /dev/mmcblkX
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) mklabel gpt
(parted) unit s
(parted) mkpart primary 16384 114687
(parted) mkpart primary 114688 -1
Warning: You requested a partition from 114688s to AAAs (sectors 114688..AAA).
The closest location we can manage is 114688s to BBBs (sectors 114688..BBB).
Is this still acceptable to you?
Yes/No? yes
(parted) print
Model: (file)
Disk /dev/mmcblkX: DDDs
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Disk Flags:

Number Start End Size File system Name Flags
1 16384s 114687s 98304s primary
2 114688s BBBs CCCs primary

(parted) q
</pre>

'''ii) Gravar o bootloader'''
<pre># dd if=/path/to/u-boot-dtb.img of=/dev/mmcblkX bs=512 seek=66 status=progress</pre>

'''iii) Formatar as partições'''
<pre>
# mkfs.vfat /dev/mmcblkXp1
# mkfs.ext4 /dev/mmcblkXp2
</pre>

'''iv) Gravar o kernel na partição 1'''
<pre>
# mount /dev/mmcblkXp1 /mnt
# cp /path/to/kernel.dtb /mnt
# cp /path/to/uImage /mnt
# cat << EOT > /mnt/uEnv.txt
uenvcmd=setenv ramdisk_addr_r -; setenv os_type linux;
bootargs=scandelay root=/dev/mmcblk0p2 rw console=tty0 loglevel=0 rootwait iomem=relaxed
EOT
# sync
# umount /mnt
</pre>

'''v) Gravar o rootfs na partição 2'''
<pre>
# mount /dev/mmcblk0p2 /mnt
# cp -rp /path/to/rootfs/* /mnt
# cp -r /path/to/lib/modules /mnt/lib
# sync
# umount /mnt
</pre>