title	author
CageLab	Ian Max Andolina

Table of Contents

1. Introduction
2. Installation
3. Dependencies
4. Usage
5. Parts List
6. Architecture
7. Contributing
8. License

Introduction

{width=50%}

CageLab is a low cost in-cage touchscreen training device that prioritises the following features:

1. Customisable: The device should be customisable to suit different facility needs. We employ a modular design using T-slot framing for the shell to allow for easy modification without needing a full workshop.
2. Scalable: Integration with the Alyx metadata pipeline (International Brain Lab, 2023, Nature Methods) to allow for easy management of the data generated by multiple CageLab instances. Each device uploads behavioural data to a central server, which can be accessed and searched by the user through a web interface.
3. Automatic Training: Use behavioural shaping stages with an automated staircase to guide subjects to improved behavioural performance with less experimenter intervention.
4. Low Cost: CageLab should be affordable for most research labs. We aim to keep the total cost of the device below $400.
5. Single-enclosure & Battery Operated: Many animal facilities do not have accesible power outlets near animal housing, or do not want cables or extra trolleys. The device should be self-contained and battery operated. We added a small UPS to enable hot-swapping of batteries.
6. Open Source: The device software should be open source and easy to contribute to.
7. Common Software Path: The device should be easy to use and maintain; we use PsychToolbox (PTB) for easy integration with existing code common in most labs where PTB is prevalent. PTB offers best-in-class experiment timing and a wide range of specialised hardware support.
8. Modular: We have the following modules to use with the device:
   • Fluid Pump: Peristaltic pump, HID interface and costs about $10.
   • Food Dispenser: A pellet dispenser using an arduino driver.
   • Camera: A camera to record the animal's behaviour and stream it over the network.
   • Speaker: A speaker to play sounds.
9. Remote Control: The device must be controllable remotely. We use the fast moonlight remote desktop protocol and server + client protocols where useful.

Installation and Setup

Multi-Cage Setup

CageLab is designed to be used in a multi-cage setup. Each CageLab instance is connected to a central Alyz server that manages the data generated by each device. The server is accessible through a web interface that allows the user to search and download the data generated by each device. The experiment control software is run on a remote desktop that is connected to the device through the ZeroMQ client server protocol. The remote desktop allows the user to control the device from a distance and monitor the animal's behaviour through a camera that is connected to the device.

Hardware

Software

You need Octave / MATLAB, PTB and the opticka toolbox installed as dependencies. For remote desktop, you need to install moonlight on the device and the client.

Dependencies

• matmoteGO
• cogmote
• cogmoteGO
• streaming Construction in progress
• PTBSimia

Parts List

Architecture

Power supply architecture

Poe solution

In previous version, we need to use power bank to power the device, but it is limiting the time of use. So we try to use poe to power the device.

need poe IEEE 802.3bt and 802.3at protocol

Expermimental feature!!!

DC HUB was dangeous!!!

---
title: Power supply architecture with poe
---
graph LR
    subgraph Poe Router / Power Supply
    A
    F
    end
    A[IEEE 802.3bt terminal] -->|60 wt| B[poe++ splitter]
    A -->|Net connection| B
    B -->|24v| C[24v to 19v]
    B -->|Net connection| E[Mini PC]
    C -->|19v| D[DC UPS]
    D -->|19v| E
    F[IEEE 802.3at terminal] -->|30 wt| G[poe+ splitter]
    G -->|12v 2.5A MAX| H[DC HUB]
    H -->|12v| I[Pump]
    H -->|12v| J[Display]
    H -->|12v| K[speaker]
    H -->|12v| L[Sensors]
    F -->|Net connection| M@{ icon: "material-symbols:auto-delete"}
    subgraph payload
    E
    I
    J
    K
    L
    end

Loading

Power bank solution

---
title: Power supply architecture with power bank
---
graph LR
    subgraph Power Bank / Power Supply
    A[PD power bank]
    E[DC power bank]
    end
    A[PD power bank] --> B[PD to dc]
    B -->|19v| C[DC UPS]
    C -->|19v| D[Mini PC]
    E[DC power bank] -->|12v| F[Pump]
    E -->|12v| G[Display]
    E -->|12v| H[Sensors]
    E -->|12v| I[speaker]
    subgraph payload
    D[Mini PC]
    F[Pump]
    G[Display]
    H[Sensors]
    I[speaker]
    end

Loading

Contributing

Please feel free to open issues or pull requests. We are happy to help you get started with CageLab. We are also looking for collaborators to help us improve the device.

License