High-Precision AD HAT

• 说明
• 使用
• 资料
• FAQ
• 售后

High-Precision AD HAT

{{{name2}}}

{{{name3}}}

基本信息 分类： 树莓派扩展板 功能： Raspberry Pi 高精度AD {{{userDefinedInfo1}}}： {{{userdefinedvalue1}}} {{{userDefinedInfo2}}}： {{{userdefinedvalue2}}} {{{userDefinedInfo3}}}： {{{userdefinedvalue3}}} {{{userDefinedInfo4}}}： {{{userdefinedvalue4}}} {{{userDefinedInfo5}}}： {{{userdefinedvalue5}}} {{{userDefinedInfo6}}}： {{{userdefinedvalue6}}} 品牌： Waveshare

板载接口 RPi AD

相关产品 ♦ 树莓派开发板 ♦ {{{Product1}}} ♦ {{{Product2}}} ♦ {{{Product3}}} ♦ {{{Product4}}} ♦ 套餐模块

说明

适用于树莓派的高精密模数转换器

产品参数

• 分辨率（Bits）：32
• 输入通道数：10
• 采样率（最大）（kSPS）：38
• PGA倍数（最大）：32
• 接口类型：SPI
• 架构：Delta-Sigma
• 输入类型：差分、单端
• 参考电压：内部、外部
• 输入电压范围（最大）（V）：2.5，5
• 输入电压范围（最小）（V）：-2.5，0

产品特点

• 板载ADS1263芯片，低噪声、低温漂，10通道32位精密ADC（5通道差分输入），最大38.4kSPS采样速率
• 芯片自带24位辅助ADC、内部ADC测试信号、IDAC、2.5V内部基准电压、8个复用GPIO、PGA（最大32倍）
• 板载排针封装输入接口，可接入模拟信号，兼容微雪传感器接口标准，方便接入各种模拟传感器模块
• 板载接线端子封装输入接口，可接入模拟信号及模拟电源，方便在各种场合使用
• 板载排针封装控制接口，可接入控制信号，方便使用树莓派以外的设备控制本模块
• 板载三线RTD电路，通过焊接0R电阻可以方便使用三线RTD进行测量

功能引脚

功能引脚	树莓派接口(BCM)	树莓派接口(WiringPi)	描述
DRDY	D17	P0	ADS1263数据就绪输出，低电平有效
RESET	D18	P1	ADS1263复位输入
CS	D22	P3	ADS1263片选，低电平有效
DIN	D10	P12	SPI数据输入
DOUT	D9	P13	SPI数据输出
SCK	D11	P14	SPI时钟信号
DIN0	D6	P22	数字输入信号
DIN1	D13	P23	数字输入信号
DIN2	D19	P24	数字输入信号
DIN3	D26	P25	数字输入信号

硬件配置

PS：若使用其他控制器进行作业（即使用8Pin贴片排针输入控制信号），AVDD也必须接电源（5V），否则芯片不工作

单端输入配置

本模块默认为单端测量模式，即AVDD连接5V，AVSS连接GND，并将COM口配置成负端输入且用跳线帽连接到GND。
所以此时您可以直接引出 AD HAT 模块的GND（或COM）连接至目标板的GND然后将 AD HAT 的任意IN连接至待测目标处测量电压。

差分输入配置

• （可选）引出 AD HAT 模块的GND（或COM）连接至目标板的GND
• 将您的差分信号接入 AD HAT 的差分信号输入端口（IN0&IN1或其他四组任意一组差分输入接口）
• （可选）如果您需要测量的信号比较小需要使用PGA，需要进入程序将参考电压设置为内部±2.5V（默认为AVDD-AVSS为单极性激励不支持PGA），并将main.c中宏定义“REF”的值修改为2.5，且要根据需求自行调整PGA参数

修改内部参考电压：
在 ADS1263.c 中的 ADS1263_ConfigADC1()
UBYTE REFMUX = 0x24;
改为
UBYTE REFMUX = 0x00;

