> For the complete documentation index, see [llms.txt](https://khalil-lab.gitbook.io/evolver/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://khalil-lab.gitbook.io/evolver/guides/raspberry-pi-configuration.md). # Raspberry Pi Configuration Please see the [Raspberry Pi](/evolver/hardware/raspberry-pi.md) infrastructure page for additional information on the RPi we use for the eVOLVER. {% hint style="danger" %} Be sure to [update the server code](/evolver/guides/updating-the-evolver-server.md) on the RPi after following this guide, or you will have issues communicating with the server through the DPU or with actuating/sensing connected components! {% endhint %} [RPi Imager Guide](#using-raspberry-pi-imager) - **Recommended** [Command Line Guide (Mac/UNIX only)](#using-command-line-utilities-mac-unix-only) ### Using Raspberry Pi Imager **1.** Download the pre-configured eVOLVER RPi image [here](https://drive.google.com/file/d/1yDQ_HLA8o-DooAyxWKPMJJNqN8z-LEy3/view?usp=sharing). **2.** Download and install the [Rapberry Pi Imager Tool](https://www.raspberrypi.com/software/). ![](/files/Cp51MSbUqSFo6irmQkfM) **3.** Plug an 8GB micro-SD for the RPi into an adapter, then into a the computer. **4.** Click the `Choose OS` button, then scroll to the bottom and click `Use Custom`. ![](/files/QItYRze3RIZI4zSzJzC2) ![](/files/e1k6fzsR9EMXrMw5iFe0) **5.** In the popup at the dropdown at the bottom of the window, select `All files(*.*)`. Then select the image file downloaded in Step 1. ![](/files/2wqHPeylkLETNCyp31Pm) **6.** Click the `Choose Storage` button and select the SD Card. ![](/files/nENSFaak9n3zYxjYJLrE) **7.** Click the `Write` button. A notification might appear warning about erasing all existing data on the card. Click `Yes`. If it asks for your computer password afterwards, enter it. It might take a while to finish (\~40m). **8.** When it completes, you can plug the SD card into the RPi. You will need to [update the server code](/evolver/guides/updating-the-evolver-server.md) and potentially the `conf.yml` with the latest code from GitHub. ### Using command line utilities (Mac/UNIX only) **1.** Download the pre-configured eVOLVER RPi image [here](https://drive.google.com/file/d/1yDQ_HLA8o-DooAyxWKPMJJNqN8z-LEy3/view?usp=sharing). **2.** Plug the SD card into the computer. **3.** Open a terminal of your choice (I recommend [iTerm2](https://iterm2.com/)). **4.** Run the following command: `diskutil list` Identify the SD card name from this (it should be obvious). Next run: `diskutil unmountdisk ` where \ is the name you identified from the previous command - it should look like `/dev/disk3/` or something similar. **5.** Use the `dd` command to copy the image onto the SD card: `sudo dd bs=4m if= of=` {% hint style="warning" %} Be sure to change the two arguments above! `if` should point to the image you downloaded from step 1, and `of` should be the diskname. {% endhint %} This command can take a while, and it doesn't show any status or progress updates - be patient. If it fails, try decreasing the `bs` argument to `1m` instead of `4m` - this will slow things down but will decrease the chance of failure. If you still have issues reach out on the [forum](https://www.evolver.bio/). **6.** When it completes, you can plug the SD card into the RPi. You will need to [update the server code](/evolver/guides/updating-the-evolver-server.md) and potentially the `conf.yml` with the latest code from GitHub. ## Backing Up Raspberry Pi (Make a Custom Image) Writing an image to save your full Raspberry Pi configuration. Useful to save time when reimaging your Raspberry Pi if you want to go back to your custom Python code and calibrations as quickly as possible. Follow this guide: --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://khalil-lab.gitbook.io/evolver/guides/raspberry-pi-configuration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.