Init Commit
Build and Deploy Sphinx Docs / Build Documentation (push) Successful in 2m12s

This commit is contained in:
2025-08-25 10:51:31 +08:00
commit 311ca6702d
80 changed files with 10794 additions and 0 deletions
@@ -0,0 +1,10 @@
############################################################
Digital Instrument Calibration (TDR)
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
@@ -0,0 +1,10 @@
##############################
External Calibration
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
@@ -0,0 +1,10 @@
############################################################
Maintenance Environment Calibration Tab
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
@@ -0,0 +1,10 @@
############################################################
When to Perform Manual Calibration
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
+12
View File
@@ -0,0 +1,12 @@
##############################
Manual Calibration
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
When_To_Cal/index
External_Cal/index
Maintenance_Env/index
Digital_Cal/index
+14
View File
@@ -0,0 +1,14 @@
##############################
Calibration
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
Manual_Cal/index
.. topic:: About Calibration
Balabalabala
+11
View File
@@ -0,0 +1,11 @@
# DC部分
## 测试内容
---
## 测试电路
---
## 测试方法
---
## 测试结果判断
+11
View File
@@ -0,0 +1,11 @@
# K7部分
## 测试内容
---
## 测试电路
---
## 测试方法
---
## 测试结果判断
+11
View File
@@ -0,0 +1,11 @@
# UT部分
## 测试内容
---
## 测试电路
---
## 测试方法
---
## 测试结果判断
+10
View File
@@ -0,0 +1,10 @@
############################################################
外部校准
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
@@ -0,0 +1,10 @@
############################################################
仪表校准
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
+10
View File
@@ -0,0 +1,10 @@
############################################################
环回/自动化测试
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
+10
View File
@@ -0,0 +1,10 @@
############################################################
自校准
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
+13
View File
@@ -0,0 +1,13 @@
############################################################
校准验证/自动化验证
############################################################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
SelfCal/index
ExtCal/index
ExtInstrCal/index
Loop_Auto/index
+10
View File
@@ -0,0 +1,10 @@
##############################
Checklist
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
+5
View File
@@ -0,0 +1,5 @@
# 负载验证
## 容性负载
## 极限负载
@@ -0,0 +1,143 @@
# 实验报告:DPS内部挡位无法输出>10V电压
## 基本信息
| 项目 | 内容 |
|--------------|-----------------------|
| 实验日期 | `2025-08-05` |
| 操作人 | `沈浴阳、庞博` |
| 报告版本 | `V1.0` |
| 板卡编号 | `JC124M060_A2` |
---
## 一、实验背景
- 对于DPS,在5uA, 20uA, 200uA, 2mA, 60mA下,若需要输出>9V电压,需将DPS板卡上运放供电从\~9V抬升至\~14V
- 据推测,这一限制是由于运放与光耦电路对电压输出造成了影响
---
## 二、实验目的
<!-- 清晰描述实验要验证的关键问题 -->
1. 目标1:验证运放与光耦对电压输出造成限制
2. 目标2:尝试修改光耦与运放部分电路解决这一限制
---
## 三、实验环境
- **硬件配置**
- PPMU2.0 板卡一套:
- PMU: JC124M014_A7
- DPS: JC124M060_A1 * 2
- MOLEX: JC124M038_A8
- K7_w/_NOR: JC124M049_A1 * 2
- **软件环境**
- v1.4.0.1154-7817866b4-debug
---
## 四、实验步骤
### 1. 准备工作
<!-- 分步骤描述准备过程 -->
1) 组装板卡
2) 板卡上电并连接电脑
3) 准备示波器、万用表
### 2. 测试流程
<!-- 按顺序记录关键操作 -->
1. 使用DPS通道1、3进行测试,其余通道作为对比组不做修改:
1. 1、3通道移除1A档所用光耦
2. 对DPS进行初始化(获取初始值,Offset=8000)
3. 在FVMV模式下,分别在5uA,20uA,200uA,2mA档下,全通道Force 13V
4. 获取全通道DPS Measure读数
2. 修改1通道光耦电路,
1. 将并联输入,公共脚输出修改为单输入,单输出,公共脚悬空
2. 重复第2步中的ii~iv
---
## 五、实验结果
### 关键数据记录
步骤2
| 挡位 | 测试组 | 对照组(1&3) | 偏差值
|--------|--------|------|------|
| 5uA | 9.388 | 13.000 |-3.612|
| 20uA | 9.470 | 12.999 |-3.529|
| 200uA | 9.714 | 13.001 |-3.287|
| 2mA | 11.787 | 13.000 | -1.213 |
步骤3
| 挡位 | 测试组(1) | 对照组(3) | 对照组(11) |
|--------|--------|------|------|
| 5uA | 12.991 | 13.000 | 9.388 |
| 20uA | 12.992 | 12.999 | 9.470 |
| 200uA | 12.992 | 13.001 | 9.714 |
| 2mA | 12.992 | 13.000 | 11.787|
---
## 六、问题分析
<!-- 使用故障树等结构化方法 -->
```{mermaid}
flowchart TD
n1["光耦"] --> n2["Pin5-&gt;Pin4存在二极管"]
n3["DPS小档位无法输出大电压"] --> n1 & n4["运放"]
n4 --> n6["In+/In-电压范围为Vdd~Vss,超出范围则会被内部二极管钳位"] & n12["Vout不超过Vdd"]
n6 --> n7@{ label: "<span style=\"background-color:\">In+通过1K电阻连至光耦1@Pin4</span>" }
n7 --> n8@{ label: "Force/MeasH-&gt;IN+<br style=\"--tw-scale-x:\">Pin5-&gt;Pin4" }
n10["Vout+串联肖特基二极管至光耦2@Pin4"] --> n9@{ label: "Force/MeasH-&gt;Vout<br style=\"--tw-scale-x:\">Pin5-&gt;Pin4" }
n2 --> n11@{ label: "<span style=\"background-color:\">如果Pin5电压&gt;Pin4电压</span>" }
n11 --> n5["二极管导通,存在电流通路"]
n12 --> n10
n8 --> n13["小档位Force 13V"]
n9 --> n13
n13 --> n14@{ label: "Force=13<br style=\"--tw-scale-x:\">Vout=9.6V" } & n15@{ label: "Force=13<br style=\"--tw-scale-x:\">IN+ = 9V<br>" }
n15 --> n11
n14 --> n11
n5 --> n18["ForceV ClampI"]
n18 --> n20["电流通过1K电阻"] & n21["肖特基二极管反向导通"]
n20 -- "<span style=background-color:>5uA/20uA/200uA Clamp</span>" --> n24["Force电压小于期望值"]
n21 -- "<span style=background-color: rgb(255, 255, 255);>2mA Clamp</span>" --> n24
n1@{ shape: rounded}
n3@{ shape: rounded}
n4@{ shape: rounded}
n6@{ shape: rect}
n12@{ shape: rect}
n7@{ shape: rect}
n8@{ shape: rect}
n10@{ shape: rect}
n9@{ shape: rect}
n11@{ shape: diam}
n5@{ shape: rounded}
n13@{ shape: rounded}
n14@{ shape: rect}
n15@{ shape: rect}
n20@{ shape: rounded}
n21@{ shape: rounded}
```
---
## 七、结论与建议
**实验结论**
1. 光耦中存在二极管,当正向存在压降时,二极管导通,运放输入端电阻上出现压降,存在电流
2. 运放Vout后连接一肖特基二极管,其反向漏电流达到~100uA级别,存在漏电流
3. 当Force电压时Clamp电流,当Force,ExtForce,MeasureH,ExtMeasure间存在通路时,可能触发ClampI,导致观察到输出电压小于期望电压
⚠️ **改进建议**
- [ ] 建议1:修改光耦输入输出端连接方式 (需注意此接法时光耦负载能力)
- [ ] 建议2:加大运放输入端电阻阻值
---
## 附件
1. 电路原理图
![电路原理图](../../_images/PPMU2.0/DPS/Reason.jpg "电路原理图")
1. 运放输入电阻
![运放输入电阻](../../_images/PPMU2.0/DPS/Resistors.png "运放输入电阻")
1. 光耦连接方式(建议方案A)
![光耦连接方式(建议方案A)](../../_images/PPMU2.0/DPS/G3VM_Connection.png "光耦连接方式(建议方案A)")
1. 光耦负载能力
![光耦负载能力](../../_images/PPMU2.0/DPS/G3VM_Load.png "光耦负载能力")
+10
View File
@@ -0,0 +1,10 @@
##############################
PPMU2.0 Lab Reports
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
@@ -0,0 +1,122 @@
# 实验报告:PPMU2.0 ARM12V EN(AVSS PG)修改
## 基本信息
| 项目 | 内容 |
|--------------|-----------------------|
| 实验日期 | `2025-08-18` |
| 负责人 | `沈浴阳` |
| 报告版本 | `V1.0` |
| 板卡编号 | `SC525M003` |
---
## 一、实验背景
目前版本的PPMU2.0板卡(JC124M014_A7)采用了阶梯上电的方式,作为其中的一部分,ARM(Zynq XC7Z100)的供电芯片之使能管脚使用前级电源PG,而前级电源EN使用负电源DC-DC中的一路的PG信号作为输入;
而在板卡输出负电压,大电流时,可能使该DC-DC**过载**,导致PG管脚被芯片拉低,从而导致ARM供电使能被***拉低***一段时间(直至负电源恢复),ARM随之重启,进而导致整板重启
---
## 二、实验目的
<!-- 清晰描述实验要验证的关键问题 -->
1. 目标1`验证负电源PG导致ARM输出掉电`
2. 目标2`修改底板线路连接`
3. 目标3`验证修改后输出负电压大电流时板卡不重启`
---
## 三、实验环境
- **硬件配置**
- PPMU2.0 板卡一套:
- PMU: JC124M014_A7
- DPS: JC124M060_A1 * 2
- MOLEX: JC124M038_A7
- K7_w/_NOR: JC124M049_A1 * 2
- 外部校准板: JC124M037_A0
- 面板:JC124M013
- **软件环境**
- v1.4.0.1154-7817866b4-debug
---
## 四、实验步骤
### 1. 准备工作
<!-- 分步骤描述准备过程 -->
1) 组装板卡
2) 板卡上电并连接电脑
3) 准备示波器、万用表
### 2. 测试流程
<!-- 按顺序记录关键操作 -->
1. 验证负电源PG导致ARM输出掉电:
1. 外部校准版切换至PMU通道,负载10Ω
2. 上位机软件设置全通道输出,调整输出电压,从较为保守的值开始(此处设置为-100mV,即-10mA)
3. 逐渐增加输出电流(即增加输出电压) 注:绝对值
4. 观察是否掉电,若不掉电,重复上述步骤
2. 修改PMU底板电路:
1. 参考layout后选择割开ARM12V DC-DC芯片(LMR51450)的EN管脚走线
2. 从该芯片附近选择一Ref输出(5V)作为EN脚输出,进行飞线至管脚
3. 验证修改后输出负电压大电流时板卡不重启:
4. 重复第1部分实验,直接使用掉电时电压
5. 确认此时板卡不再重启
6. *(可选)* 输出正电流时,板卡是否重启
7. *(可选)* 检查Log,确认AD5522读数,判断其状态是否仍正常
---
## 五、实验结果
### 关键数据记录
||输出电流|板卡状态|AD5522状态|
|---|---|---|---|
|修改前|-7mA|正常|正常|
|修改前|-10mA|掉电重启|N/A|
|修改后|-10mA|正常|正常|
|修改后|-12mA|正常|正常|
|修改后|-14mA|正常|异常|
### 波形/现象记录
**图1:输出负电流时掉电波形**
![图1:输出负电流时掉电波形](../../_images/PPMU2.0/Pwr/AVSS_Fail.jpg)
*注:负电源输出跌落:-18V->-9.34V*
**图2:修改后输出大电流时AVSS DCDC波形**
![图2:修改后输出大电流时AVSS DCDC波形](../../_images/PPMU2.0/Pwr/AVSS_Fail2.jpg)
*注:此时板卡不掉电*
---
## 六、问题分析
<!-- 使用故障树等结构化方法 -->
```{mermaid}
flowchart TD
n1["PMU输出较大负电流"] --> n2["负电源过载"]
n2 --> n3["负电源将其PG引脚拉低"]
n3 -- XOUA1 EN管脚使用该PG信号 --> n4["XOUA1被禁用,其PG被拉低"]
n4 -- PG_1XO5V作为ARM12V EN信号 --> n5["ARM12V被禁用,ARM掉电"]
n5 --> n6["K7与ARM强相关,K7被重置"]
n1@{ shape: rounded}
```
---
## 七、结论与建议
✅ **实验结论**
1. `修改EN/PG走线后板卡在输出大电流(正负)时不重启`
2. `输出大电流时DCDC、LDO均过载,需小心使用`
---
## 附件
1. [临界数据](../../_static/data/Edge_FlowLog_Raw_2025_08_15_14_14_45.777.txt)
2. [过载数据](../../_static/data/Critial_FlowLog_Raw_2025_08_15_14_14_55.009.txt)
3. 现有PG/EN连接
![XOUA1](../../_images/PPMU2.0/Pwr/VCC5V0.png)
![XOUA1](../../_images/PPMU2.0/Pwr/ARM12V.png)
4. 修改后电路
![M014_Bridge](../../_images/PPMU2.0/Pwr/M014_Bridge.png)
![M014](../../_images/PPMU2.0/Pwr/M014.jpg)
@@ -0,0 +1,78 @@
# 实验报告:降低板卡输入电压
## 基本信息
| 项目 | 内容 |
|--------------|-----------------------|
| 实验日期 | `2025-08-18` |
| 负责人 | `沈浴阳` |
| 报告版本 | `V1.0` |
| 板卡编号 | `SC525M003` |
---
## 一、实验背景
目前PPMU2.0板卡(PMU&DPS)上AD5522的正电源AVDD均为外部电源输入后通过LDO进行降压转换出18V,基于目前供电情况,存在较大压降(24V->18V=6V),对LDO存在较大压力且损耗较大
故需尝试是否可以在目前硬件环境下降低输入电压,以减少损耗、保护LDO
---
## 二、实验目的
<!-- 清晰描述实验要验证的关键问题 -->
1. 目标1`测试现用明纬电源(RSP-3000-24)最低输出电压`
2. 目标2`测试在现用明纬电源最低输出电压下板卡是否正常工作`
---
## 三、实验环境
- **硬件配置**
- PPMU2.0 板卡一套:
- PMU: JC124M014_A7
- DPS: JC124M060_A1 * 2
- MOLEX: JC124M038_A7
- K7_w/_NOR: JC124M049_A1 * 2
- 外部校准板: JC124M037_A0
- 面板:JC124M013
- **软件环境**
- v1.4.0.1154-7817866b4-debug
---
## 四、实验步骤
### 1. 准备工作
<!-- 分步骤描述准备过程 -->
1) 步骤描述1`调整明纬电源输出调整旋钮至最低位`
2) 步骤描述2`测量电源输出电压,电压>18V时可以尝试连接板卡`
3) 步骤描述3`通过面板连接板卡及外部校准板`
4) 步骤描述4`测试PMU、DPS是否正常工作及输出能力`
### 2. 测试流程
<!-- 按顺序记录关键操作 -->
```{mermaid}
flowchart TD
A(["调整明纬电源输出"]) --> B{"&gt;18V"}
B -- YES --> C["板卡连接外部校准版并上电"]
C --> D["测试板卡功能是否正常"]
B -- NO --> A
C@{ shape: rect}
```
---
## 五、实验结果
### 关键数据记录
| 测试点 |期望值| 实测值 | 单位 |
|--------|---|---|---|
| 明纬电源输出 | <24V & >18V | 20.55 | V |
### 波形/现象记录
**图1:上电冲击电流波形**
![明纬电源最低输出电压](../../_images/PPMU2.0/Pwr/MWPwr.jpg "明纬电源最低输出电压")
*注释:明纬电源最低输出电压*
---
## 附件
1. AVDD电路部分
![AVDD电路部分](../../_images/PPMU2.0/Pwr/AVDD.png)
2. [原始测试数据](../../_static/data/FlowLog_Raw_2025_08_15_13_58_53.205.txt)
+10
View File
@@ -0,0 +1,10 @@
##############################
电源验证
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
:glob:
*
+14
View File
@@ -0,0 +1,14 @@
##############################
Hardware Verification
##############################
.. toctree::
:maxdepth: 2
:caption: Contents:
:glob:
Checklist/index
Pwr_Verify/index
Load_Verify/index
Cal/index
PPMU2.0/index
+20
View File
@@ -0,0 +1,20 @@
# DPS Features
## General
- 32 DPS Channel
- Force and sense outputs for each channel
- Current and voltage metering through dedicated channel meters
- Full four quadrant operation (source or sink, positive or negative)
- Five selectable forcing modes: +v, -v, +i, -i and hi-z
- Six selectable current clamp ranges
- Clamp function for either voltage or current
|Force Mode|Clamp target|
|---|---|
|Voltage|Current|
|Current|Voltage|
:::{card} {bdg-light}`Info`
P/N:JC124M060
:::
+8
View File
@@ -0,0 +1,8 @@
# DPS Current Forcing
|Specification|Value|Condition|
|---|---|---|
|Current Range|±5uA,±20uA,±200uA,±2mA,±60mA|w/o Voltage Clamp|
|Voltage Clamp|-8V to 13V||
|DC Accuracy|0.1%|After Calibration|
|Linearity Error|±0.0004V||
+12
View File
@@ -0,0 +1,12 @@
# PPMU2.0 Voltage Forcing
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V|w/o Current Clamp [^1]|
|Current Clamp|5uA,20uA,200uA,2mA,60mA||
|DC Accuracy|0.1%|After Calibration|
|Linearity Error|±0.0002V||
|Short-Circuit Current Limit|±150mA <br>±10mA |±60mA Range<br>All other Range|
|Slew Rate| ? V/us|CCOMPx = 22 nF, CFFx = 220 pF, CLOAD = 200 pF|
[^1]: Current Clamp Range: 5uA,20uA,200uA,2mA,60mA
+9
View File
@@ -0,0 +1,9 @@
# PPMU2.0 Hi-Z mode
Voltage metering specifications apply (see {doc}`Voltage Metering <ForceV>`).
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V||
|DC Accuracy|0.1%|After Calibration|
|DC Input Current|? nA||
@@ -0,0 +1,9 @@
# PPMU2.0 Current Measuring
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V||
|DC Accuracy|0.1%<br>0.3%<br>|After Calibration|
|Sense Resistors|<br>200kΩ<br>50kΩ<br>5kΩ<br>0.5kΩ<br>10Ω [^1]|Sense resistors are trimmed to 1%<br>±5uA range<br>±20uA range<br>±200uA range<br>±2mA range<br>±60mA range [^1]|
[^1]: External Range
@@ -0,0 +1,6 @@
# PPMU2.0 Voltage Measuring
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V||
|DC Accuracy|0.1%|After Calibration|
+10
View File
@@ -0,0 +1,10 @@
# PPMU2.0 Compliance Ranges
||Specification|Value|
|---|---|---|
|256 Channel|Postive Current|33mA|
||Negtive Current|-12mA|
|64 Channel[^1]|Postive Current|60mA|
||Negtive Current|-38mA|
[^1]: 64 Channels **Must** *uniformly* spaced by 4
+9
View File
@@ -0,0 +1,9 @@
##############################
PPMU2.0 VI
##############################
.. toctree::
:maxdepth: 1
:glob:
*
+9
View File
@@ -0,0 +1,9 @@
##############################
M060 Specifications
##############################
.. toctree::
:maxdepth: 1
:glob:
*
+9
View File
@@ -0,0 +1,9 @@
##############################
DPS Specifications
##############################
.. toctree::
:maxdepth: 1
:glob:
M060/index
+1
View File
@@ -0,0 +1 @@
# PPMU1.0 Features
+1
View File
@@ -0,0 +1 @@
# PPMU1.0 Current Forcing
+1
View File
@@ -0,0 +1 @@
# PPMU1.0 Voltage Forcing
@@ -0,0 +1 @@
# PPMU1.0 Current Measuring
@@ -0,0 +1 @@
# PPMU1.0 Voltage Measuring
+9
View File
@@ -0,0 +1,9 @@
##############################
PPMU1.0 VI
##############################
.. toctree::
:maxdepth: 2
:glob:
*
+19
View File
@@ -0,0 +1,19 @@
##############################
PPMU1.0
##############################
.. toctree::
:maxdepth: 2
:glob:
*
VI/index
Notes
• Specifications are subject to change without notice.
• All specifications are guaranteed unless noted as typical or nominal.
• Typical specifications are sample tested (not 100% tested) and are not guaranteed.
• Nominal specifications are generally calculated values (not 100% tested) and are not guaranteed.
+20
View File
@@ -0,0 +1,20 @@
# PPMU2.0 Features
## General
- 256 PMU Channel
- Force and sense outputs for each channel
- Current and voltage metering through dedicated channel meters
- Full four quadrant operation (source or sink, positive or negative)
- Five selectable forcing modes: +v, -v, +i, -i and hi-z
- Five selectable current clamp ranges
- Clamp function for either voltage or current
|Force Mode|Clamp target|
|---|---|
|Voltage|Current|
|Current|Voltage|
:::{card} {bdg-light}`Info`
P/N:JC124M014
:::
+8
View File
@@ -0,0 +1,8 @@
# PPMU2.0 Current Forcing
|Specification|Value|Condition|
|---|---|---|
|Current Range|±5uA,±20uA,±200uA,±2mA,±60mA|w/o Voltage Clamp|
|Voltage Clamp|-8V to 13V||
|DC Accuracy|0.1%|After Calibration|
|Linearity Error|±0.0004V||
+12
View File
@@ -0,0 +1,12 @@
# PPMU2.0 Voltage Forcing
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V|w/o Current Clamp [^1]|
|Current Clamp|5uA,20uA,200uA,2mA,60mA||
|DC Accuracy|0.1%|After Calibration|
|Linearity Error|±0.0002V||
|Short-Circuit Current Limit|±150mA <br>±10mA |±60mA Range<br>All other Range|
|Slew Rate| ? V/us|CCOMPx = 22 nF, CFFx = 220 pF, CLOAD = 200 pF|
[^1]: Current Clamp Range: 5uA,20uA,200uA,2mA,60mA
+9
View File
@@ -0,0 +1,9 @@
# PPMU2.0 Hi-Z mode
Voltage metering specifications apply (see {doc}`Voltage Metering <ForceV>`).
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V||
|DC Accuracy|0.1%|After Calibration|
|DC Input Current|? nA||
@@ -0,0 +1,9 @@
# PPMU2.0 Current Measuring
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V||
|DC Accuracy|0.1%<br>0.3%<br>|After Calibration|
|Sense Resistors|<br>200kΩ<br>50kΩ<br>5kΩ<br>0.5kΩ<br>10Ω [^1]|Sense resistors are trimmed to 1%<br>±5uA range<br>±20uA range<br>±200uA range<br>±2mA range<br>±60mA range [^1]|
[^1]: External Range
@@ -0,0 +1,6 @@
# PPMU2.0 Voltage Measuring
|Specification|Value|Condition|
|---|---|---|
|Voltage Range|-8V to 13V||
|DC Accuracy|0.1%|After Calibration|
+10
View File
@@ -0,0 +1,10 @@
# PPMU2.0 Compliance Ranges
||Specification|Value|
|---|---|---|
|256 Channel|Postive Current|33mA|
||Negtive Current|-12mA|
|64 Channel[^1]|Postive Current|60mA|
||Negtive Current|-38mA|
[^1]: 64 Channels **Must** *uniformly* spaced by 4
+9
View File
@@ -0,0 +1,9 @@
##############################
PPMU2.0 VI
##############################
.. toctree::
:maxdepth: 1
:glob:
*
+21
View File
@@ -0,0 +1,21 @@
##############################
PPMU2.0
##############################
.. toctree::
:maxdepth: 2
:glob:
*
VI/index
Notes
• Specifications are subject to change without notice.
• All specifications are guaranteed unless noted as typical or nominal.
• Typical specifications are sample tested (not 100% tested) and are not guaranteed.
• Nominal specifications are generally calculated values (not 100% tested) and are not guaranteed.
+10
View File
@@ -0,0 +1,10 @@
##############################
PPMU Specifications
##############################
.. toctree::
:maxdepth: 1
:glob:
1.0/index
2.0/index
+10
View File
@@ -0,0 +1,10 @@
##############################
DC Instruments
##############################
.. toctree::
:maxdepth: 1
:glob:
PPMU/index
DPS/index
+9
View File
@@ -0,0 +1,9 @@
##############################
Digital Instruments
##############################
.. toctree::
:maxdepth: 2
:glob:
*
+12
View File
@@ -0,0 +1,12 @@
##############################
Mars 1KS Specification
##############################
.. toctree::
:maxdepth: 2
:caption: Contents:
:glob:
DC/index
K7/index
Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 154 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 215 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 174 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 175 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.9 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 135 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.6 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 181 KiB

+24
View File
@@ -0,0 +1,24 @@
from pathlib import Path
HARDWARE_INDEX = Path(__file__).parent.parent / "hardware/index.md"
HARDWARE_DIR = Path(__file__).parent.parent / "hardware"
def generate_hardware_index():
boards = []
for board_dir in HARDWARE_DIR.iterdir():
if board_dir.is_dir() and (board_dir / "index.md").exists():
# 关键修改:使用标准Sphinx路径格式
boards.append(f"{board_dir.name}/index") # 移除了./和空格
toctree_content = (
"# 硬件文档中心\n\n"
"```{toctree}\n"
":maxdepth: 2\n"
":caption: 板卡列表\n"
":glob:\n\n" + # 添加glob指令增强容错性
"\n".join(sorted(boards)) + "\n```")
HARDWARE_INDEX.write_text(toctree_content, encoding="utf-8")
if __name__ == "__main__":
generate_hardware_index()
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
Binary file not shown.
+135
View File
@@ -0,0 +1,135 @@
# conf.py - Sphinx 知识库终极配置
import os,sys
import shutil
from pathlib import Path
# ================= 基础配置 =================
project = 'ManLin_KnowledgeBase'
copyright = '2024, YuYang Shen'
author = 'YuYang Shen'
release = '1.0'
language = 'zh_CN'
# 设置源文件编码为UTF-8(解决中文乱码问题)
source_encoding = 'utf-8'
# ================= 扩展配置 =================
extensions = [
'myst_parser', # Markdown支持
'sphinx_copybutton', # 代码复制按钮
'sphinx_design', # UI组件
'sphinxcontrib.images', # 图片管理
'sphinxcontrib.video', # 视频嵌入
'sphinxcontrib.htmlhelp',# CHM 生成
'sphinxcontrib.wavedrom' # 时序图
]
# ================= MyST配置 =================
myst_enable_extensions = [
"colon_fence",
"deflist",
"tasklist",
"html_image"
]
myst_heading_anchors=5
# ================= 路径配置 =================
exclude_patterns = [
'_templates/*', # 忽略模板目录
'**/*.template', # 忽略模板文件
'Thumbs.db' # 忽略系统文件
]
templates_path = ['_templates']
html_static_path = ['_static']
# ================= 构建控制 =================
is_chm_build = 'htmlhelp' in sys.argv
wavedrom_html_jsinline = False # 离线渲染
# ================= 主题配置 =================
html_theme = 'sphinx_rtd_theme'
html_theme_options = {
'collapse_navigation': False,
'includehidden': True
}
# ================= 高级功能 =================
# ================== Mermaid 配置 ==================
def find_system_chrome():
"""自动检测系统 Chrome/Chromium 可执行路径"""
# 按优先级检查的浏览器名称
chrome_names = [
'google-chrome', # 官方 Chrome
'google-chrome-stable', # Stable 版本
'chromium', # Chromium
'chromium-browser', # Debian 系命名
'chrome', # 备用名称
'microsoft-edge' # Edge 兼容
]
# 1. 尝试通过 which 查找
for name in chrome_names:
chrome_path = shutil.which(name)
if chrome_path:
return chrome_path
# 2. 检查常见安装路径
common_paths = [
'/usr/bin/',
'/usr/local/bin/',
'/opt/google/chrome/',
'/snap/bin/',
'/Applications/Google Chrome.app/Contents/MacOS/' # macOS
]
for path in common_paths:
for name in chrome_names:
chrome_path = Path(path) / name
if chrome_path.exists():
return str(chrome_path)
raise RuntimeError("未找到 Chrome/Chromium 可执行文件")
try:
# 获取系统 Chrome 路径
chrome_path = find_system_chrome()
if chrome_path:
print(f"✅ 找到 Chrome 浏览器: {chrome_path}")
# 设置环境变量,让 mermaid-cli 使用系统 Chrome
os.environ['PUPPETEER_EXECUTABLE_PATH'] = chrome_path
os.environ['PUPPETEER_SKIP_CHROMIUM_DOWNLOAD'] = 'true'
# 添加 mermaid 扩展
extensions.append('sphinxcontrib.mermaid')
mermaid_output_format = 'png'
print(f"✅ Mermaid 配置成功,输出格式: {mermaid_output_format}")
except Exception as e:
print(f"⚠️ Mermaid 初始化失败: {e}")
print("⚠️ 图表将显示为代码块,请安装 Chrome 和 mermaid-cli")
extensions.discard('sphinxcontrib.mermaid')
# ================= CHM特化配置 =================
if is_chm_build:
html_compact_lists = True
html_use_smartypants = False
html_use_index = False
html_scaled_image_link = False
html_add_permalinks = False # 禁用锚点(CHM 不支持)
html_show_sourcelink = False # 禁用源码链接
htmlhelp_basename = 'ManLinKB'
html_css_files = []
html_js_files = []
# 公共配置
html_last_updated_fmt = '%Y-%m-%d' # 最后更新时间
+26
View File
@@ -0,0 +1,26 @@
.. ManLin_KnowledgeBase documentation master file, created by
sphinx-quickstart on Tue Aug 12 05:35:46 2025.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. ManLin 硬件知识库主索引文件
.. 注意:此文件使用 reStructuredText 语法,但支持包含 Markdown 文件
##############################
ManLin 硬件产品知识库
##############################
.. toctree::
:maxdepth: 1
:caption: Contents:
Mars_1KS/index
Calibration/index
Lab_Report/index
*Additional Docs:*
1. `AD5522 <_static/data/add_docs/AD5522.pdf>`_