Updated Readme file: added main part

This commit is contained in:
Jonas_Jones 2022-02-21 01:58:35 +01:00 committed by GitHub
parent 5e897a6436
commit 8c4cb2a2e6
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1,2 +1,56 @@
# PI-MC-WATCHER
A system that allows Monitoring of Raspberry PI('s) and it's running Minecraft Server(s) on PC and Mac
## What it is about
The system contains of three parts. Those are the **PC Module**, **RPi Master Module** and ** RPi Slave Module**
Required for this to work without any modifications are:
- 1x PC or macboock
- 2x Raspberry PI's with GPIO Pins (Model A, A+, B or B+), any version works (I use a **Raspberry PI 4 B** and **Raspberry PI 1.2 B+**) and needed power, ethernet, etc. -connections
- 2x cooling fan (I used 1x 5V & 1x 12V fan), external 12V power source (or matching one for the large fan)
- 6x GPIO cables
- fan control pcb with control circuit (The needed circuit is described [here](https://github.com/J-onasJones/PI-MC-WATCHER/#fan-control-circuit))
### PC Module
The PC module requests all kinds of system information from both Raspberry PI'S making use of FTP. The Raspberry PI hosts an FTP server from which the PC fetches the text file `output.txt` containing all infos.
### Rpi Master Module
The Rpi Master Module (or Raspberry Pi Master module) gets all sorts of informations from its own system and Minecraft Servers and writes them to the `output.txt` file. It also gets fanspeed requirments from the **RPi Slave Module** making use of binary signal transmission over 2 GPIO pins. This module then controls the fan speeds.
### RPi Slave Module
The Rpio Slave Module transmits its fanspeed requirments over 2 GPIO pins to the **RPi Master Module**.
### Setup
## Raspberry PI basic setup
1. Install a UNIX operating of your choice onto both PI's
2. If both PI's are different, declare the more powerful one as the master and install an FTP server on it
3. Install pytho3 on both PI's
4. Go to the [releases page](https://github.com/J-onasJones/PI-MC-WATCHER/releases) and download the latest release.
5. Copy the single programs to their dedicated devices
6. Make the programs run automatically on launch (optional)
7. Edit **IP adresses**, **ports**, **usernames**, **passwords**, **configs**, etc... on all 3 programs
8. Connect 2 GPIO pins from the Slave on pins `GPIO_17` and `GPIO_18` to the Master pins `GPIO_17` and `GPIO_18` (17 to 17 and 18 to 18)
9. Connect the GPIO pins `GPIO_4` and `3.3V OUt` on both PI'S and pin `GPIO_24`, `GPIO_25` and `5V out` of the Master with the fan control circuit board. For pin mapping, view [here](https://github.com/J-onasJones/PI-MC-WATCHER/#fan-control-circuit).
10. Connect the cooling fans like shown [here](https://github.com/J-onasJones/PI-MC-WATCHER/#fan-control-circuit)
## Fan control circuit
This setup includes a custom designed and built circuit board that manages the cooling fans. The board has the following circuit:
![image](https://user-images.githubusercontent.com/91549607/154872478-d2807b99-3585-4100-b591-f2baa214ea48.png)
### Description
- **S1**: Status Pin for Master PI. Connected to `GPIO_4`
- **S2**: Status Pin for Slave PI. Connected to `GPIO_4`
- **P1**: Power Pin for Master PI. Connected to `3.3V Out`
- **P2**: Power Pin for Slave PI. Connected to `3.3V Out`
- **+ 1**: 12V external Power supply for large cooling fan
- **+ 2**: 5V Power supply for small coolimg fan. Connected to `5V Out` on Master PI
- **- 1**: Ground for 12V external power supply
- **- 2**: Ground for `5V Out` on Master PI
- **\~ 1**: Modulation Pin for large cooling fan. Connected to `GPIO_24` on Master PI
- **\~ 2**: Modulation Pin for small cooling fan. Connected to `GPIO_25` on Master PI
# In-more-depth explanation
//TODO