概述
ID05 线站使用 spec 软件（Certified Scientific Software）控制六圆衍射仪、GIWAXS 测试台及其他硬件。 本章节汇总了 B9 线站 SPEC 中涉及的电机命名、常用操作命令及衰减片配置方法， 供线站用户和值班人员查阅。
一、电机命名与含义
下表列出 B9 线站 SPEC 中所有可控电机的名称、mnemonic 及功能说明。
6 圆衍射仪
| Name | Mnemonic | 说明 |
|---|---|---|
| y1_align | _zt1 | 衍射仪平台向上电机 1（一般不单独运动） |
| y2_align | _zt2 | 衍射仪平台向上电机 2（一般不单独运动） |
| Y table | Ztable | _zt1 与 _zt2 联合运动，实现衍射仪上下平动 |
| Y Tilt | Xtilt | _zt1 与 _zt2 联合运动，实现衍射仪沿垂直于光方向（X）倾斜 |
| x_align | Xtable | 衍射仪沿垂直于光方向（X）平动 |
| tth_hor | tthh / nu | 2θ 水平探测器臂 |
| tth_ver | tth / del | 2θ 垂直探测器臂 |
| th_hor | thh / mu | θ 水平样品旋转 |
| th_ver | th / eta | θ 垂直样品旋转 |
| Chi | chi | χ 轴 |
| Phi | phi | φ 轴 |
| Z_sample | zz | 样品台上下 |
| X_sample | xx | 样品台左右（必须用低温台，否则失效） |
| Y_sample | yy | 样品台前后（必须用低温台，否则失效） |
| Z_cryo | zc | ARS 低温台 Z |
| X_cryo | xc | ARS 低温台 X |
| Y_cryo | yc | ARS 低温台 Y |
注：tth_hor / tth_ver / th_hor / th_ver 有两套命名，fourc 模式为 tthh / tth / thh / th，psic 模式为 nu / del / mu / eta。
狭缝系统（偏振分析用）
| Name | Mnemonic | 说明 |
|---|---|---|
| Slit1_x1 / x2 | s1x1 / s1x2 | 偏振分析-第一个 4 刀狭缝 X 方向 |
| Slit1_y1 / y2 | s1y1 / s1y2 | 偏振分析-第一个 4 刀狭缝 Y 方向 |
| Slit2_x1 / x2 | s2x1 / s2x2 | 偏振分析-第二个 4 刀狭缝 X 方向 |
| Slit2_y1 / y2 | s2y1 / s2y2 | 偏振分析-第二个 4 刀狭缝 Y 方向 |
测角头与偏振分析仪
| Name | Mnemonic | 说明 |
|---|---|---|
| head_x | tx | 样品台测角头 x 平动 |
| head_y | ty | 样品台测角头 y 平动 |
| head_rx | rx | 样品台测角头 x 转动 |
| head_ry | ry | 样品台测角头 y 转动 |
| ana_th | tha | 偏振分析三圆 — θA |
| ana_chi | chia | 偏振分析三圆 — χA |
| ana_tth | ttha | 偏振分析三圆 — 2θA |
| trans_sample | ts | 偏振分析-测角头-平动 |
| rot_sample | rs | 偏振分析-测角头-转动 |
GIWAXS 测试台
| Name | Mnemonic | 说明 |
|---|---|---|
| GI Chi | gchi | GI χ |
| GI Theta | gth | GI θ |
| GI Phi | gphi | GI φ |
| GI SamX | gxx | 样品垂直于光水平运动 |
| GI SamZ | gzz | 样品竖直运动 |
| GI DetX | gdetx | 探测器垂直于光水平运动 |
| GI DetY | gdety | 探测器平行于光水平运动 |
| GI DetZ | gdetz | 探测器竖直运动 |
| GI BstopX | gbsx | beamstop 运动 |
| GI BstopZ | gbsz | beamstop 运动 |
| GI BladeX | gblx | 挡杂散光用刀片 |
| GI BladeZ | gblz | 挡杂散光用刀片 |
| GI SlitXS | gsxs | x 方向狭缝大小 |
| GI SlitXP | gsxp | x 方向狭缝位置 |
| GI SlitZS | gszs | z 方向狭缝大小 |
| GI SlitZP | gszp | z 方向狭缝位置 |
二、锁定功能
为防止意外运动，SPEC 提供以下锁定/解锁命令：
# 衍射仪锁定与解锁
diff_lock diff_unlock
# GIWAXS 锁定与解锁
giwaxs_lock giwaxs_unlock
三、衰减片配置
基本衰减片控制指令
目前 1–15 片编程为 natt 编码: 0–32767
# 分别控制 Al / Ti / Cu 对应的 5 片衰减片（后面加数字，不能大于 31）
na1 [value] na2 [value] na3 [value]
# 注意：na1/na2/na3 互不耦合，但执行 na2 20 时会去除 Al 和 Cu 的衰减片
# 整体控制：后面需加三个数字，每个不能大于 31，分别控制 Al / Ti / Cu
na [val_Al] [val_Ti] [val_Cu]
# 15 片整体编码（0–32767）
natt [value]
衰减片配置流程
# 1. 进入自动宏目录
cd /usr/local/lib/spec.d/auto
# 2. 加载 filter 宏
qdo filter.mac
# 3. config 增加 trans / mask / corrdet 三个频道
# 4. filter_setup（后续只进行这一步）
# 5. 选择衰减片
# 输入每片的 PV 值、材料、厚度、穿透率
# high = 0, low = 1
# 6. 加载 natt 宏
qdo natt.mac
衰减箱 1（ATTE1）
| 序号 | 材料 | 厚度 (µm) | PV 值 |
|---|---|---|---|
| 1 | Al | 200 | BL_ID05:ATTE1:D0 |
| 2 | Al | 400 | BL_ID05:ATTE1:D1 |
| 3 | Al | 800 | BL_ID05:ATTE1:D2 |
| 4 | Al | 1600 | BL_ID05:ATTE1:D3 |
| 5 | Al | 3200 | BL_ID05:ATTE1:D4 |
| 6 | Ti | 100 | BL_ID05:ATTE1:D5 |
| 7 | Ti | 200 | BL_ID05:ATTE1:D6 |
| 8 | Ti | 400 | BL_ID05:ATTE1:D7 |
衰减箱 2（ATTE2）
| 序号 | 材料 | 厚度 (µm) | PV 值 |
|---|---|---|---|
| 1 | Ti | 800 | BL_ID05:ATTE2:D0 |
| 2 | Ti | 1600 | BL_ID05:ATTE2:D1 |
| 3 | Cu | 100 | BL_ID05:ATTE2:D2 |
| 4 | Cu | 200 | BL_ID05:ATTE2:D3 |
| 5 | Cu | 400 | BL_ID05:ATTE2:D4 |
| 6 | Cu | 800 | BL_ID05:ATTE2:D5 |
| 7 | Cu | 1600 | BL_ID05:ATTE2:D6 |
| 8 | W | 4000 | BL_ID05:ATTE2:D7 |
快门控制：第 16 片为快门，相关设置在
相关指令：xct pshutter_init pshutter_on pshutter_off
pshutter.mac（/usr/local/lib/spec.d/auto）中。相关指令：xct pshutter_init pshutter_on pshutter_off
四、基本 SPEC 命令
以下是实验中常用的 SPEC 命令速查：
电机操作
# 查看所有电机位置
wm
# 移动指定电机到绝对位置
umv th 15.0
# 移动指定电机到相对位置
umvr tth 0.5
扫描命令
# 相对扫描：指定电机 ±范围，点数，计数时间（秒）
dscan th -1 1 20 1
# 绝对扫描：指定电机 起始 终止 点数 计数时间
ascan tth 10 50 40 1
回零与快门控制
# 设置当前位置为零点
set_home
# 指定电机回零点
home th
# 快门操作
shutter_open # 打开快门
shutter_close # 关闭快门