Skip to the content
2 layers27 × 7.6 mmLED FPC, the printed circuit board in 3D

A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

Size
27 × 7.6 mm
Copper layers
2
Thickness
0.2 mm
Parts
7
Nets
2
Pads
16
Tracks, vias
31, 14
Pours
2
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
7 Sep 2025
Updated
6 Nov 2026

Overview

LED FPC is an open-source printed circuit board by Neurallabware, from the Neurallabware/Airscope_toolbox repository on GitHub. It is a 2-layer board of 27 × 7.6 mm with 7 parts on 2 nets, routed with 31 tracks and 14 vias.

It is built around the LXZ1-PB01 and PAD1. Its parts include 6 ICs and 1 connector.

Main components

2

README

README.md

Airscope

Airscope

A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

Device Docs · Software Docs · Data Release


Airscope is an open hardware and software platform for wireless mesoscopic calcium imaging in freely behaving mice. The device achieves a 6 mm field of view at ~4 µm lateral resolution, streams or logs 1600 × 1200 px images at 10 Hz, and weighs approximately 1 g.

Airscope examples

This repository accompanies the manuscript:

Deciphering cortex-wide neural dynamics of naturally behaving mice by a 1-gram wireless mesoscope Zhang et al., Nature, 2025 (Manuscript in preparation)


Repository Structure

DirectoryDescription
Structure/SolidWorks assemblies and part files — housing, baseplate, optical mount, PCB carrier, flexible LED board
Zemax/Zemax optical design files for the aspheric module
Electronics/KiCad projects for the main PCB and auxiliary boards
Firmware/Embedded code for wireless control, camera acquisition, and device configuration
DAQ_software/Python host software and Windows installer for device discovery, preview, and recording
Software/Calcium-imaging processing, behavioural segmentation, and neural-decoding pipelines
Data_release/Example datasets, visualization notebooks, and download instructions

Key Capabilities

  • Cortex-wide cellular imaging — 6 mm FOV with single-cell spatial resolution across the dorsal cortex
  • Untethered operation — wireless data transfer and on-board logging for freely moving, multi-animal, and aquatic paradigms
  • Integrated acquisition stack — firmware + host software for discovery, preview, timestamping, and recording
  • Reproducible calcium processing — motion correction → background removal → neuron segmentation → trace extraction
  • Behavioural analysis — SAM2Mice for multi-animal tracking; Neuron-BERT for decoding social-interaction outcomes

Software Modules

Calcium-imaging processing · Software/Airscope_ca_processing

End-to-end pipeline from raw frames to segmented ROI traces. Accepts image sequences, TIFF stacks, and MP4 input; configured with Hydra for reproducible batch runs.

bash
cd Software/Airscope_ca_processing
conda create -n PICO python=3.10 && conda activate PICO
pip install -r requirements.txt && pip install -e .
bash
airscope-process \
  data_path=/path/to/session/frames \
  out_path=/path/to/session/analysis \
  rmbg.gpu_ids=0 rmbg.multi_gpu=false

Primary outputs: seg_results_filtered.mat, infer_results_filtered.mat, cm_filtered.mat


SAM2Mice · Software/SAM2Mice

SAM 2–based mouse segmentation and tracking. Supports manual prompts, YOLOv11 auto-prompts, and bootstrapped inference for videos that exceed GPU memory.

bash
cd Software/SAM2Mice
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/cu124
pip install -e ".[notebooks]" && python setup.py build_ext --inplace

Notebooks in Software/SAM2Mice/notebooks_SAM2-MICE cover basic segmentation, long-video bootstrapping, automatic tracking, and public-dataset examples.


Neuron-BERT · Software/Neuron_BERT

Transformer-based decoder for predicting social-interaction outcomes from dual-animal neural activity recordings.


Host acquisition software · DAQ_software/

Dependency-free Python backend — runs without any additional packages:

bash
cd DAQ_software/airscope_pybackend
python server.py
# UI available at http://127.0.0.1:8765/

A packaged Windows installer is also provided at DAQ_software/airscope.msi.


Data Release

Example datasets are hosted on Google Drive and documented in Data_release/README.md. The Google Drive root README is maintained at Data_release/README_google_drive.md and can be uploaded to Drive as README_google_drive.md.

DatasetContents
Enriched habitatCalcium traces, multi-view behaviour videos, detection boxes, arena annotations, cortical labels, neuron centroids
Multi-animal interactionCalcium traces, SAM2 instance masks, mouse trajectories, cortical labels, neuron centres
MCU timestampFrame-rate validation files; use calculate_frame_rate.ipynb to verify
Optical characterisationUSAF 1951 target images and fluorescent grid slides

Each dataset directory includes a README.md and a visualize_data.ipynb notebook.


Requirements

ComponentEnvironment
Host acquisition softwarePython ≥ 3.9, standard library only
Calcium processingLinux, Python 3.10, CUDA-enabled PyTorch recommended
SAM2MicePython 3.11, PyTorch 2.6.0, CUDA 12.4
Neuron-BERTPython 3.x, PyTorch, NumPy, scikit-learn, pandas, matplotlib

