# ext2-py-dfr0300

**Repository Path**: mind-plus/ext2-py-dfr0300

## Basic Information

- **Project Name**: ext2-py-dfr0300
- **Description**: 该扩展支持读取电导率 EC（ms/cm）、读取原始电压（mV）、1413μs/cm 与 12.88ms/cm 标准液两点 K 校准、复位校准等功能，可用于常规淡水、土壤溶液、水培营养液等电导率检测。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# 模拟电导率计V2 K=1

`DFR0300` 是一个适用于 Mind+ V2 的传感器扩展（Python 模式）。
该扩展支持读取电导率 EC（ms/cm）、读取原始电压（mV）、1413μs/cm 与 12.88ms/cm 标准液两点 K 校准、复位校准等功能，可用于常规淡水、土壤溶液、水培营养液等电导率检测。

支持以下产品 / 型号：
- Gravity 模拟电导率计V2（K=1）（`DFR0300`）

![cover](./extension/public/cover.png)

## 积木
![blocks](./extension/public/images/blocks.png)

## 示例程序

**基础用法**（先校准、设定温度，再循环读数）：

> 也可直接循环读数，校准值需要通过下面的校准观察流程获取

![default](./extension/public/images/default.png)

**校准观察流程**（循环观察电压/EC 到稳定，按下A按键结束获取校准并读取 K 值）：

![cal](./extension/public/images/cal.png)

说明：

- 不校准也可直接读数（默认 K=1.0）；如需校准，把校准积木连同填入的电压、温度值保留在程序中，每次运行都会生效
- Wiki 明确 K=1 版需要**两点校准**（1413μs/cm + 12.88ms/cm），只做单点无法保证全量程精度
- 读数时会按官方库逻辑自动换档：折算值大于 2.5 用高段 K，小于 2.0 用低段 K
- 支持多探头同时使用，以**引脚**区分，P21 与 P22 相互隔离
- 行空板 M10 的 ADC 为 3.3V/12 位，本库已按 3300mV/4095 换算；Wiki 上 Arduino 例程的 5V/10 位换算不适用于行空板

## 电极保养（来自 Wiki）

- 实验室级电极勿长时间浸泡；铂黑层只能用蒸馏水冲洗，避免触碰、擦拭，否则测量不准
- 建议定期（约每月，频繁使用则每周）用标准液校准

## 更新日志

### V0.0.1

- 完成扩展基础功能
- 移植 DFRobot_EC 库 v1.01 的双 K 自动换档测量与温补算法
- 支持 1413μs/cm 与 12.88ms/cm 标准液两点 K 校准

## 开发指南

更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)

## V1 原始库来源

本库迁移自 Mind+ V1（1.x）用户库，保留 `compatibilityId` 字段以兼容旧版工程。

- compatibilityId：`dfrobot-dfr0300-thirdex`
- 原作者：dfrobot
- 原始仓库：无