Bpod｜顶刊实验室使用的开放行为控制器，图解一只感知端口

把动作变成实验事件

Sanworks开放行为控制系统，有南洋理工Nature Neuroscience研究及IBL实际集成证据。选r2+成品主机加自制单端口，逐件原BOM、十章装配照片、光门测试与清水校准；含视频概览及版本差异说明。

alan000

Nature Neuroscience（外部应用研究） 2023

参数信息

r2+行为接口: 5 口

复现文档

01｜选择成品控制器加一只自制端口

### 选择成品控制器加一只自制端口

一台r2+成品主机、其12V阀电源、USB数据线、一根CAT5e和一套自制端口为基础。主机5个行为口但本页只装一只，不称2AFC完整装置。鼻触端口与接口板逐项BOM展开；原主板全BOM另供DIY，避免成品与芯片重复计价。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![01｜选择成品控制器加一只自制端口图解](https://cdn.lunlunapp.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/cover/4458de5a16764ab793213fa63e0f356b.png)

![01｜选择成品控制器加一只自制端口图解](https://cdn.lunlunapp.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/cover/ad9a3336b0a94cfd8fede760dcf60d49.png)

02｜打印结构并备齐端口小件

### 打印结构并备齐端口小件

采用原CAD当前修订，核壳体、护套、底座、15Ga钢管与M4螺孔。旧图透光XT覆盖传感器，有些打印件透光不良；原作者推荐当前外露传感器版。剪6根70mm的22AWG线：红紫各3；两端各剥4mm，另备6段12mm热缩管。钢管原料切35mm并去毛刺。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![02｜打印结构并备齐端口小件图解](https://cdn.lunlunapp.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/cover/d984d956ae5b442f89f4496d213194d5.png)![mbp-wirestrip.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/3da9e195eff145cc82b7c9a91a26953d.png)

03｜焊接红外、接收器和LED

### 焊接红外、接收器和LED

先按数据手册确认发射器、光电晶体管引脚，不仅靠照片左右猜极性。原图将紫线接地、红线接正；白LED长脚为正极。焊前套热缩管，焊后逐点绝缘；保留足够引线，避免拉力落在器件脚上。导通检查排除红紫短路。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![mbp-ir-solder.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/41947f5ab67349e090418c14024d22b2.png)![mbp-repeat-solder.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/d6e1bf730e984b9d8e99b0c642132b6e.png)

04｜装钢管、白LED与红外对管

### 装钢管、白LED与红外对管

原装配M4孔与16mm尼龙螺钉，工具段却写M3丝锥，按现版CAD核实后加工。装35mm去毛刺钢管、压入白LED，再装螺钉和对管。面对端口、钢管在下时，蓝色发射器右侧、黑色接收器左侧。传感器不得被打印毛边遮挡。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![mbp-port-tap.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/a5a094d6c3254ffd8c006392181aa13c.png)![mbp-insert-tube.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/76203089cf684ca89cc5a425a63b89fe.png)![mbp-led-fit.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/f0760506373d4b3da773b96847a76005.png)![mbp-ir-fit.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/43ea142a859d4c41ac32d864ba19fa28.png)

05｜装护套并焊通孔接口板

### 装护套并焊通孔接口板

端口压入配套护套，线从出口整理。接口板按10Ω、499Ω、15kΩ逐一核阻值，依次焊电阻、500Ω电位器、六位/两位端子和RJ45，核原理图每根线的定义。用M3支柱隔离PCB底面，装原Lee阀及封帽；阀的流向和封口按实际型号核实。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![mbp-sheath-press.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/8c6ab8c525264a16bb3279bb590f0086.png)![mbp-complete.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/d20678b955b840fbb0b67f187e53d4ee.png)![port-breakout-board-assembly.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/b63eb7b1ef5b4cbb90275a32914683bf.png)

06｜建立专用连线与清水回路

### 建立专用连线与清水回路

断电连传感器/LED至接口板、阀至两位端子，再用CAT5e接主机行为口1。RJ45是专用电路接口，不接以太网交换机。主机USB接电脑，原12V适配器只供阀侧。高位储液器经软管接阀入口，出口接钢管，出水落入容器；液体远离PCB，先排泡、检漏、固定液面高度。软管和接头采购规格未完全闭合，实施前先确认。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![06｜建立专用连线与清水回路图解](https://cdn.lunlunapp.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/cover/ad9a3336b0a94cfd8fede760dcf60d49.png)![port-interface-board.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/8aabf307df554003a9d90146705e7556.png)

07｜安装API、识别r2+与固件

### 安装API、识别r2+与固件

Windows安装说明要求MATLAB r2013a+；Bpod_Gen2只把根目录Add Path，不Add with subfolders。成品机已有固件，先核设备型号和系统信息；本提交CurrentFirmwareList为23.10。需要更新时到独立StateMachine固件仓库选择r2+预配置，不能刷成其他Arduino程序。MATLAB商业许可单独准备；不承诺旧PyBpod支持r2+。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![bpod-console.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/6d309a259c7c408a94ecf83d05cff7ee.png)![pitfalls.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/80053b1872f945c28edfcfcea2d081c1.png)

08｜先做无动物、无自动给液的光门测试

### 先做无动物、无自动给液的光门测试

仅使能已接的端口1。用不透明卡片遮挡/离开光门，检查Port1In、Port1Out与控制台指示；手动切换LED亮灭和强度。先断开阀电源学习OneState/TwoState状态机构建、保存事件数据，避免默认协议自动给液。当前Operant例程明确使用1和3两口，本页单口不能原样跑成完整任务。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![08｜先做无动物、无自动给液的光门测试图解](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/6d309a259c7c408a94ecf83d05cff7ee.png)![mouse-behavior-port.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/4f6edafc2e9d4d73aa4a88d462ed07b5.png)

09｜清水称重并建立本机阀校准

### 清水称重并建立本机阀校准

确认无泄漏后接阀电源，用手动VLV短开关检验。Settings进入液体校准，选端口1，多个开阀时长分别累计脉冲出水，称容器去皮后的净质量，按水密度换算每次体积；固定液面高度和软管。原界面可Suggest Points、Measure Pending，并用Test curve累计100脉冲复核。示例校准文件必须替换，不把GUI默认5µL当本机已准确出水。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![liquid-calibration-menu.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/3bc0e84fb4a340a69d25f462ac654a28.png)![liquid-measurements.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/eba9449851124060964bb68f83263c79.png)![liquid-curve-test.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/82fe3c66f9ee4780a0635d112dcbc8b6.png)

10｜保存证据，再扩展科研任务

### 保存证据，再扩展科研任务

归档板号、固件/API、端口照片、手动遮挡事件、阀称重原始记录和曲线检验误差。调阀后、换管后或液面改变后重查；时间性能需示波器量测，GUI反应速度不是硬件延迟。本文只覆盖单端口台架，真正动物研究需机构批准的方案与设施；多口选择任务、声刺激、成像同步均另补设备和协议。

[原端口图解](https://sanworks.github.io/Bpod_Wiki/assembly/mouse-behavior-port-assembly/) · [接口板](https://sanworks.github.io/Bpod_Wiki/assembly/port-breakout-board-assembly/) · [锁定API与例程](https://github.com/sanworks/Bpod_Gen2/tree/8e5b008dc235c3f30ae371c6831f3e59e4ea1ec9)

原图Sanworks，Bpod Wiki GPL v3；中文整理保留出处。台架人工遮挡与清水测试，不含动物实验。本站未实制或运行设备。

![10｜保存证据，再扩展科研任务图解](https://cdn.lunlunapp.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/cover/ad9a3336b0a94cfd8fede760dcf60d49.png)

![10｜保存证据，再扩展科研任务图解](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/cb4a488f-3991-4254-9aa1-e2ec683ab96b/files/image/80053b1872f945c28edfcfcea2d081c1.png)