https://github.com/linto-ai/linto-os-generator
Build a LinTO OS Image which boots on Raspberry Pi3
https://github.com/linto-ai/linto-os-generator
arm qemu raspberry-pi raspbian toolchain toolchain-builder vocal-assistant
Last synced: 6 months ago
JSON representation
Build a LinTO OS Image which boots on Raspberry Pi3
- Host: GitHub
- URL: https://github.com/linto-ai/linto-os-generator
- Owner: linto-ai
- License: agpl-3.0
- Created: 2019-06-03T14:49:22.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-07-08T13:59:36.000Z (over 5 years ago)
- Last Synced: 2025-03-25T23:51:19.905Z (7 months ago)
- Topics: arm, qemu, raspberry-pi, raspbian, toolchain, toolchain-builder, vocal-assistant
- Language: Shell
- Homepage:
- Size: 62.5 KB
- Stars: 13
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LinTO-OS IMAGE GENERATOR | Linux ARMv6 #
## Global description ##
__LinTO-OS__ interactive generation / customization tools using ARM emulation in Chroot.
This repository contains system configurations and parameters that can be used to build modular system images that can be used directly on a Raspberry PI3 or compute module3.
This work is also a basis for implementing (non-interactive) installation of the various software packages that will be present on a given "series" of LinTO demonstrators.
This provides all necessary to install and run a LinTO demonstrator.
## Usage for Raspberry (ARM) cross compilation ##
You can use this tool to customize an existing ARM Linux image mounted as loopback device. Once "mounted and prepared" you can chroot into the image and work inside of it. You might want to apt-install some stuff using ARM apt repositories, you can also build and compile programs using ARM gcc...
### Prebuilt image
Configured user : pi
Configured password : pi
Link for this prebuilt image will come fast. Watch for it.
## Prerequisites of the host machine ##
In order to be able to manipulate ARM images directly on an AMD64 / x86_64 desktop computer, we use the qemu emulator. Thus the ARM binaries can be executed on the system running the __generator.sh__ tool.
To install qemu :
```bash
sudo apt-get install qemu-system-arm qemu-user-static kpartx
```
## Usage ##
### You might follow these steps to customize some files in this repo before generating your own LinTO OS Image
- Wifi
Put correct values for your network in :
```bash
./wifi/root_part/etc/wpa_supplicant/wpa_supplicant.conf
```
- SSH keys (useful for starting a ReverseSSH from your LinTO to any remote server), see contents in :
```bash
./base/root_part/home/pi/.ssh/
```
The LinTO private key shall be ./base/root_part/home/pi/.ssh/id_rsa with a chmod 600
## CONFIGURATION ##
- Start building your image using :
```bash
./generator.sh and follows the instructions
```
To create a LinTO image, follow the next steps :
* Use 1 to copy the origin image to the new image
* Use 4 to mount and prepare partitions before Chroot
* Use 6 to enter chroot and manipulate the filesystem (insall custom packages, cross-compile ARM programs...)
* Use 4.1 and 4.2 to install last raspbian packages
* Use 4.xx to download and install LinTO client/server and functional services
* Use 5 to finalize the installation
## LinTO Serial number and server address
(You need to use "enter chroot" once "mount and prepare" is done in the generator script)
Your LinTO needs an unique serial number to get recognized by the server stack. Once LinTO Client stack is installed while generating the OS, you need to edit the LinTO-Client config file in /home/pi/linto-client/terminal/linto.json and put the correct values (server address, serial number...).
You're done !
You can flash your SD card with this whole new image ! Don't forget to expand your filesystem on the target Raspberry Pi device.
## Soundcard
You might use any USB soundcard (Jabra speak for instance)... or a platform specific sound-card like Seeed Respeaker Pi Hat modules. If you want to use this kind of sound-cards, LinTO won't start functional services,like GUI or keyword spotter, until the sound-card is properly attached to the system (install drivers first !).
Raspberry Internal soundcard is disabled in our OS. It shall get enabled... but won't provide any sound input.
If no sound-card is installed, LinTO will boot to a console prompt (where you can install your soundcard driver). Use an external keyboard and CTRL+ALT+F1,F2,F3... to circle through local consoles.
## Raspberry LCD screen rotation
See : #lcd_rotate=2 in /boot/config.txt (inside chroot) or ./base/boot_part/config.txt before creating image.
## Documentations ##
*
*
## Notes ##
You can download the latest raspbian lite image here :