• 程序使用差分测量模式：

将main.c中的33行（python也有同名函数）
ADS1263_SetMode(0);
改为
ADS1263_SetMode(1);

• 注意：差分模式测量通道号需要小于5，请根据实际情况修改

RTD配置

如果您需要使用RTD功能，请按照以下方式操作硬件：

• 在背面“RTD 0R”处焊上四个0R电阻

• 取下COM-GND的跳线帽

• 将您的三线RTD模块的正极连接至IN7，其他两线任意连接至IN6和IN4

• 最后在程序中做好配置即可测量

通信协议

SPI协议

本模块使用的通信类型为SPI通信，具体描述可以查阅数据手册Page 11-12
SPI通信部分在手册中的时序图如下图所示：


CS为从机片选， 仅当CS为低电平时，芯片才会被使能；
SCLK为SPI通信时钟；
DIN为数据输入即MOSI，主设备数据输出，从设备数据输入；
DOUT为数据输出即MISO，主设备数据输入，从设备数据输出；
DRDY，为数据准备状态输出脚，当ADC1的数据准备就绪时DRDY会输出低电平。
对于SPI通信而言，数据是有传输时序的，即数据的捕获需要时钟信号的某个边沿触发，而这个边沿就是由时钟极性(CPOL)与时钟相位（CPHA）的组合决定的：
CPOL的高低决定串行同步时钟的空闲状态电平，CPOL = 0，为低电平；CPOL = 1，为高电平。
CPHA的高低决定串行同步时钟是在第一时钟跳变沿还是第二个时钟跳变沿数据被采集， 当CPHA = 0，在第一个跳变沿进行数据采集；CPHA = 1，在第二个跳变沿进行数据采集。
从图中可以看出，SCL空闲时是低电平，在第二个边沿时开始传输数据，所以是模式一(0x01)，一个时钟周期传输8bit数据，按位传输,高位在前,低位在后(MSB)。

使用

提供C语言与python例程

PS：使用 Bullseye 分支的系统时，建议使用“apt" 替换“apt-get”；且 Bullseye 分支的系统只支持 Python3。

开启SPI接口

• 打开树莓派终端，输入以下指令进入配置界面：
  

sudo raspi-config
选择Interfacing Options -> SPI -> Yes 开启SPI接口

• 重启树莓派：
  

sudo reboot

• 检查 /boot/config.txt，可以看到 'dtparam=spi=on' 已被写入
  

• 为了确保 SPI 没有被占用，建议其他的驱动覆盖暂时先关闭。可以使用 ls /dev/spi* 来检查 SPI 占用情况，终端输出 /dev/spidev0.0 和 /dev/spidev0.1 表示 SPI 情况正常

安装库

如果使用bookworm系统，只能使用lgpio库，bcm2835跟wiringPi无法安装与使用,python库可以不安装，直接运行程序即可

BCM2835

#打开树莓派终端，并运行以下指令
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
tar zxvf bcm2835-1.71.tar.gz 
cd bcm2835-1.71/
sudo ./configure && sudo make && sudo make check && sudo make install
# 更多的可以参考官网：http://www.airspayce.com/mikem/bcm2835/

wiringPi

#打开树莓派终端，并运行以下指令
cd
sudo apt-get install wiringpi
#对于树莓派2019年5月之后的系统（早于之前的可不用执行），可能需要进行升级：
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
# 运行gpio -v会出现2.52版本，如果没有出现说明安装出错

#Bullseye分支系统使用如下命令：
git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v
# 运行gpio -v会出现2.70版本，如果没有出现说明安装出错

lgpio

wget https://github.com/joan2937/lg/archive/master.zip
unzip master.zip
cd lg-master
sudo make install 
# 更多的可以参考官网：https://github.com/gpiozero/lg

• python