See the component-level README.md files for exact commands and configuration.


Licensing

Airscope is distributed as a multi-licence repository:

MaterialLicence
Hardware design (Structure/, Electronics/, Zemax/)CERN-OHL-S-2.0
Software (DAQ_software/, Firmware/, Software/)GPL-3.0-only
Documentation, figures, notebooks, released dataCC-BY-4.0

See LICENSE, LICENSES/, and NOTICE.md for the authoritative licence map and third-party notices.


Citation

bibtex
@article{airscope2025,
  title   = {Deciphering cortex-wide neural dynamics of naturally
             behaving mice by a 1-gram wireless mesoscope},
  author  = {Zhang, Yuanlong and Li, Angran and Yuan, Lekang and
             Wang, Mingrui and Zhao, Weihao and Wang, Zhenbo and
             Zang, Boyang and Zhou, Yangxuan and Yu, Tao and Gao, Lin
             and Wu, Yu and Zhu, Rongkang and Tian, Mengyi and Li, Kun
             and Wu, Jiamin and Dai, Pu and Dai, Qionghai},
  journal = {Nature},
  year    = {2025},
  note    = {Manuscript in preparation}
}

Documentation

Contact

Questions, bug reports, and suggestions can be submitted via the issue tracker or sent to the corresponding authors listed in the manuscript.

Parts

7
QtyValueFootprintReferences
4LXZ1-PB01Pico:LXZ1-PB01U1, U2, U3, U4
2Pad1Pico:Rec_Pad_1U5, U6
1BM29B-2DP_2-0.35V_51_Snapeda:BM29B-2DP_2-0.35V_51__HRS_BM29B-2DP_2-0.35V_51_J1

More from Neurallabware/Airscope_toolbox

6
  • 6 layers12.8 × 11.4 mmMain PCB, the printed circuit board in 3D

    Main PCB

    Neurallabware/Airscope_toolbox

    A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

    31 parts10
  • 4 layers7.9 × 9.3 mmExt IMU, the printed circuit board in 3D

    Ext IMU

    Neurallabware/Airscope_toolbox

    A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

    15 parts10
  • 2 layers23.4 × 17 mmPower FPC, the printed circuit board in 3D

    Power FPC

    Neurallabware/Airscope_toolbox

    A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

    11 parts10
  • 2 layers9.4 × 8.8 mmBurning, the printed circuit board in 3D

    Burning

    Neurallabware/Airscope_toolbox

    A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

    8 parts10
  • 2 layers6.5 × 9 mmExt basic, the printed circuit board in 3D

    Ext basic

    Neurallabware/Airscope_toolbox

    A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

    7 parts10
  • 2 layers10.8 × 22 mmSD reader, the printed circuit board in 3D

    SD reader

    Neurallabware/Airscope_toolbox

    A 1-gram wireless mesoscope for cortex-wide, single-cell-resolution imaging during unrestricted behaviour

    2 parts10

Similar boards

  • 6 layers33.7 × 56.9 mmKicad LFOV RigidFlex Assembly, the printed circuit board in 3D

    Kicad LFOV RigidFlex Assembly

    Aharoni-Lab/Miniscope-LFOV

    Large field-of-view miniature microscope for rats and larger animals.

    108 parts18GPL-3.0
  • 6 layers27.6 × 12.3 mmMiniscope v4-Wire Free, the printed circuit board in 3D

    Miniscope v4-Wire Free

    fnsangiul/Miniscope-v4-Wire-Free

    Wire-free Miniscope v4 system

    117 parts2
  • 4 layers33 × 16 mmMiniXL, the printed circuit board in 3D

    MiniXL

    miniscope/MiniXL

    An open-source, large field-of-view epifluorescence miniscope enabling single-cell resolution and multi-region imaging in mice

    99 partsGPL-3.0
  • 4 layers27.3 × 31.8 mmWLMS v0 2 9 daughterboard, the printed circuit board in 3D

    WLMS v0 2 9 daughterboard

    miniscope/MiniscopeZero

    Miniscope Zero hardware and software

    43 parts2CERN-OHL-S-2.0
  • 2 layers180 × 110 mmISD1700 sampler main board, the printed circuit board in 3D

    ISD1700 sampler main board

    hiro-akihabara/OpnBeat

    OpnBeat is open source Lo-fi sampler project

    180 parts67GPL-3.0
  • 2 layers87.3 × 86.3 mmDonut, the printed circuit board in 3D

    Donut

    cnlohr/donut

    MAGFest /is/ a donut.

    54 parts8

Questions

How big is the LED FPC PCB?

It measures 27 × 7.6 mm and has 2 copper layers, 0.2 mm thick.

What parts does the LED FPC use?

7 parts, built around the LXZ1-PB01 and PAD1. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the LED FPC KiCad files?

From the Neurallabware/Airscope_toolbox repository on GitHub, at the commit this page was made from: the board is Electronics/LED FPC/LED FPC.kicad_pcb and its schematic Electronics/Auxiliary/Burning/Burning.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the LED FPC design in my own project?

Its repository states no licence, so its author keeps all rights: ask Neurallabware before reusing the design.