Initial Setup
Preliminary Steps
If you purchased a Training Village from us, the system arrives fully pre-assembled. However, should you ever need to assemble or adjust any components yourself, the process is straightforward: follow the Assembly Guide.
We provide the Raspberry Pi along with an SD card that already contains the operating system (Raspberry Pi OS) and all required software pre-installed. If you ever need to write this image onto a new SD card yourself, see Raspberry Pi Disk Image for the image and step-by-step instructions.
Build-It-Yourself
If you prefer to build the Training Village yourself, start by reviewing the complete list of required parts and the plans for all 3D-printable pieces in List of Parts & Design Files. Once you have your own Raspberry Pi, you can either copy the Raspberry Pi Disk Image onto its SD card or install everything from scratch.
Hardware Connections & First Boot
Never hot-plug
Make all the connections with both power supplies unplugged. Never plug or unplug a board, cable or peripheral while the system is powered.
The system uses two power supplies, both labeled in the picture below:
The Raspberry Pi power supply (the official 27 W USB-C supply) powers the Raspberry Pi itself.
The 5V power supply (5 V, 3 A, connected to the Main HAT) powers the satellite boards and what is connected to them: servo motors, lighting, LEDs…
Connect the Corridor Board to the Main HAT with its two cables: the Ethernet cable (data) and the DC barrel jack cable (5 V power). It is vital to use the correct ports, as the Main HAT features two sets of connectors: one labeled Corridor and one labeled Box. If your configuration uses the Box Board (for operant box lighting or other peripherals), connect its cables to the Box ports at this time.
If your experimental paradigm integrates a Bpod (or any other external behavioral controller), connect its USB cable to the bottom USB 3.0 port (the blue port closest to the Raspberry Pi’s native Ethernet jack).
To complete the initial setup, configure the internet connection, and enable remote management, you will temporarily need local access to the system. Connect a keyboard, a mouse, a monitor and, if you use a wired connection, a network cable to the Raspberry Pi. Connect the monitor to the first micro-HDMI port (screen 1 in the picture); the second one is for the screen inside the operant box, if you use it (see Screen & Touchscreen).
Connect the 5V power supply to the power input barrel jack located on the Main HAT. Using a 3 A power source is mandatory to ensure there is enough current to reliably power all visible and IR illumination LEDs simultaneously.
Finally, connect the Raspberry Pi power supply to the Raspberry Pi’s USB-C connector; the Raspberry Pi 5 will boot up automatically.
The connectors of the Main HAT (left) and of the Raspberry Pi (right). Click to enlarge.
Setting Up the OS
Go to
Preferences->Control Centreand select the tabLocalisation.Configure your country, timezone, keyboard layout, and language preferences.
Connect to the internet: select your Wi-Fi network from the network icon in the top bar, or check that the network cable is connected.
Go to
Preferences->Control Centreand select the tabSystem. By default, the pre-configured system image uses:Username:
piPassword:
training_village
Leave the username as
pi, but change the password to a secure one of your choice.