> For the complete documentation index, see [llms.txt](https://principiot.gitbook.io/principiot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://principiot.gitbook.io/principiot-docs/f7-pi/raspberry-pi-setup.md).

# Raspberry Pi Setup

To simplify initial setup, we’ve put together a prebuilt Raspberry Pi OS image available in the F7 Pi resources folder, or directly [here](https://drive.google.com/file/d/1JFAJ6t3ncqmPcAnK4fCNaDqEIinyN9Ai/view?usp=drive_link). We recommend flashing this image to the SD card using the [Raspberry Pi Imager](https://www.raspberrypi.com/software/) software or [Balena Etcher](https://etcher.balena.io/).

### Features

* USB Ethernet support. Plug the Raspberry Pi into a computer with a Micro-USB data cable and it will automatically show up as a network interface. The Raspberry Pi can be accessed at the IP address 10.0.0.1. 
* Video streaming. The Raspberry Pi will automatically detect any attached Raspberry Pi camera, and begin streaming video over WiFi (if configured) and the USB Ethernet connection. View the stream in any browser at http\://\<Raspberry Pi IP>:8889/cam
* Serial port bridging. The Raspberry Pi shares a serial port with the Flight Controller which is bridged to the network by default. Use the URL tcp\://\<Raspberry Pi IP>:5000 in INAV or Betaflight configurator to remotely connect to the Flight Controller.&#x20;
* Composite video output. The Raspberry Pi by default will show a console view on the composite video output, but by running a script, it will display the Raspberry Pi Camera’s video on the output. There is currently a known limitation where video cannot be streamed and displayed on the composite video output at the same time.&#x20;

### Important information

* The default login is username “pi” and password “raspberry”.&#x20;
* SSH is enabled on port 22, this is the easiest way to log into the Raspberry Pi and change settings.
* When connected over USB Ethernet, the Pi will be at IP address 10.0.0.1.&#x20;
* To connect to a WiFi network, login over SSH then run sudo raspi-config, then select the first option.

### Technical notes

* Video streaming is powered by the open source MediaMTX software. See the service file at /etc/systemd/system/mediamtx.service and configuration file at /opt/mediamtx/mediamtx.yml for more information.
  * The configuration file controls resolution, framerate, and camera properties while streaming.
* Composite video output is controlled by a service file. See /etc/systemd/system/composite-video.service for more information.&#x20;
* UART bridging is provided by ser2net, see the service file at /etc/systemd/system/ser2net.service and the configuration file at /etc/ser2net.conf for more information.&#x20;