doc: create hardware-sheet for bananapi. doc use to discover hardware and install firmware on it only

doc/Hardware-Sheet/banana-rpi-sheet.md

@@ -0,0 +1,129 @@
+# Banana-rpi
+
+![banana-rpi3](./../img/Pi-gels-BPI-R3-.jpg)
+
+## détail technique
+
+- MediaTek MT7986(Filogic 830) Quad core ARM Cortex A53
+- Wifi 6 2.4G/5G（MT7976C）
+- 2G DDR RAM
+- 8G eMMC flash
+- 128MB Nand flash
+- 2x 2.5GbE network port
+- 1x M.2 Key B USB inerface
+- 1x M.2 KEY M PCIe inerface
+- 1x USB2.0 interface
+- 1x Wan port (gigabit)
+- 4x LAN port (gigabit)
+
+### sélection boot système
+
+Il y a un switch de quatre jumper à manipuler pour sélectionner le choix de boot. Par défaut ils sont tous en haut, définissant le boot sur la carte microSD.
+
+![switch](./../img/bpi-rp3-switch.png)
+
+Par défaut les périphériques réseau sont ainsi disposé et nommé:
+
+![Lan](./../img/bpi-rp3-lan-pic.jpg)
+
+### Installation
+
+Par défaut la borne est sans OS, donc impossible de flasher selon la méthode conventionnel.
+
+bpi fournit un soft permettant de prendre un .img et de le mettre en place dans une carte SD.
+
+#### installation bpi-tools
+
+Il est conseillé d'installer pv auparavant pour plus de commodité. (disponibilité ubunut et manjaro validé)
+
+```Shell
+apt-get install pv
+```
+
+Installer bpi-tools sur votre machine, si vous ne pouvez accéder à l'url via curl, ce rendre sur le repo bpi-tools et le faire manuellement.
+
+```Shell
+curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | sudo -E bash
+```
+
+#### Installation firmware avec emissary
+
+Dans notre exemple nous partons d'une image openwrt avec emissary nommé: ```openwrt-22.03.2-emissary-v2023.08.02-bec8917-bcm27xx-bcm2711-rpi-4-squashfs-factory.img```
+
+1. télécharger l'image depuis la [forge cadoles](https://forge.cadoles.com/arcad/emissary-firmware/releases)
+Une fois téléchargé vous avez un .gz.</br>
+2. extraire : ```gunzip openwrt-**-emissary-***-****-**-**-rpi-4-squashfs-factory.img.gz```
+3. Ce placer dans le dossier contenant le fichier .img
+4. Brancher la SDcard à votre machine. Pour valider/vérifier son appelation vous pouvez utiliser ```dmesg``` et observer les dernières lignes. (en générale /dev/sda)
+5. Valider le chemin d'accès à la SDcard ( /dev/sd...)
+6. Lancer la copie sur SDcard avec bpi-copy.
+
+```Shell
+sudo bpi-copy openwrt-22.03.2-emissary-v2023.08.02-bec8917-bcm27xx-bcm2711-rpi-4-squashfs-factory.img /dev/sda
+```
+
+vous aurez un résultat ressemblant à :
+
+```Shell
+==============================================================
+jeu. 03 août 2023 10:09:12 CEST
+*** start COPY (blue led on ) .....
+umount device: /dev/sda
+umount /dev/sda1
+umount /dev/sda2
+==============================================================
+IMGFILE=openwrt-22.03.2-emissary-v2023.08.02-bec8917-bcm27xx-bcm2711-rpi-4-squashfs-factory.img
+==============================================================
+img
+8+1 enregistrements lus
+8+1 enregistrements écrits
+90475842 octets (90 MB, 86 MiB) copiés, 0,130052 s, 696 MB/s
+86,3MiO 0:00:00 [ 648MiO/s] [ <=>                                                                   ]
+0+1381 enregistrements lus
+0+1381 enregistrements écrits
+***  end  COPY (blue led off) .....
+jeu. 03 août 2023 10:09:18 CEST
+==============================================================
+RUNTIME 0:6
+OK!! You can remove the BOOTDISK /dev/sda now!!
+```
+
+Une fois finie, retirer la carte SD, vous pouvez dès à présent la placer dans votre boitier de destination.
+
+Une fois la carte flashé, vérifier que le switch à tout ces jumpers vers le haut, (sélection du boot), insérer la carte SD, puis brancher la borne.
+
+Vous pourrez vous brancher sur un port LAN du boitier qui délivrera du dhcp afin d'utiliser ssh pour y accéder.
+
+## OS pour banana-bpi fournit par bpi
+
+Installation d'openwrt fait pour bpi-r3, pour cela flasher une carte SD avec le fichier ```bananapi_bpi-r3-sdcard.img.gz``` fournit par openwrt [sur leur site page download](https://downloads.openwrt.org/snapshots/targets/mediatek/filogic/). Sinon aller dans les téléchargement et ce rendre à l'emplacement suivant :
+
+![img](./../img/2023-08-03_15-54.png)
+
+### flasher la carte avec le firware Openwrt de bpi
+
+1. télécharger l'image depuis le liens précédent. Une fois téléchargé vous avez un .gz.</br>
+2. extraire : ```gunzip bananapi_****.img.gz```
+3. Ce placer dans le dossier contenant le fichier .img
+4. Brancher la SDcard à votre machine. Pour valider/vérifier son appelation vous pouvez utiliser dmesg et observer les dernières lignes. (en générale sda)
+5. Valider le chemin d'accès à la SDcard (souvent /dev/sd...)
+6. Lancer la copie sur SDcard avec bpi-copy.
+
+```Shell
+sudo bpi-copy bananapi_bpi-r3-sdcard.img /dev/sda
+```
+
+Une fois la carte flashé, vérifier que le switch à tout ces jumpers vers le haut, (sélection du boot), insérer la carte SD, puis brancher la borne.
+
+Votre carte réseau doit être paramétré ainsi :
+
+- dans le réseau 192.168.1.0/24
+- sur la passerelle 192.168.1.1
+
+Brancher votre câble RJ45 sur le port VLAN1, et connectez vous en ssh.(temps de boot moins de 30 secondes)
+
+```Shell
+ssh root@192.168.1.1
+```
+
+pour la première connexion il n'y a pas de mot de passe.

doc/README.md

@@ -8,8 +8,13 @@ install/    # Tâches Make d'installation spécifiques aux différentes cibles d
 misc/       # Fichiers spécifiques aux différentes cibles de construction
 targets/    # Tâches Make de définition des différentes cibles de construction
 ```
+
 ## Tutoriels
 
 - [Premiers pas](./tutorials/first-steps.md)
 - [Compiler un firmware](./tutorials/firmware-compilation.md)
 - [Flasher une borne](./tutorials/device-flashing.md)
+
+## Fiche matériel
+
+- [banana-rpi](./Hardware-Sheet/banana-rpi-sheet.md)