This repository has been archived by the owner on Jul 7, 2021. It is now read-only.
forked from mainsail-crew/MainsailOS
-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
22 changed files
with
153 additions
and
101 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,79 @@ | ||
# Developing | ||
# fluiddpi | ||
A pi image with Klipper, Moonraker and Fluidd pre-installed. | ||
|
||
## Requirements | ||
This repository contains the necessary code to generate the distribution from an existing Raspbian lite distro image. | ||
|
||
## Where to download? | ||
You can download the latest release [here](/cadriel/fluiddpi/releases/latest/download/fluiddpi.zip). | ||
|
||
Older releases can be found [here](/cadriel/fluiddpi/releases). | ||
|
||
## How to use? | ||
1. Download the image as per above and install on an sdcard like you would any other Raspberry pi image. | ||
2. Optionally, if you require WiFi, configure by editing the `fluiddpi-wpa-supplicant.txt` on the root of the sd card - whilst it is still connected to your computer. | ||
3. Boot your Pi from the new sd card. | ||
4. Log into your Pi via SSH (located at fluidd.local). Default username is `pi` and password is `raspberry`. | ||
5. Best practice would have you; | ||
- `sudo apt-get update` | ||
- `sudo apt-get upgrade` | ||
- `sudo raspi-config` | ||
- Change your password | ||
- Define your timezone via 'Localization Options' | ||
- Optionally Change your hostname | ||
6. Reboot. | ||
|
||
Fluidd will be available at `http://fluidd.local` - and will present an error about a missing `printer.cfg` file. | ||
You should now progress with standard klipper setup, upon which time Fluidd will begin working correctly. | ||
|
||
## Compiling / Developing Quick Start | ||
Regular users of FluiddPI should **not** need to follow any of these steps. This is | ||
for those that wish to compile their own image and / or help in the development | ||
of this project. | ||
|
||
### Requirements | ||
Recommended environment is Ubuntu or similar, with docker and docker-compose installed. | ||
|
||
- bash | ||
- git | ||
- [docker](https://docs.docker.com/engine/install/ubuntu/) | ||
- [docker-compose](https://docs.docker.com/compose/install/) | ||
- [qemu-arm-static](http://packages.debian.org/sid/qemu-user-static) | ||
- [CustomPiOS](https://github.com/guysoft/CustomPiOS) | ||
- [Downloaded Raspbian Image](http://www.raspbian.org/) | ||
- Bash | ||
- Git | ||
- [Docker](https://docs.docker.com/engine/install/ubuntu/) | ||
- [Docker-Compose](https://docs.docker.com/compose/install/) | ||
- QEMU for emulation | ||
- About 5GB of free diskspace for the build | ||
- around ~5gb free space | ||
|
||
### Packages for Ubuntu 18.04/20.04 | ||
** Dekstop variants are known to cause issues during build due to snaps takeing up loop mounts ** | ||
```bash | ||
# Packages for Ubuntu 18.04/20.04 | ||
sudo apt-get install gawk make build-essential util-linux \ | ||
qemu-user-static qemu-system-arm \ | ||
git p7zip-full python3 curl | ||
``` | ||
|
||
## Compiling source | ||
To build; | ||
```bash | ||
git clone https://github.com/raymondh2/MainsailOS.git | ||
cd MainsailOS/ | ||
git clone https://github.com/cadriel/FluiddPI.git | ||
cd fluiddpi | ||
make build | ||
``` | ||
|
||
### Other make options | ||
To test; | ||
```bash | ||
# To exit emulation - Ctrl-a x | ||
./run.sh | ||
``` | ||
|
||
Other make options | ||
```bash | ||
make clean - Clean all previous build items except the source raspian image | ||
make distclean - Clean up the source image and trigger a new download | ||
# Clean all previous build items except the source raspian image | ||
make clean | ||
|
||
# Clean up the source image and trigger a new download | ||
make distclean | ||
``` | ||
|
||
### Build layout | ||
MainsailOS/emulation - Contains dependencies for emulation testing | ||
MainsailOS/src/image - Contains our base raspbian image | ||
MainsailOS/src/workspace - Created during build, and output for compiled images | ||
``` | ||
fluiddpi/ | ||
/emulation - Dependencies for emulation testing | ||
/src/image - Base raspbian image | ||
/src/workspace - Created during build | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,8 @@ | ||
export DIST_NAME=MainSailOS | ||
export DIST_VERSION=0.0.8 | ||
export DIST_NAME=FluiddPI | ||
export DIST_VERSION=0.0.1 | ||
export BASE_IMAGE_ENLARGEROOT=2000 | ||
export BASE_IMAGE_RESIZEROOT=500 | ||
export MODULES="base(network,raspicam,klipper_moonraker,mainsail,mjpgstreamer)" | ||
export BASE_RELEASE_IMG_NAME=fluiddpi-buster-lite-v0.0.1.img | ||
export BASE_IMG_NAME=fluiddpi-buster-lite-v0.0.1.img | ||
export BASE_RELEASE_ZIP_NAME=fluiddpi-buster-lite-v0.0.1 | ||
export MODULES="base(network, raspicam, klipper_moonraker, fluidd, mjpgstreamer, password-for-sudo)" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
7a364204e920931701c9859f74a0cf5067ccbbe0 2020-08-20-raspios-buster-armhf-lite.zip |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
FLUIDD_VAR="This is a module variable" |
Empty file.
File renamed without changes.
File renamed without changes.
20 changes: 15 additions & 5 deletions
20
...m/root/etc/nginx/sites-available/mainsail → ...tem/root/etc/nginx/sites-available/fluidd
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
#!/usr/bin/env bash | ||
# Fluidd installation script | ||
# Installs Fluidd and nginx | ||
# Written by Craig Bassett | ||
# Thanks to Raymond Himle | ||
# GPL V3 | ||
######## | ||
|
||
|
||
# Source error handling, leave this in place | ||
set -x | ||
set -e | ||
|
||
source /common.sh | ||
install_cleanup_trap | ||
|
||
unpack /filesystem/home/pi /home/pi pi | ||
|
||
echo "Installing nginx and Fluidd" | ||
|
||
apt-get update | ||
apt-get install nginx -y | ||
rm /etc/nginx/sites-enabled/default | ||
ln -s /etc/nginx/sites-available/fluidd /etc/nginx/sites-enabled/ | ||
cd /home/pi/ | ||
sudo -u pi mkdir /home/pi/fluidd | ||
sudo -u pi wget -q -O fluidd.zip https://github.com/cadriel/fluidd/releases/latest/download/fluidd_v0.0.3.zip && sudo -u pi unzip fluidd.zip -d /home/pi/fluidd && rm fluidd.zip | ||
# Run installation steps defined above | ||
|
||
# Unpack root at the end, so files are modified before | ||
unpack /filesystem/root / |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
src/modules/mjpgstreamer/filesystem/root/etc/systemd/system/webcamd.service
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.