CayenneLPP

Cayenne低功率有效载荷

概述

Cayenne低功率有效载荷（LPP）提供了一种方便，简便的方法，可以通过LPWAN网络（例如Lorawan）发送数据。 Cayenne LPP符合有效载荷尺寸限制，可以将其降低至11个字节，并允许设备一次发送多个传感器数据。

此外，Cayenne LPP允许该设备以不同帧发送不同的传感器数据。为了做到这一点，每个传感器数据都必须在两个字节上前缀：

• 数据通道：唯一地识别设备中的每个传感器，例如。 “室内传感器”
• 数据类型：标识框架中的数据类型，例如。 “温度”。

有效载荷结构

1字节	1字节	n字节	1字节	1字节	m字节	...
Data1 ch。	Data1类型	数据1	Data2 ch。	Data2类型	数据2	...

数据类型

数据类型符合IPSO Alliance Smart Objects指南，该指南将每个数据类型标识为“对象ID”。但是，如下所示，进行了转换以将对象ID拟合到单个字节中。

 LPP_DATA_TYPE = IPSO_OBJECT_ID - 3200

每种数据类型可以使用1个或更多字节根据下表发送数据。

类型	IPSO	LPP	十六进制	数据大小	每位数据分辨率
数字输入	3200	0	0	1	1
数字输出	3201	1	1	1	1
模拟输入	3202	2	2	2	0.01签名
模拟输出	3203	3	3	2	0.01签名
照明传感器	3301	101	65	2	1个未签名的MSB
存在传感器	3302	102	66	1	1
温度传感器	3303	103	67	2	0.1°C签名的MSB
湿度传感器	3304	104	68	1	0.5％未签名
加速度计	3313	113	71	6	每个轴签名的MSB 0.001 g
晴雨表	3315	115	73	2	0.1 HPA未签名的MSB
陀螺仪	3334	134	86	6	每轴签名的MSB 0.01°/s
GPS位置	3336	136	88	9	纬度：0.0001°签名的MSB
					经度：0.0001°签名的MSB
					高度：0.01米签名的MSB

例子

带有2个温度传感器的设备

有效载荷（十六进制）	03 67 01 10 05 67 00 ff
数据通道	类型	价值
03⇒3	67⇒温度	0110 =272⇒27.2°C
05⇒5	67⇒温度	00ff =255⇒25.5°C

具有温度和加速传感器的设备

框架n

有效载荷（十六进制）	01 67 FF D7
数据通道	类型	价值
01⇒1	67⇒温度	ffd7 = -41课-4.1°C

框架n+1

有效载荷（十六进制）	06 71 04 D2 FB 2E 00 00
数据通道	类型	价值
06⇒6	71⇒加速度计	X：04D2 = +1234课 +1.234G
		y：fb2e = -1234课-1.234g
		Z：0000 =0⇒0G

示例使用

 #include 'CayenneLPP.h';

#define MAX_SIZE 200; // depends on spreading factor and frequency used

CayenneLPP Payload(MAX_SIZE);

float celsius = -4.1;
float accel[] = {1.234, -1.234, 0};
float rh = 30;
float hpa = 1014.1;
float latitude = 42.3519;
float longitude = -87.9094;
float altitude:10

int size = 0;

Payload.reset();
size = Payload.addTemperature(0, celsius);

if (size == 0) {
    // not enough byte left to add the data
}

else {
    // add function returned current payload size
}


Payload.addAccelerometer(1, accel[0], accel[1], accel[2]);
Payload.addRelativeHumidity(3, rh);
Payload.addBarometricPressure(4, hpa);
Payload.addGPS(5, latitude, longitude, altitude);

// Call LoRaWAN library to send the frame
LORA_SEND(Payload.getBuffer(), Payload.getSize());