Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Instruction clarifications #2

Merged
merged 2 commits into from
Nov 6, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions PARTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Recommended Parts list
These are the parts I used to build the camera. You could substitute other functionally equivalent parts if needed (USB power instead of POE+ HAT and header extensions, other microSD cards, lenses, camera modules, etc).
- Raspberry Pi 4B [Adafruit](https://www.adafruit.com/product/4296)
- Raspberry Pi High Quality HQ Camera [Adafruit](https://www.adafruit.com/product/4561)
- Raspberry Pi PoE+ HAT [Adafruit](https://www.adafruit.com/product/5058)
- Raspberry Pi 4 Pro Mounting Plate for HQ Camera [Adafruit](https://www.adafruit.com/product/5026)
- GPIO Female Socket Riser Header - 2x2 4-pin [Adafruit](https://www.adafruit.com/product/4855)
- GPIO Stacking Header for Pi A+/B+/Pi 2/Pi 3 - Extra-long 2x20 Pins [Adafruit](https://www.adafruit.com/product/2223)
- Waveshare Industrial Zoom Lens 8-50mm [Amazon](https://a.co/d/9OnPh5z)
- PNY 32 GB microSD Card [Amazon](https://a.co/d/dV6UQZt)
- M2.5 Brass Standoff kit [Amazon](https://a.co/d/1kkJjir)
- Momentary switches with 2 pin female header [Amazon](https://a.co/d/fanJkFU)

# Build instructions
1. Use brass standoffs to attach the camera module to the mounting plate.
2. Attach the FPC cable (included with camera module) to the camera module. The blue panel shoul face away from the camera module.
3. Attach the other end of the FPC cable to the Rasberry Pi's camera connector (near the USB ports). The blue panel should face the USB ports.
4. Use brass standoffs to attach the Raspberry Pi to the mounting plate. Take care to route the FPC cable towards the microSD card slot, between the Raspberry Pi and the mounting plate.
- If you are using the POE+ HAT, make sure to use the appropriate standoffs and header extensions so they can stack properly.
5. Attach a switch to the two GPIO pins closest to the ethernet port.
6. Insert the prepared microSD card into the microSD card slot.
7. Attach the lens to the camera module.
- The Waveshare lens above is a C-mount lens and uses the ring included with the HQ camera module. Other lenses may vary.
9. Build is complete! Power on the camera using the chosen power method.
- If using the camera in HDMI mode, connect a micro HDMI to HDMI adapter and press the switch to change modes once it it fully powered on.
20 changes: 4 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,27 +14,15 @@ This software is tested with Raspberry Pi 3B+ boards. Some users have had succes
Raspberry Pi 3b+ = ~600ms
Raspberry Pi 4b (4GB Model Tested) = ~200ms

## Getting started - pre-compiled

Against the latest relase there are three files you need:

- raspindi-${arch}
- libndioutput-${arch}.so
- libndi-${arch}.tar.gz

You will need to download the config file: `wget -o /etc/raspindi.conf https://raw.githubusercontent.com/raspberry-pi-camera/raspindi/main/etc/raspindi.conf.default`

Put the two sets of libraries in /usr/lib, and the raspindi binary somewhere in your PATH (eg /usr/local/bin), and run it

## Getting started - compile your own

These intructions are for a clean installation of [Raspberry Pi OS](https://www.raspberrypi.org/software/). All steps are performed on the command line.

### tl;dr

- `git clone https://github.com/raspberry-pi-camera/raspindi.git && cd raspindi`
- `git clone https://github.com/SBCV-apegram/RasPi-NDI-HDMI.git && cd RasPi-NDI-HDMI`
- `./easy-setup.sh`
- `/opt/raspindi/raspindi.sh`
- `/opt/RasPi-NDI-HDMI/RasPi-NDI-HDMI.sh`

### Step by step

Expand All @@ -48,7 +36,7 @@ sudo apt install git
Clone this repository and `cd` into it.

```
git clone https://github.com/raspberry-pi-camera/raspindi.git && cd raspindi
git clone https://github.com/SBCV-apegram/RasPi-NDI-HDMI.git && cd RasPi-NDI-HDMI
```

Install compilation dependencies.
Expand Down Expand Up @@ -81,7 +69,7 @@ sudo apt install libavahi-client3 libevent-pthreads-2.1-7 libevent-core-2.1-7
Run it. (It does not require root to run.)

```
/opt/raspindi/raspindi.sh
/opt/RasPi-NDI-HDMI/RasPi-NDI-HDMI.sh
```

Open an NDI receiver somewhere on the same network. It should detect the Raspberry Pi camera after a few seconds.
Expand Down