First pass on documentation changes within README
This commit is contained in:
j1nx
parent
cf6c4c7020
commit
95a2f2e350
97
README.md
97
README.md
|
|
@ -1,13 +1,15 @@
|
|||
# <img src='https://camo.githubusercontent.com/48b782bbddb51b97cf2971fda5817080075f7799/68747470733a2f2f7261772e6769746861636b2e636f6d2f466f7274417765736f6d652f466f6e742d417765736f6d652f6d61737465722f737667732f736f6c69642f636f67732e737667' width='50' height='50' style='vertical-align:bottom'/> Open Voice Operating System - Buildroot Edition
|
||||
A minimalistic Linux OS bringing the open source voice assistant [ovos-core](https://github.com/OpenVoiceOS/ovos-core) to embbeded, low-spec headless and/or small (touch)screen devices.
|
||||
A minimalistic Linux OS bringing the open source voice assistant [ovos-core](https://github.com/OpenVoiceOS/ovos-core) to embedded, low-spec headless and/or small (touch)screen devices.
|
||||
|
||||
## System.
|
||||
### OpenVoiceOS - Full 64 Bit distribution
|
||||
- Linux kernel 5.15.x (LTS)
|
||||
- Buildroot 2022.02.x (LTS)
|
||||
- OVOS-Core (Latest development version)
|
||||
- Raspberry Pi 3|3b|3b+ (Initial development hardware = 3b)
|
||||
- Raspberry Pi 4 (Current development hardware, minimum recommended RAM 2GB)
|
||||
- Linux kernel 6.1.x (LTS)
|
||||
- Buildroot 2023.02.x (LTS) (With some modification here and there)
|
||||
- OVOS framework / software package utilizing ovos-docker containers (Currently latest alpha/development version)
|
||||
- Raspberry Pi 3|3b|3b+
|
||||
- Raspberry Pi 4
|
||||
- x86_64 Intel based computers (UEFI based)
|
||||
- Open Virtual Appliance (UEFI based)
|
||||
|
||||
## Stats:
|
||||
|
||||
|
|
@ -23,11 +25,6 @@ A minimalistic Linux OS bringing the open source voice assistant [ovos-core](htt
|
|||
|
||||
|
||||
## Getting started.
|
||||
At this moment development is in very early stages and focussed on the Raspberry Pi 3B & 4. As soon as an initial first workable version
|
||||
is created, other hardware might be added.
|
||||
|
||||
### Build Environment
|
||||
|
||||
Only use x86_64 based architecture/ hardware to build the image.
|
||||
|
||||
The following example Build environment has been tested :
|
||||
|
|
@ -37,19 +34,29 @@ The following example Build environment has been tested :
|
|||
- OS: Ubuntu 22.04 LTS desktop
|
||||
|
||||
#### Installing System Build Dependencies
|
||||
The following system packages are required to build the image:
|
||||
Buildroot dependencies must be installed as a prerequisite, assuming apt:
|
||||
|
||||
- gcc
|
||||
- subversion
|
||||
- qttools5-dev
|
||||
- qttools5-dev-tools
|
||||
- python
|
||||
- git
|
||||
- make
|
||||
- g++
|
||||
- curl
|
||||
- wget
|
||||
- qtdeclarative5-dev
|
||||
sudo apt-get install -y \
|
||||
bash \
|
||||
bc \
|
||||
binutils \
|
||||
build-essential \
|
||||
bzip2 \
|
||||
cpio \
|
||||
diffutils \
|
||||
file \
|
||||
findutils \
|
||||
gzip \
|
||||
libarchive-tools \
|
||||
make \
|
||||
patch \
|
||||
perl \
|
||||
rsync \
|
||||
sed \
|
||||
tar \
|
||||
unzip \
|
||||
wget \
|
||||
which
|
||||
|
||||
#### The following firewall ports need to be allowed to the internet.
|
||||
In addition to the usual http/https ports (tcp 80, tcp 443) a couple of other ports need to be allowed to the internet :
|
||||
|
|
@ -57,7 +64,6 @@ In addition to the usual http/https ports (tcp 80, tcp 443) a couple of other po
|
|||
- tcp 21 (ftp PASV) and random ports for DATA channel. This can be optional but better to have this allowed along with the corresponding random data channel ports. (knowledge of firewalls required)
|
||||
|
||||
|
||||
|
||||
### Getting the code.
|
||||
First, get the code on your system! The simplest method is via git.
|
||||
<br>
|
||||
|
|
@ -65,13 +71,6 @@ First, get the code on your system! The simplest method is via git.
|
|||
- git clone --recurse-submodules https://github.com/OpenVoiceOS/OpenVoiceOS.git
|
||||
- cd OpenVoiceOS
|
||||
|
||||
### Patching Buildroot.
|
||||
*(ONLY at the first clean checkout/clone)* If this is the very first time you are going to build an image, you need to execute the following command once;
|
||||
<br>
|
||||
- ./scripts/br-patches.sh
|
||||
<br>
|
||||
This will patch the Buildroot packages.
|
||||
|
||||
|
||||
## Building the image.
|
||||
Building the image(s) can be done by utilizing a proper Makefile;
|
||||
|
|
@ -80,38 +79,9 @@ To see the available commands, just run: 'make help'
|
|||
<br>
|
||||
As example to build the rpi4 version;<br>
|
||||
- make clean
|
||||
- make rpi4_64-gui-config
|
||||
- make rpi4_64-gui
|
||||
- make rpi4_64
|
||||
|
||||
Now grab a cup of coffee, go for a walk, sleep and repeat as the build process takes up a long time pulling everything from source and cross compiling everything for the device. Especially the qtwebengine package is taking a LONG time.
|
||||
<br>
|
||||
(At the moment there is an outstanding issue which prevents the build to run completely to the end. The plasma-workspace package will error out, not finding the libGLESv4 properly linked within QT5GUI. When the build stopped bacause of this error, edit the following file;
|
||||
<br><br>
|
||||
buildroot/output/host/aarch64-buildroot-linux-gnu/sysroot/usr/lib/cmake/Qt5Gui/Qt5GuiConfigExtras.cmake
|
||||
<br><br>
|
||||
at the bottom of the file replace this line;
|
||||
<br><br>
|
||||
_qt5gui_find_extra_libs(OPENGL "GLESv2" "" "")
|
||||
<br><br>And replace it bit this line;<br><br>
|
||||
_qt5gui_find_extra_libs(OPENGL "${CMAKE_SYSROOT}/usr/lib/libGLESv2.so" "" "${CMAKE_SYSROOT}/usr/include/libdrm")
|
||||
<br><br>
|
||||
Then you can continue the build process by re-running the "make rpi4_64-gui" command. (DO NOT, run "make clean" and/or "make rpi4_64-gui-config" again, or you will start from scratch again !!!)
|
||||
<br><br>
|
||||
When everything goes fine the xz compressed image will be available within the release directory.
|
||||
|
||||
|
||||
### Booting image from sd card for the first time (setting up Wifi and backend).
|
||||
1.Ensure all required peripherals (mic, speakers, HDMI, usb mouse etc) are plugged in before powering on your RPI4 for the first time.
|
||||
<br>
|
||||
2. Skip this step if RPI4 is using an ethernet cable. Once powered on, the screen will present the Wifi setup screen ( a Wifi HotSpot is created). Connect to the Wifi HotSpot (ssid OVOS) from another device and follow the on-screen instructions to setup Wifi.
|
||||
<br>
|
||||
3.Once Wifi is setup a choice of Mycroft backend and Local backend is presented. Choose the Mycroft backend for now and follow the on-screen instructions, Local backend is not ready to use yet. After the pairing process has completed and skills downloaded it's time to test/ use it.
|
||||
|
||||
|
||||
### Accessing the CLI.
|
||||
|
||||
- SSH to ip address of RPI4
|
||||
- default credentials 'mycroft/mycroft'
|
||||
When everything goes fine the created images/files will be available within the release directory.
|
||||
|
||||
|
||||
## Documentation.
|
||||
|
|
@ -120,7 +90,8 @@ More information and instructions can be found within the "documentation" folder
|
|||
## Credits
|
||||
Mycroft AI (@MycroftAI)<br>
|
||||
Buildroot (@buildroot)
|
||||
HelloChatterbox (@hellochatterbox)
|
||||
HelloChatterbox (@hellochatterbox)<br>
|
||||
HassOS (@home-assistant)<br>
|
||||
|
||||
### Inspired by;
|
||||
HassOS (@home-assistant)<br>
|
||||
|
|
|
|||
Loading…
Reference in New Issue