sudo apt-get update
sudo apt-get install ttf-wqy-zenhei
sudo apt-get install python-pip 
sudo pip install RPi.GPIO
sudo pip install spidev
# bookworm 系统
sudo apt install python3-rpi-lgpio 
sudo apt-get install python3-spidev
sudo apt-get install python3-RPi.GPIO

下载例程

方法一：微雪官网下载，在树莓派终端运行：

cd ~
sudo apt-get install p7zip-full
wget http://www.waveshare.net/w/upload/a/a1/High-Precision_AD_HAT_Code.7z
7z x High-Precision_AD_HAT_Code.7z -r -o./High-Precision_AD_HAT_Code

方法二：使用github仓库，github可能更新会有延迟，推荐使用方法一。

cd ~
sudo git clone https://github.com/waveshare/High-Pricision_AD_HAT.git

例程使用

C

• 进入C例程文件夹，并编译例程

cd ~/High-Precision_AD_HAT_Code/c
sudo make clean
sudo make

• 如果是jetson nano：

cd ~/High-Precision_AD_HAT_Code/c
sudo make clean
sudo make JETSON

• 在编译前您可以在 Makefile 文件中修改注释以切换使用库（默认为BCM2835，若使用过BCM2835必须重启树莓派后才能使用别的库）

sudo nano Makefile
将 line 13-15 的 USELIB_RPI 的注释切换即可

• 编译完成后会在该目录生成 main 文件，执行即可

sudo ./main

• 当然您也可以在例程中做一些修改以实现不同的功能，详细介绍请参阅‘函数简介’段落

Python

• 进入Python例程文件夹，并执行例程

cd ~/High-Precision_AD_HAT_Code/python

sudo python main.py
or
sudo python3 main.py

• 如果使用的是Jetson Nano需要先开启SPI：

sudo /opt/nvidia/jetson-io/jetson-io.py
会弹出GPIO工具菜单，选择“Configure 40-pin expansion header”按下回车进入次级菜单。
然后勾选spi1并返回上级菜单，最后选择“Save and reboot to reconfigure pins”使设备重启配置生效。
安装以下库

sudo apt install python-pip
  sudo pip install spidev

• 如果开启SPI失败，请参考官方文档：NVIDIA Jetson Linux开发人员指南
• 当然您也可以在例程中做一些修改以实现不同的功能，详细介绍请参阅‘函数简介’段落

函数简介

硬件部分

为了方便后续阅读，简单介绍一下硬件。
本模块使用的ADC是ADS1263，使用的SPI通信，需要关注的是模式（模式一）、速率（最大8M）、数据格式（MSB），在可以正常通信后就可以开始实现功能了。
控制主要分为发送命令和读写寄存器，命令表和寄存器表都可以在数据手册中找到。
常用的命令就是开始/结束ADC转换、读/写寄存器、重启等；寄存器主要是用来写入配置参数，程序的核心就是读写寄存器。
PS：读/写寄存器是一种特殊的命令，普通的命令是单字节的，读/写寄存器是多字节的，即读/写寄存器命令 + 需要写入/接收的数据。

软件部分

因为C例程和Python例程的函数和功能是一模一样的，所以放在一起讲解。
下面以 ADS1263.c 的代码为例，在 ADS1263.py 也可以找到对应的函数：

• 复位函数，DEV_RST_PIN 为IC复位引脚，低电平有效，每次使用前需要进行复位操作，复位后寄存器配置会恢复默认值，需要重新配置。
  

static void ADS1263_reset(void)

• 数据读写函数，这三个函数分别为写命令、写寄存器、读取寄存器，每次SPI操作需要拉低DEV_CS_PIN（片选，CS）引脚，读写寄存器因为命令是两个字节所以需要发送一次0x00
  

static void ADS1263_WriteCmd(UBYTE Cmd)
static void ADS1263_WriteReg(UBYTE Reg, UBYTE data)
static UBYTE ADS1263_Read_data(UBYTE Reg)

• 数据校验函数——和校验函数，本例程的读取数据都使用了和校验，也可以通过寄存器配置CRC校验
  

和校验主要原理是取数据的低八位相加，最后加上一个固定参数，取和后的低八位与读取到的校验字节异或，如果数据读取正确返回0（相同异或为零）

static UBYTE ADS1263_Checksum(UDOUBLE val, UBYTE byt)

• 数据等待函数，DEV_DRDY_PIN为DRDY引脚，在ADC1进行数据转换时有效，在数据准备好之后会发送一个低电平
  

PS：ADC2不适用

static void ADS1263_WaitDRDY(void)

• 芯片校验函数，返回值为1则IC为ADS1263，0为ADS1262
  

UBYTE ADS1263_ReadChipID(void)

• 模式设置函数，1为差分模式，默认为0单端模式
  

void ADS1263_SetMode(UBYTE Mode)

• ADC设置函数，设置ADC的速率、PGA增益倍数、参考电压等。
  

具体寄存器信息都可以查表确认，需要配置其他寄存器最好按例程方式每次写入后再读取验证。
为保证数据稳定减少多通道及两个ADC之间的串扰，例程使用的数据转换延时较大且转换速率较慢，如果有速度需要可以自行修改。
PS：ADC1在使用单端测量时不建议开启PGA（默认关闭）。

void ADS1263_ConfigADC1(ADS1263_GAIN gain, ADS1263_DRATE drate)
void ADS1263_ConfigADC2(ADS1263_ADC2_GAIN gain, ADS1263_ADC2_DRATE drate)

• 芯片初始化函数，包括复位、验证、配置ADC步骤。
  

UBYTE ADS1263_init(void)

• 选择通道函数，在需要切换ADC通道前先调用该函数。
  

static void ADS1263_SetChannal(UBYTE Channal)
static void ADS1263_SetChannal_ADC2(UBYTE Channal)
void ADS1263_SetDiffChannal(UBYTE Channal)
void ADS1263_SetDiffChannal_ADC2(UBYTE Channal)

• 读取ADC数据函数，ADC1返回值为32位数据，ADC2为24位数据。
  

static UDOUBLE ADS1263_Read_ADC1_Data(void)
static UDOUBLE ADS1263_Read_ADC2_Data(void)

• 获取指定通道的数据，根据模式的不同会有不同的效果，包含设置通道，读取数据操作。
  

UDOUBLE ADS1263_GetChannalValue(UBYTE Channel)
UDOUBLE ADS1263_GetChannalValue_ADC2(UBYTE Channel)

• 获取所有通道的数据，封装供其他文件调用，循环获取指定数量通道的数据。
  

获取到32位或24位的原始数据，如果要得到电压数据需要先将原始数据除以最大量程然后乘上参考电压。
而例程使用的树莓派5V（实测5.08V），因此最终电压数据为：ADC[i]/0x7fffffff*REF，负电压同理。

void ADS1263_GetAll(UDOUBLE *ADC_Value)
void ADS1263_GetAll_ADC2(UDOUBLE *ADC_Value)

• RTD测试函数，包含了RTD的寄存器配置、ADC1的数据转换及读取。
  

要得到温度数据需要先算出热电阻的阻值，根据 R=U/I，将两个电阻（热电阻、参考电阻）相除化简可得：R(热电阻)/R(参考电阻) = U(热电阻) * U(参考电阻) * 2
所以 RES = (ADC[0] / 0x7fffffff * 1) * 1 * 2 * 2000
最后根据热电阻公式可得温度，例程使用的是Pt100
因此 TEMP = (RES/100 - 1) / 0.00385

UDOUBLE ADS1263_RTD(ADS1263_DELAY delay, ADS1263_GAIN gain, ADS1263_DRATE drate)

• DAC测试函数，电压设置、输出引脚设置（正负极性）、打开或关闭DAC输出。
  

void ADS1263_DAC(ADS1263_DAC_VOLT volt, UBYTE isPositive, UBYTE isOpen)

PS：在main文件中，可以通过宏定义来快速修改需要进行的试验（ADC/RTD），REF 为参考电压如果需要精确测量可能需要您根据实际使用情况进行修改。

资料

提供文档、程序、数据手册等全套资料

文档

• 原理图

程序

• 示例程序
• GitHub链接

数据手册

• ADS1263

软件

• 相关开发软件

相关链接

树莓派入门教程（新）

树莓派入门教程 树莓派系列教程1：人生若只如初见 树莓派系列教程2：树莓派烧写镜像 树莓派系列教程3：访问树莓派 树莓派系列教程3：访问树莓派之SSH篇 树莓派系列教程3：访问树莓派之WiFi篇 树莓派系列教程4：树莓派raspi-config配置 树莓派系列教程5：linux常用命令以及vi/vim编辑器 树莓派教程系列6：文件共享(samba) 树莓派教程系列7：wiringPi、bcm2835、python库安装 树莓派系列教程8：如何点亮一个LED灯(上） 树莓派系列教程8 : 如何点亮一个LED灯（下） 树莓派系列教程9：按键 树莓派系列教程10：I2C 树莓派系列教程11：I2C编程 树莓派系列教程12：I2C总线控制BMP180 树莓派系列教程13：Serial串口 树莓派系列教程5：linux常用命令以及vi/vim编辑器 树莓派系列教程15：红外遥控 树莓派系列教程16：RTC 树莓派系列教程17：PCF8591 AD/DA 树莓派系列教程18：SPI Alphabot树莓派教程：变身路由器 Alphabot树莓派教程：刷LEDE(OpenWRT)系统变身路由器 树莓派引脚对照表 SIM868 ppp拨号上网 SIM7600 4G NDIS拨号上网

树莓派OpenCV教程 树莓派OpenCV系列教程1：开发环境搭建 树莓派OpenCV系列教程2：摄像头的基本使用 树莓派OpenCV系列教程3：IDE及图像存储的数据结构 树莓派OpenCV系列教程4：图像与视频载入、显示、输出 树莓派OpenCV系列教程5：ROI，绘图一站式解析 树莓派OpenCV系列教程6：10行代码添加国旗 树莓派OpenCV系列教程7：OpenCV中HighGUI及相关上位机开发 树莓派OpenCV系列教程8：绘图板综合项目

树莓派littleGL系列教程 树莓派littlevGL系列教程：littlevGL简单了解 树莓派littlevGL系列教程：基于Qt creator 树莓派littlevGL系列教程：基本对象 树莓派littlevGL系列教程：基本对象 树莓派littlevGL系列教程：圆弧对象 树莓派littlevGL系列教程：进度条 树莓派littlevGL系列教程：单按钮控件 树莓派littlevGL系列教程：矩阵按钮控件 树莓派littlevGL系列教程：日历控件 树莓派littlevGL系列教程：画布控件 树莓派littlevGL系列教程：复选框控件 树莓派littlevGL系列教程：图表控件 树莓派littlevGL系列教程：容器控件 树莓派littlevGL系列教程：仪表控件 树莓派littlevGL系列教程：下拉列表控件 树莓派littlevGL系列教程：图片控件 树莓派littlevGL系列教程：图片按钮控件 树莓派littlevGL系列教程：键盘控件 树莓派littlevGL系列教程：标签控件 树莓派littlevGL系列教程：线条控件 树莓派littlevGL系列教程：列表控件 树莓派littlevGL系列教程：线表控件 树莓派littlevGL系列教程：消息弹窗控件 树莓派littlevGL系列教程：页面控件 树莓派littlevGL系列教程：预加载控件 树莓派littlevGL系列教程：滑动列表控件 树莓派littlevGL系列教程：滑动条控件 树莓派littlevGL系列教程：微调框控件 树莓派littlevGL系列教程：滑动按钮控件 树莓派littlevGL系列教程：表格控件 树莓派littlevGL系列教程：选项卡控件 树莓派littlevGL系列教程：窗口控件 树莓派littlevGL系列教程：汉字显示 树莓派littlevGL系列教程：事件 树莓派littlevGL系列教程：任务系统 树莓派littlevGL系列教程：样式都有哪些属性

树莓派QT教程 树莓派Qt系列教程1：Qt GUI框架简述及了解 树莓派Qt系列教程2：开发环境搭建 树莓派Qt系列教程3：新建Qt Quick项目 树莓派Qt系列教程4：Qt基础知识理解 树莓派Qt系列教程5：Qt Quick 之 QML 入门 树莓派Qt系列教程6： QML语言基础 树莓派Qt系列教程7： 按钮控件类 树莓派Qt系列教程8： 信号与槽 树莓派Qt系列教程9：鼠标事件 树莓派Qt系列教程10：键盘事件 树莓派Qt系列教程11：定时器事件 树莓派Qt系列教程12：布局管理(上) 树莓派Qt系列教程12：布局管理(下) 树莓派Qt系列教程13：进度条ProgressBar 树莓派Qt系列教程14：滑块Slider 树莓派Qt系列教程15：滚动控件Scroll 树莓派Qt系列教程16：轮选框SpinBox 树莓派Qt系列教程17：组合框ComboBox 树莓派Qt系列教程18：行编辑输入控件 树莓派Qt系列教程19：块编辑输入控件 树莓派Qt系列教程20：对话框 树莓派Qt系列教程21：滑动导航模型SwipeView 树莓派Qt系列教程22：栈式导航模型StackView 树莓派Qt系列教程23：图像image 树莓派Qt系列教程24：BusyIndicator和Delay 树莓派Qt系列教程25：Dial和Switch 树莓派Qt系列教程26：Menu、Popup和Drawer 树莓派Qt系列教程27：TabBar和ToolBar 树莓派Qt系列教程28：ToolSeparator、ToolT 树莓派Qt系列教程29(上)：Qml和C++混合编程 树莓派Qt系列教程29(下)：Qml和C++混合编程 树莓派Qt系列教程30：源码方式搭建Qt开发环境

树莓派OpenWrt教程 树莓派OpenWrt入门教程1：系统编译和配置 树莓派OpenWrt入门教程2：打造移动便携的树莓派4G无线路由器

FAQ

问题：介绍说模块有30ksps采样速率，为什么AD测试达不到这个速率；

示例程序默认开启8通道高精度ADC，为了保证稳定性和准确性，程序读取数据及处理数据时加了延时，如果需要较高速率，可以将延时注释掉。优化输入的例程如下：

30K+_High-Precision_AD_HAT_Code

问题：运行程序后，出现了下图所示错误，IOError:[Errno 2]No such file or directory

• 检查config.txt文件，确认SPI打开，其它SPI设备注释掉，配置好后重启再运行：

sudo nano /boot/config.txt

问题：运行程序后，为什么都显示5V

• 未连接的空闲通道显示5.08V;芯片内部结构原因，是正常现象。
• 默认浮动电压为5.08V，不影响使用，如果不需要其他通道，可以关闭该通道或接GND

问题：测量电压不准确怎么办？

可以测量树莓派的3.3V 引脚确认是否为3.3V

问题：测量时波动比较大，应该怎么改善？

以下是一些可能的原因和改善办法：

• 采样速率过高，可以尝试降低速率
• 单端模式容易被干扰，采用差分模式可以一定程度减少干扰
• 切换通道可能会引入噪声，测量时减少通道切换可以一定程度改善结果
• 参考电压不稳定，使用稳定外部参考电压（AVDD-AVSS）可以减少噪音，提高稳定性
• 基准电压校准，不同的适配器给树莓派供电，基准电压可能有差异，比方说如果您用的

适配器是5.15V 的，请将这里的电压改为5.15V对比测试：

技术支持

联系人：黄工
EMAIL：3005763927@qq.com
电话：0755-83040712
QQ：3005763927
微信：扫下方二维码添加

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证