dunkirk.sh
an eink camera running on an rpi zero 2 w
docs: add instructions
+80
-1
+33
-1
README.md
+33
-1
README.md
···
1
1
# Inkpress
2
2
3
-
<img src="https://cachet.dunkirk.sh/emojis/inky/r" width="150" align="right">
3
+
<img src="https://cachet.dunkirk.sh/emojis/inky/r/" width="130" align="right">
4
4
5
5
> ### More deets coming soon 👀
6
6
> An open-source, eink-based, rpi zero 2 w powered, camera.
7
+
8
+
## Setup
9
+
10
+
Put raspberry pi os lite 64-bit onto an SD card using the Raspberry Pi Imager and in the configureation step make sure to 1) add your SSH key and 2) set the user:password to `inky:inkycamera`. Oh and also make sure to add your wifi creds so we can update and install packages.
11
+
12
+
Next you need to configure network over usb so we can ssh in easily and be able to access the photo webserver.
13
+
14
+
Before sticking the card into the rpi, navigate to the boot partition and edit:
15
+
16
+
`config.txt` - add to bottom:
17
+
```txt
18
+
dtoverlay=dwc2
19
+
```
20
+
21
+
and `cmdline.txt` - apphend to the only line:
22
+
```txt
23
+
modules-load=dwc2,g_ether
24
+
```
25
+
26
+
Create empty `ssh` file in boot partition to enable SSH or just click the button in the RPI Imager gui.
27
+
28
+
now ssh in:
29
+
```bash
30
+
ssh ink@inkpress.local
31
+
# Default password: inkycamera
32
+
```
33
+
34
+
The firmware instructions are in [`src/README.md`](src/README.md)
35
+
36
+
### Troubleshooting
37
+
- Ensure you are using the DATA port, not power-only
38
+
- Some systems may need USB Ethernet gadget drivers
7
39
8
40
<p align="center">
9
41
<img src="https://raw.githubusercontent.com/taciturnaxolotl/carriage/master/.github/images/line-break.svg" />
+47
src/README.md
+47
src/README.md
···
1
+
### Installing and Setting Up the Camera Server
2
+
3
+
First, ensure you have the camera module enabled and working:
4
+
5
+
```bash
6
+
rpicam-still -o image.jpg
7
+
```
8
+
9
+
Next, create the camera service file:
10
+
11
+
```bash
12
+
sudo vi /etc/systemd/system/camera.service
13
+
```
14
+
15
+
Create a directory for storing photos:
16
+
17
+
```bash
18
+
mkdir photos
19
+
```
20
+
21
+
Install required Python packages:
22
+
23
+
```bash
24
+
sudo apt update
25
+
sudo apt install python3-picamera2
26
+
sudo apt install python3-websockets
27
+
```
28
+
29
+
Finally start the camera service:
30
+
31
+
```bash
32
+
sudo systemctl daemon-reload
33
+
sudo systemctl enable camera.service
34
+
sudo systemctl start camera.service
35
+
```
36
+
37
+
You can check the status with:
38
+
39
+
```bash
40
+
sudo systemctl status camera
41
+
```
42
+
43
+
Or run the camera server directly with:
44
+
45
+
```bash
46
+
python3 camera_server.py
47
+
```