emissary-firmware/doc/hardware/bananapi.md

# BananaPi

![banana-rpi3](./../img/bpi-r3-case.jpg)

## Caractéristiques

- 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)

## 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/bpi-r3-download.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.

## FAQ

### Comment sélectionner le 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-r3-switch.png)

### Quels sont les noms des périphériques réseau ?

Par défaut les périphériques réseau sont ainsi disposé et nommé:

![Lan](./../img/bpi-r3-lan-pic.jpg)