random-mirrors/easytarget-MQ-Pro-IO
1
0
Fork 0
mirror of https://github.com/easytarget/MQ-Pro-IO.git synced 2025-10-14 01:35:52 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Owen Carter 2024-09-02 13:59:02 +02:00 committed by GitHub
parent 7c1b8b5082
commit ac6b1b6352
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 19 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@ -47,20 +47,20 @@ The WiFi module will be detected, but will not connect to any networks unless pr
You will need a suitable machine to download the image file to, with a SD card writer so the image can be written. You will need a suitable machine to download the image file to, with a SD card writer so the image can be written.
- The instructions below are for a generic Linux system with a sd card writer. - The instructions below are for a generic Linux system with a sd card writer.
- As ever with this sort of operation make *absolutely* sure you are using the correct disk device when writing. - As ever with this sort of operation make *absolutely* sure you are using the correct disk device when writing.
- The example here assumes `/dev/mmcblk0`, which is the inbuilt SD card slot om my system. - The example here assumes `/dev/mmcblk0`, which is the inbuilt SD card slot om *my* system.
- Windows users need to ignore the linux steps and use a tool such as Belena Etcher, or similar, before skipping to the console network config section. - Windows users need to ignore the linux steps and use a tool such as Belena Etcher or similar to burn the SD card, before skipping to [first boot](#first-boot).
Get the image file; (as of 2-Sep-2024 the url below works). Get the image file; (as of 2-Sep-2024 the url below works).
```console ```console
$ wget https://cdimage.ubuntu.com/releases/noble/release/ubuntu-24.04.1-preinstalled-server-riscv64+licheerv.img.xz $ wget https://cdimage.ubuntu.com/releases/noble/release/ubuntu-24.04.1-preinstalled-server-riscv64+licheerv.img.xz
``` ```
Unpack and copy the deownloaded image to the SD card: Unpack and copy the downloaded image to the SD card:
```console ```console
$ xzcat ubuntu-24.04.1-preinstalled-server-riscv64+licheerv.img.xz | sudo dd bs=8M conv=fsync status=progress of=/dev/mmcblk0 $ xzcat ubuntu-24.04.1-preinstalled-server-riscv64+licheerv.img.xz | sudo dd bs=8M conv=fsync status=progress of=/dev/mmcblk0
``` ```
If you are going to configure Wifi/Network via the console, or using a USB Ethernet adapter you can skip to `First Boot`, below. If you are going to configure Wifi/Network via the console or using a USB Ethernet adapter you can skip to [`First Boot`](#first-boot) below.
#### Preconfiguring WiFi networks #### Preconfiguring WiFi networks
@ -68,12 +68,10 @@ Mount the SD card you just created:
```console ```console
$ sudo mount /dev/mmcblk1p1 /mnt $ sudo mount /dev/mmcblk1p1 /mnt
``` ```
Create a new network config file that will be applied at first init: Create a new network config file that will be applied at first init:
```console ```console
$ sudo vi /mnt/etc/cloud/cloud.cfg.d/55_net.cfg $ sudo vi /mnt/etc/cloud/cloud.cfg.d/55_net.cfg
``` ```
It should have the following contents: It should have the following contents:
```yaml ```yaml
network: network:
@ -97,23 +95,24 @@ Unmount the filesystem so that it is synced properly.
```console ```console
$ sudo umount /mnt $ sudo umount /mnt
``` ```
Eject the SD card.
#### First Boot #### First Boot
Insert the SD card into the MQ Pro and BOOT. Insert the SD card into the MQ Pro and BOOT.
- First boot is SLOW. It will take 5+ minutes before anything appears on HDMI. - First boot is SLOW. It will take 5+ minutes before anything useful appears on HDMI.
- This is where, if you have a serial adapter, it is useful for following progress. - This is where, if you have a serial adapter, it is handy for following progress.
- The HDMI console first appears after several minutes, appears to freeze soon after, but recovers after a while when the login prompt appears. - The HDMI console first appears after several minutes but then freezes soon after, it recovers after a while when the login prompt appears.
Once the maching has booted you can login on console, or via ssh, as `ubuntu:ubuntu` and follow the mandatory instructions to change password. Once the machine has booted you can login on console or ssh as `ubuntu:ubuntu`, and follow the mandatory instructions to change password.
#### WiFi config after boot #### WiFi config after first boot
If you are setting up WiFI after first boot you can use `netplan` to config the WiFi. If you are setting up WiFI *after* first boot you can use [`netplan`](https://netplan.io) to configure the WiFi.
Create and edit a file in the netplan config: Create and edit a file in the netplan config:
```console ```console
$ sudo vi /etc/netplan/55-wifi.yaml $ sudo vi /etc/netplan/55-wifi.yaml
``` ```
The contents of this are **identical** to the [precofigured WiFi](#preconfiguring-wifi-networks) setup given above. The contents of this are ***identical*** to the [precofigured WiFi](#preconfiguring-wifi-networks) setup given above.
- Copy the `yaml` definition given there to this file and edit with your details. - Copy the `yaml` definition given there to this file and edit with your details.
- The comments for the file there also apply here. - The comments for the file there also apply here.
@ -134,14 +133,12 @@ Boot-Script-Path: /boot/boot.scr
U-Boot-Script-Name: bootscr.uboot-generic U-Boot-Script-Name: bootscr.uboot-generic
Required-Packages: u-boot-tools Required-Packages: u-boot-tools
``` ```
This adds a new custom entry for the MQ Pro based on the default Lichee definition in `/usr/share/flash-kernel/db/all.db`, but with the correct name and device tree.
This adds new entry for the MQ Pro based on the default Lichhee image in `/usr/share/flash-kernel/db/all.db` but with the correct name and device tree.
Make this the default with: Make this the default with:
```console ```console
ubuntu@ubuntu:~$ sudo echo 'MangoPI MQ pro' > /etc/flash-kernel/machine ubuntu@ubuntu:~$ sudo echo 'MangoPI MQ pro' > /etc/flash-kernel/machine
``` ```
We now apply this by running `flash-kernel` manually (it is run automatically by dpkg whenever kernel images are (re)installed). We now apply this by running `flash-kernel` manually (it is run automatically by dpkg whenever kernel images are (re)installed).
```console ```console
ubuntu@ubuntu:~$ sudo flash-kernel ubuntu@ubuntu:~$ sudo flash-kernel
@ -152,11 +149,10 @@ Installing new sun20i-d1-mangopi-mq-pro.dtb.
System running in EFI mode, skipping. System running in EFI mode, skipping.
``` ```
Reboot the system and you will be using the default (vanilla) device tree. Reboot the system and you will be using the default (vanilla) device tree.
```console ```console
ubuntu@ubuntu:~$ sudo reboot ubuntu@ubuntu:~$ sudo reboot
# wait! # wait while it reboots
ssh into the machine as ubuntu:<new passwd> # then ssh into the machine as ubuntu:<new passwd>
$ sudo cat /proc/device-tree/model $ sudo cat /proc/device-tree/model
``` ```
- Should return 'MangoPi MQ Pro' - Should return 'MangoPi MQ Pro'
@ -164,33 +160,28 @@ $ sudo cat /proc/device-tree/model
#### You can now update as normal #### You can now update as normal
```console ```console
$ apt update $ apt update
# let this run, slow on this machine, especially the first run # Let this run, slow on this machine, especially the first run
# will eventually tell you that a lot of packages need updating # It will eventually tell you that a lot of packages need updating
apt update $ apt upgrade
# You may see packages 'deferred due to phasing', this is quite normal, an artifact of Ubuntu's build system, and can safely be ignored.
# This may be a good time to have lunch.
``` ```
You may see packages 'deferred due to phasing', this is quite normal, an artifact of Ubuntu's build system. These can safely be ignored.
When this completes reboot again, or finish the BT setup below first since it also needs a reboot. When this completes reboot again, or finish the BT setup below first since it also needs a reboot.
#### Setup Bluetooth adapter and status LED #### Setup Bluetooth adapter and status LED
Get the Bluetooth firmware files, they can be found online, but thee is a copy in my repo for convenience. Get the Bluetooth firmware files, they can be found online, but thee is a copy in my repo for convenience.
```console ```console
$ git clone https://github.com/easytarget/MQ-Pro-IO.git $ git clone https://github.com/easytarget/MQ-Pro-IO.git
``` ```
Copy Bluetooth firmware to the system firmware tree. Copy Bluetooth firmware to the system firmware tree.
```console ```console
$ sudo cp MQ-Pro-IO/files/rtl_bt/* /usr/lib/firmware/rtl_bt/ $ sudo cp MQ-Pro-IO/files/rtl_bt/* /usr/lib/firmware/rtl_bt/
``` ```
Before you reboot to apply these you shpule also install `bluez`, which allows you to use `bluetoothctl` to connect and pair,etc Before you reboot to apply these you shpule also install `bluez`, which allows you to use `bluetoothctl` to connect and pair,etc
```console ```console
$ sudo apt install bluez $ sudo apt install bluez
$ sudo reboot $ sudo reboot
``` ```
# set up a service for the activity light # set up a service for the activity light
```console ```console
$ sudo cp MQ-Pro-IO/files/mqpro-status-led.service /etc/systemd/system/ $ sudo cp MQ-Pro-IO/files/mqpro-status-led.service /etc/systemd/system/
@ -198,12 +189,10 @@ $ sudo systemctl daemon-reload
$ sudo systemctl enable --now mqpro-status-led.service $ sudo systemctl enable --now mqpro-status-led.service
``` ```
The Status LED should now be continually flashing with Network activity, there is more on controlling this below. The Status LED should now be continually flashing with Network activity, there is more on controlling this below.
# My Motivation: # My Motivation:
My MQ PRO is connected to a Waveshare LORA hat, I want to make it work but the default device tree conflicts with some of the pins my HAT uses. So I decided to 'fix' this by putting a better device tree on my board. My MQ PRO is connected to a Waveshare LORA hat, I want to make it work but the default device tree conflicts with some of the pins my HAT uses. So I decided to 'fix' this by putting a better device tree on my board.
![My Hardware](reference/waveshare_SX1268_LoRa_HAT/overview.jpg) ![My Hardware](reference/waveshare_SX1268_LoRa_HAT/overview.jpg)
# Device Trees # Device Trees
In the install steps above we reconfigure the system to use the correct MangoPI MQ pro device tree instead of the Sipeed Lichee RV one. In the install steps above we reconfigure the system to use the correct MangoPI MQ pro device tree instead of the Sipeed Lichee RV one.