readout_program/ro_codeword.md

ACQ通道通过产生32位的码字来控制读出行为，32位的操控码字功能定义如下表所示。

|比特位|名字|功能描述|
|:-|:-|:-|
|[31:16]|QUBIT_EN| 16个量子比特使能，高电平使能对应位量子比特|
|[15]|COUNT_SAVE_EN| 态计数据存储使能, 高电平使能态计数存储|
|[14]|STATE_SAVE_EN| 态数据存储使能, 高电平使能态数据存储|
|[13]|IQ_SAVE_EN| 解模数据存储使能, 高电平使能解模数据存储|
|[12]|WAVE_SAVE_EN| 波形数据存储使能, 高电平使能波形数据存储|
|[11]|MTF_IDX_SEL| 匹配滤波器索引选择，1：寄存器，0：查找表|
|[10]|DDS_FPW_SEL| 解模频率相位控制字选择, 1：寄存器，0：查找表|
|[9]|STATE_CLR_VAL| 态统计清零有效, 高电平清零计数|
|[8]|DEMOD_CLR_VAL| 解模求和清零有效, 高电平清零求和值|
|[7]|GLB_FB_VAL| 全局反馈触发有效, 高电平使能全局反馈|
|[6]|LOC_FB_VAL| 局部反馈命令有效, 高电平使能局部反馈|
|[5]|STATE_STS_VAL| 态统计命令有效, 高电平使能态计数功能|
|[4]|DEMOD_SUM_VAL| 解模求和命令有效, 高电平使能解模求和功能|
|[3:0]|PARA_ID| 读出参数查找表索引, 总共支持最大16组参数|

- 码字比特 [31:16]用于使能对对每个比特的控制，读出芯片最大支持16个量子比特。
- 码字比特[15:12]使能要存储数据，同时存储多种数据将导致死时间增加，推荐仅使能一种数据；
- 码字比特[11]用于使能寄存器索引权重/系数，可通过MCU实时控制，突破参数个数限制。
- 码字比特[10]用于使能寄存器控制NCO，可通过MCU实时控制，突破参数个数限制。
- 码字比特[9]用于对态计数数据进行清零，清零后可开启新一轮统计；
- 码字比特[8]用于对IQ求和数据进行清零，清零后可开启新一轮统计；
- 码字比特[7]用于使能读出比特数据通过串行接口发出，用于支持系统全局反馈功能；
- 码字比特[6]用于使能读出比特数据通过并行接口发出，用于支持系统局部反馈功能；
- 码字比特[5]用于对态判断结果进行计数统计，通过采集计数结果可降低芯片推送数据量；
- 码字比特[4]用于对解模数据进行求和操作，通过采集求和数据可降低芯片推送数据量；
- 码字比特[3:0]用于选择要实时从存储中加载的解模和态判断参数，总共支持16组参数进行快速切换；

**注意码字存在优先级和时序：**
* 当同一个指令中同时对多个量子比特解模/读出时，
  * 解模时间等于最长那个比特的解模时间
  * 读出时间等于最长那个比特的读出时间
* 在一个指令中同时使能四种数据存储时，存储的先后顺序为：
  1. 波形数据
  1. 解模IQ数据
  1. 态判断数据
  1. 态计数数据
* 在一个指令中同时使能了解模求和清零、解模求和和求和存储时，顺序为：
  1. 先执行求和清零，
  1. 再执行求和
  1. 最后执行求和结果存储
* 在一个指令中同时使能了态计数清零、态计数和计数存储时，顺序为：
  1. 先执行态计数清零
  1. 再执行态计数
  1. 最后执行计数结果存储