===== Quick User Guide =====

{{ :mini-pini:module_5.jpg?nolink |}}

=== Power on ===

Connect ​MiniPini ​card to your device via Mini PCie interface ​and startup your device.

=== Supported operating systems ===

  * Ubuntu 22.04.2 LTS & above.
  * OpenWrt 23.05.
General rule: OS kernel needs to be >= 5.19 or use wireless backports >= 6.1.

=== Setup boarddata files on Mango===

Mango must be flashed with a firmware, which has a support for Pine chipset. An example firmware with Pine support can be downloaded from here: [[https://wiki.8devices.com/_media/mini-pini:image.zip|Example firmware]]. OpenWRT contains default BDF files for Pine chipset. BDF files which are made specificaly for MiniPini are provided by our company, which can downloaded here: [[https://wiki.8devices.com/_media/mini-pini:boarddata_files.zip|BDF]]. Select correct BDF files (2x2 or 4x4), put them into the host device. Following commands shows how to chagne BDF files and activate one of the radio (2.4GHz or 5GHz):

  cd /lib/firmware/ath11k/QCN9074
  
  mv board-2.bin board-2.bin.orig

To activate 2G band:

  cp /tmp/MiniPini25_4x4_2G_GoldenBin.bin board.bin
  
  rmmod ath11k_pci; modprobe ath11k_pci

To activate 5G band:

  cp /tmp/MiniPini25_4x4_5G_GoldenBin.bin board.bin
  
  rmmod ath11k_pci; modprobe ath11k_pci

=== Setup boarddata files on Ubuntu/PC===

OpenWRT firmware contains default BDF files for Pine chipset. File board-2.bin must be removed. BDF files which are made specificaly for MiniPini are provided by our company, which can downloaded here: [[https://wiki.8devices.com/_media/mini-pini:boarddata_files.zip|BDF]]. Select correct BDF files (2x2 or 4x4), put them into the host device. Following commands shows how to chagne BDF files and activate one of the radio (2.4GHz or 5GHz):

  sudo su; cd /lib/firmware/ath11k/hw1.0/QCN9074
  
  rm -f board-2.bin

To activate 2G band:

  cp /tmp/MiniPini25_4x4_2G_GoldenBin.bin board.bin
  
  rmmod ath11k_pci; modprobe ath11k_pci

To activate 5G band:

  cp /tmp/MiniPini25_4x4_5G_GoldenBin.bin board.bin
  
  rmmod ath11k_pci; modprobe ath11k_pci

=== Configure ===

With default setting your device will be available with tools such as ''iw'', ''ip'', ''ifconfig'', ''tcpdump'' and ready to use. For more tools, configure your own ''.config'' on buildroot.