> 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: