树莓派Sense HAT (C)教程

产品概述

我是专为树莓派设计的传感器扩展板,板载了陀螺仪、加速度计、磁力计、气压计和温湿度传感器等,I2C接口通信,支持外接更多传感器。 如果你想把树莓派DIY成可以检测运动姿态、方位的机器人,或者想让树莓派采集周围环境的温湿度、大气压强等传感器数据,那就带上我吧。 

产品特点

  • 板载Raspberry Pi 40pin GPIO接口,适用于Raspberry Pi系列主板
  • 板载QMI8658C+AK09918(3轴加速度、3轴陀螺仪和3轴磁力计),可检测运动姿态、方位和磁场
  • 板载SHTC3数字温湿度传感器,可感知环境的温度和湿度
  • 板载LPS22HB大气压强传感器,可感知环境的大气压强
  • 板载TCS34087颜色识别传感器,可识别周围物体的颜色
  • 板载SGM58031芯片,4通道16位精度ADC,可扩展AD功能以便接入更多传感器
  • 引出I2C控制接口,方便接入STM32、Arduino等主控板
  • 提供完善的配套资料手册(Raspberry/STM32/Arduino等示例程序)

产品参数

产品参数
工作电压:3.3V
通信接口:I2C
逻辑电压:3.3V
产品尺寸:65 x 30.5(mm)
加速度计特性:分辨率:16位
量程(可选):±2、±4、±8、±16g
陀螺仪计特性:分辨率:16位
量程(可选):±16、±32、±64、±128、±256、±512、 ±1024、±2048°/sec
磁力计特性:分辨率:16位
量程:±4912µT
气压计特性:分辨率:24位压力数据,16位温度数据;
测量精度(常温下): ±0.025hPa
测量范围:260 ~ 1260 hPa
测量速率:1 Hz - 75 Hz
温湿度传感器特性:测量精度(湿度):±2% rH
测量范围(湿度):0% ~ 100% rH
测量精度(温度):±0.2°C
测量范围(湿度):-30 ~ 100°C
颜色识别传感器分辨率:4通道RGBC,每个通道16位
AD转换芯片分辨率:16位

产品大PK

PK项Sense HAT (B)树莓派Sense HAT备注
陀螺仪测量范围:±250/500/1000/2000 dps
分辨率:16位
测量范围:±245/500/2000 dps
分辨率:16位
B型角速度可选量程更多
加速度计测量范围:±2/4/8/16 g
分辨率:16位
测试范围:±2/4/8/16 g
分辨率:16位
 
磁力计测量范围:±49 gauss
分辨率:16位
测量范围:±4/8/12/16 gauss
分辨率:16位
B型磁力测量范围更广
气压计测量范围:260 ~ 1260 hPa
测量精度(常温下): ±0.025hPa
测量速率:1 Hz - 75 Hz
测量范围:260 ~ 1260 hPa
测量精度(常温下):±0.1 hPa 
测量速率:1 Hz - 25 Hz
B型大气压测量的精度更高,速率更快
温湿度传感器测量精度(湿度):±2% rH
测量范围(湿度):0% ~ 100% rH
测量精度(温度):±0.2°C
测量范围(温度):-30 ~ 100°C
测量精度:±4.5% rH
测量范围:20% ~ 80% rH
测量精度(温度):±0.5°C
测量范围(温度):15 ~ 40°C
B型温湿度测量的精度更高,范围更广
其他颜色识别传感器
高精度12位AD转换芯片
8×8 RGB LED矩阵
五向摇杆
B型板载颜色传感器,支持AD接入更多传感器

树莓派使用指南

硬件连接

与树莓派连接用到的引脚如右图所示:


实物硬件连接图:
接入树莓派Zero(可不加增高排座)

接入树莓派4(须加上增高排座)

开启I2C接口

  • 打开树莓派终端,输入以下指令进入配置界面
sudo raspi-config 
选择 Interfacing Options -> I2C ->yes 启动 i2C 内核驱动


然后重启树莓派:

sudo reboot

安装库函数

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版本,如果没有出现说明安装出错

python

sudo apt-get update
#python2
sudo apt-get install python-pip 
sudo pip install RPi.GPIO
sudo pip install spidev
sudo apt-get install python-smbus
#python3
sudo apt-get install python-pip3 
sudo pip3 install RPi.GPIO
sudo pip3 install spidev
sudo apt-get install python3-smbus

下载例程

sudo apt-get install p7zip-full
wget http://www.waveshare.net/w/upload/6/6c/Sense-HAT-B-Demo.7z
7z x Sense-HAT-B-Demo.7z -O./Sense-HAT-B-Demo
cd Sense-HAT-B-Demo

I2C设备地址

ADS1015: AD转换例程(STM32 , BCM2835,WringPi 和Python四种例程)设备地址:0x48
ICM-20948:9轴传感器例程(STM32 , BCM2835,WringPi 和Python四种例程)设备地址:0x68
LPS22HB:气压传感器例程(STM32 , BCM2835,WringPi 和Python四种例程 )设备地址:0x5C
SHTC3:温湿度传感器例程(STM32 , BCM2835,WringPi 和Python四种例程 )设备地址:0x70
TCS34725:颜色识别传感器例程(STM32 , BCM2835,WringPi 和Python四种例程 )设备地址:0x29

注:该模块的所有传感器的I2C地址均不同,用户可同时使用板载的所有传感器。

ICM20948示例程序 -9轴传感器演示

bcm2835程序

进入Linux终端,在终端执行以下命令。

cd ICM-20948/Raspberry\ Pi/bcm2835/
sudo make clean
sudo make
sudo ./ICM20948_DEMO

预期结果:

按下Ctrl+C结束程序。

wiringPi程序

进入Linux终端,在终端执行以下命令。

cd ICM-20948/Raspberry\ Pi/wiringPi/
sudo make clean
sudo make
sudo ./ICM20948_DEMO

预期结果:

按下Ctrl+C结束程序。

python程序

进入Linux终端,在终端执行以下命令。

cd ICM-20948/Raspberry\ Pi/python/
sudo python3 ICM20948.py

预期结果:

按下Ctrl+C结束程序。

STM32程序

该例程基于XNUCLEO-F103RB 开发板,通过串口2输出数据。 连线如下:

Sense HAT (B)STM32
VCC+5V/+3.3V
GNDGND
SDAPB9
SCLPB8

编译并下载程序:

打开串口助手,设置波特率为115200
预期结果:

参数校准和计算

计算加速度

程序测量出的加速度单位是LSB(最低有效位),实际使用中常常把单位换算成重力加速度(g)。模块的示例程序默认设置AFS_SEL=0,对应量程为16384 LSB/g(±2g),所以测量的实际加速度为:
?=Acceleration/16384 ,????:?

请参考:ICM-20948-v1.3.pdf 第12页

计算陀螺仪角速度

程序测量出的角速度单位是LSB(最低有效位),实际使用中常常把单位换算成角速度(°/秒)。模块的示例程序默认设置FS_SEL=2,对应量程为32.8 LSB/(°/s)(±1000°/秒),所以测量的实际角速度为:
ω=Gyroscope/32.8 ,Unit:°/s

请参考:ICM-20948-v1.3.pdf 第11页

LPS22HBTR示例程序-气压传感器演示

注意:气压传感器的温度检测只作为补偿作用,如需准确的温度检测,请观察SHTC3温湿度传感器的数值为准。

bcm2835程序

进入Linux终端,在终端执行以下命令。

cd LPS22HBTR/Raspberry\ Pi/bcm2835/
sudo make clean
sudo make
sudo ./LPS22HB

预期结果:

按下Ctrl+C结束程序。

wiringPi程序

进入Linux终端,在终端执行以下命令。

cd LPS22HBTR/Raspberry\ Pi/wiringPi/
sudo make clean
sudo make
sudo ./LPS22HB

预期结果:

按下Ctrl+C结束程序。

python程序

进入Linux终端,在终端执行以下命令。

cd LPS22HBTR/Raspberry\ Pi/python/
sudo python3 LPS22HB.py

预期结果:

按下Ctrl+C结束程序。

STM32程序

该例程基于XNUCLEO-F103RB 开发板,通过串口2输出数据。
连线如下:

Sense HAT (B)STM32
VCC(注意:跳线帽要跳到相应位置)+5V/+3.3V
GNDGND
SDAPB9
SCLPB8

编译并下载程序:

打开串口助手,设置波特率为115200
预期结果:

SHTC3示例程序-温湿度传感器演示

注意:树莓派自身发热会影响实际测量温度,板子有引出I2C接口,如需准确的环境温度,可将树莓派跟模块隔一段距离再通过线材来连接来检测。

bcm2835程序

进入Linux终端,在终端执行以下命令。

cd SHTC3/Raspberry\ Pi/bcm2835/
sudo make clean
sudo make
sudo ./SHTC3

预期结果:

按下Ctrl+C结束程序。

wiringPi程序

进入Linux终端,在终端执行以下命令。

cd SHTC3/Raspberry\ Pi/wiringPi/
sudo make clean
sudo make
sudo ./SHTC3

预期结果:

按下Ctrl+C结束程序。

python程序

进入Linux终端,在终端执行以下命令。

cd SHTC3/Raspberry\ Pi/python/
sudo python3 SHTC3.py

预期结果:

按下Ctrl+C结束程序。

STM32程序

该例程基于XNUCLEO-F103RB 开发板,通过串口2输出数据。
连线如下:

Sense HAT (B)STM32
VCC(注意:跳线帽要跳到相应位置)+5V/+3.3V
GNDGND
SDAPB9
SCLPB8

编译并下载程序:

预期结果:
传感器正常无错误,LED2亮起:


当空气湿度低于80%时LED3不亮。当空气湿度大于或等于80%时LED3亮起。

TCS34725示例程序-颜色识别传感器演示

bcm2835程序

进入Linux终端,在终端执行以下命令。

cd TCS34725/Raspberry\ Pi/bcm2835/
sudo make clean
sudo make
sudo ./main

预期结果:

按下Ctrl+C结束程序。

wiringPi程序

进入Linux终端,在终端执行以下命令。

cd TCS34725/Raspberry\ Pi/wiringPi/
sudo make clean
sudo make
sudo ./main

预期结果:

按下Ctrl+C结束程序。

python程序

在终端输入以下命令执行程序:

cd TCS34725/RaspberryPi/python3/
sudo python3 main.py

预期结果:

按下Ctrl+C结束程序。

STM32程序

该例程基于XNUCLEO-F103RB 开发板,通过串口2输出数据。
连线如下:

Sense HAT (B)STM32
VCC(注意:跳线帽要跳到相应位置)+5V/+3.3V
GNDGND
SDAPB9
SCLPB8

编译并下载程序:

打开串口助手,设置波特率为115200
预期结果:

这数据怎么转换成颜色呢?下面介绍一个工具,复制到浏览器打开即可

https://www.sioe.cn/yingyong/yanse-rgb-16/

也可以下载

https://www.waveshare.net/w/upload/0/05/Hexacolor3.7z



ADS1015示例程序-AD转换演示

bcm2835程序

进入Linux终端,在终端执行以下命令。

cd ADS1015/Raspberry\ Pi/bcm2835/
sudo make clean
sudo make
sudo ./AD

预期结果:

按下Ctrl+C结束程序。

wiringPi程序

进入Linux终端,在终端执行以下命令。

cd ADS1015/Raspberry\ Pi/wiringPi/
sudo make clean
sudo make
sudo ./AD

预期结果:

按下Ctrl+C结束程序。

python程序

进入Linux终端,在终端执行以下命令。

cd ADS1015/Raspberry\ Pi/python/
sudo python3 AD.py

预期结果:

按下Ctrl+C结束程序。

STM32程序

该例程基于XNUCLEO-F103RB 开发板,通过串口2输出数据。
连线如下:

Sense HAT (B)STM32
VCC(注意:跳线帽要跳到相应位置)+5V/+3.3V
GNDGND
SDAPB9
SCLPB8

编译并下载程序:

打开串口助手,设置波特率为115200
预期结果: