Sentry-Arduino¶

Sentry-Arduino 库是一个专门为 Arduino 系列开发板定制打造的驱动库，适用于 Sentry 全系列产品，用户可以使用该库迅速上手获取 Sentry 的识别结果，以及设置相关参数。

安装¶

下载 Sentry .zip 库。
打开 Arduino IDE ，点击 项目->加载库->添加.ZIP库，选择上一步中下载的 .zip 文件，点击 确定 按钮完成库的添加。

快速上手¶

Arduino 库中提供了丰富的例程，这些例程默认使用了 串口模式，以下内容均以串口模式作为通讯方式。

接线

默认使用串口模型，将 Sentry 对应的线接至 Arduino 除 Serial 外任意串口上。

Arduino

Sentry

TX

RX

RX

TX

Attention

Arduino Uno 只有一个硬件串口（用于传输打印信息至电脑端），建议使用软串口与 Sentry 进行通讯。
设置 Sentry 的通讯模式
- 将 Sentry 右上角摇杆向右拨动三次进入硬件配置界面，将 Output 设置为 UART，点击 YES 并向左拨动三次摇杆退出设置。
烧录例程

打开 Arduino IDE，依次点击 File->Examples->Sentry，选择任意例程，点击 Upload 上传程序至 Arduino 主控。
观察现象

程序烧录完毕后，打开 Arduino IDE 中的 Serial Monitor，识别到算法对应的物体后即会有相应的结果输出。

Arduino	Sentry
TX	RX
RX	TX

使用¶

初始化

Sentry-Arduino 库支持 UART/I2C 两种通讯方式，用户可以通过以下方式初始化 Sentry。
UART:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
#include <Arduino.h>
#include <Sentry.h>

/* 定义 Sentry 型号，此处使用了 Sentry2 作为例子，可替换成其他型号如 Sentry1 等 */
typedef Sentry2 Sentry;

/* 实例化 Sentry，创建 Sentry 变量，并指定 Sentry 地址为 0x60 */
Sentry sentry(0x60);

void setup() {
    /* 设置 Arduino(mega2560) 串口3波特率与 Sentry 一致 */
    Serial3.begin(9600);
    /* 使用串口初始化 Sentry，若 err 返回为 0，则初始化正常，否则返回对应错误码。 */
    sentry_err_t err = sentry.begin(&Serial3);
}
Attention

Arduino 部分型号（如：UNO）只有一个硬件串口，该类主控上建议使用软串口。
I2C
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
#include <Arduino.h>
#include <Sentry.h>
#include <Wire.h>

/* 定义 Sentry 型号，此处使用了 Sentry2 作为例子，可替换成其他型号如 Sentry1 等 */
typedef Sentry2 Sentry;

/* 实例化 Sentry，创建 Sentry 变量，并指定 Sentry 地址为 0x60 */
Sentry sentry(0x60);

void setup() {
    Wire.begin();
    /* 使用 I2C 初始化 Sentry，若 err 返回为 0，则初始化正常，否则返回对应错误码。 */
    sentry_err_t err = sentry.begin(&Wire);
}
Note

若返回非 0 错误，则表示通讯异常，请检查主控代码中的选择通讯模式（UART/I2C）与 Sentry 上的通讯模式是否一致。

实例化 Sentry 时地址可以设置为任意值，需与 Sentry 设备显示的地址一致，地址默认值为 0x60。

Warning

同时开启过多算法会导致算法执行速度变慢，响应时间变长，部分内存较小的主控会出现内存不足而导致初始化失败的情况。

开启算法

1
2
/* 开启卡片检测算法 */
err = sentry.VisionBegin(Sentry::kVisionCard);
Note

当前 Sentry2 支持的算法包括：

颜色识别

kVisionColor

色块检测

kVisionBlob

AprilTag

kVisionAprilTag

线条检测

kVisionLine

深度学习

kVisionLearning

卡片检测

kVisionCard

人脸检测

kVisionFace

20类物体检测

kVision20Classes

二维码识别

kVisionQrCode

运动物体

kVisionMotionDetect

算法具体介绍可见： Vision

获取算法识别结果

void loop() {
    unsigned long ts = millis();
    /* 获取算法识别到目标的数量 */
    int obj_num = sentry.GetValue(Sentry::kVisionCard, kStatus);
    unsigned long te = millis();
    if (obj_num) {
        printf("Totally %d objects in %lums:\n", obj_num, te - ts);
        /* 打印算法所有识别到物体的位置和标签 */
        for (int i = 0; i < obj_num; ++i) {
            int x = sentry.GetValue(Sentry::kVisionCard, kXValue, i);
            int y = sentry.GetValue(Sentry::kVisionCard, kYValue, i);
            int w = sentry.GetValue(Sentry::kVisionCard, kWidthValue, i);
            int h = sentry.GetValue(Sentry::kVisionCard, kHeightValue, i);
            int l = sentry.GetValue(Sentry::kVisionCard, kLabel, i);
            printf("  obj[%d]: x=%d,y=%d,w=%d,h=%d, label=%s\n", i, x, y, w, h, l);
        }
    }
}

Tip

通过重定向标准输出流到对应的串口，可以在 Arduino 上使用 printf 向对应串口打印输出字符。（该方法当前不支持浮点数打印输出，且会占用更多内存，可能会引起内存不足等问题，不建议在非调试环境下使用）

/* 将标准输出流重定向至串口 */
int serial_putc(char c, struct __file*) {
    Serial.write(c);
    return c;
}

void setup() {
    /* 在初始化函数中初始化串口和标准输出流 */
    Serial.begin(9600);
    fdevopen(&serial_putc, 0);
}

开启 WiFi
WiFi 的启动与关闭可通过 WiFiConfig 函数进行控制。
1
sentry.WiFiConfig(true, kWiFiBaud1152000);

截屏

截屏后可选择将图片保存于 SD卡，或通过 USB/UART/WiFi 发送至其他设备。

完整例程
1
2
3
4
5
6
7
8
#define SNAPSHOT_TO_SD_CARD false
#define SNAPSHOT_TO_UART false
#define SNAPSHOT_TO_USB false
#define SNAPSHOT_TO_WIFI true
#define SNAPSHOT_FROM_SCREEN false

sentry.Snapshot(SNAPSHOT_TO_SD_CARD, SNAPSHOT_TO_UART, SNAPSHOT_TO_USB,
                SNAPSHOT_TO_WIFI, SNAPSHOT_FROM_SCREEN);
Attention

想要通过 USB/UART/WiFi 发送至其他设备前需要手动先开启对应的 USB/UART/WiFi 设备哦！

例程¶

所有例程在 Arduino 库中 examples/ 文件夹下，可通过点击 Arduino IDE 上方 文件→例程→Sentry 找到对应算法的相关调用例程。

../../_images/arduino_sentry_examples.png

Note

可通过开启或关闭例程中 I2C 和 UART 的相关宏定义来选择串口通讯模式或 I2C 通讯模式：

/* 打开 SENTRY_UART 宏，关闭 SENTRY_I2C 即表示为串口通讯模式 */
// #define SENTRY_I2C
#define SENTRY_UART

/* 打开 SENTRY_I2C 宏，关闭 SENTRY_UART 即表示为 I2C 通讯模式 */
#define SENTRY_I2C
// #define SENTRY_UART

API 说明¶

enum sentry_obj_info_e¶

算法结果

enumerator kStatus¶

检测到目标的数量

enumerator kXValue¶

目标的横向坐标

enumerator kYValue¶

目标的纵向坐标

enumerator kWidthValue¶

目标宽度

enumerator kHeightValue¶

目标高度

enumerator kLabel¶

目标标签*（类别）

enumerator kRValue¶

目标红色通道值

enumerator kGValue¶

目标绿色通道值

enumerator kBValue¶

目标蓝色通道值

enum sentry_camera_zoom_e¶

摄像头缩放等级

enumerator kZoomDefault¶

默认缩放等级

enumerator kZoom1¶

enumerator kZoom2¶

enumerator kZoom3¶

enumerator kZoom4¶

enumerator kZoom5¶

enum sentry_camera_fps_e¶

摄像头帧率

enumerator kFPSNormal¶

摄像头普通帧率（约 25 fps）

enumerator kFPSHigh¶

摄像高帧率模式（约 50 fps）

enum sentry_camera_white_balance_e¶

摄像头白平衡模式

enumerator kAutoWhiteBalance¶

摄像头自动白平衡

enumerator kLockWhiteBalance¶

摄像头锁定白平衡（将白平衡参数固定在当前数值）

enumerator kWhiteLight¶

摄像头白光模式

enumerator kYellowLight¶

摄像头黄光模式

enum sentry_baudrate_e¶

串口波特率

enumerator kBaud9600¶

enumerator kBaud19200¶

enumerator kBaud38400¶

enumerator kBaud57600¶

enumerator kBaud115200¶

enumerator kBaud921600¶

enumerator kBaud1152000¶

enumerator kBaud2000000¶

class Sentry2¶

Sentry2 驱动，支持 I2C/UART 两种通讯方式。

enum sentry_vision_e¶

算法类型

enumerator kVisionColor¶

颜色识别算法

enumerator kVisionBlob¶

颜色检测算法

enumerator kVisionAprilTag¶

AprilTag 算法

enumerator kVisionLine¶

线条检测算法

enumerator kVisionLearning¶

深度学习算法

enumerator kVisionCard¶

卡片检测算法

enumerator kVisionFace¶

人脸检测算法

enumerator kVision20Classes¶

20 类通用物体检测算法

enumerator kVisionQrCode¶

二维码检测算法

enumerator kVisionMotionDetect¶

移动物体检测算法

Sentry(uint32_t address = 0x60)¶

Sentry 构造函数。

Parameters: address – Sentry 地址，可选值为 0x60,0x61,0x62,0x63，默认值为 0x60

uint8_t begin(HwSentryUart::hw_uart_t communication_port)¶

使用串口模式初始化 Sentry。

Parameters: communication_port – 串口号
Returns: 错误码，返回 SENTRY_OK，则初始化成功，其他，则初始化失败

uint8_t begin(HwSentryI2C::hw_i2c_t *communication_port)¶

使用 I2C 模式初始化 Sentry。

Parameters: communication_port – I2C 端口号
Returns: 错误码，返回 SENTRY_OK，则初始化成功，其他，则初始化失败

uint8_t VisionBegin(sentry_vision_e vision_type)¶

开启对应算法

Parameters: vision_type – 算法类型
Returns: 错误码，返回 SENTRY_OK，则初始化成功，其他，则开启失败

uint8_t VisionEnd(sentry_vision_e vision_type)¶

关闭对应算法

Parameters: vision_type – 算法类型
Returns: 错误码，返回 SENTRY_OK，则关闭成功，其他，则关闭失败

int GetValue(sentry_vision_e vision_type, sentry_obj_info_e obj_info, int obj_id = 0)¶

读取对应算法的结果

Parameters

vision_type – 算法类型
obj_info – 结果类型
obj_id – 结果 ID，默认为 0

Returns

对应结果的值

char *GetQrCodeValue()¶

读取二维码识别结果

Returns: 二维码识别到的字符串

uint8_t SetParamNum(sentry_vision_e vision_type, int max_num)¶

设置单次检测最大返回结果的数量

Parameters

vision_type – 算法类型
max_num – 检测结果数量

Returns

错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

uint8_t SetParam(sentry_vision_e vision_type, sentry_object_t *param, int param_id)¶

设置检测参数

Parameters

vision_type – 算法类型
param – 检测结果参数及对应的值
param_id – 参数 ID

Returns

错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

uint8_t CameraSetZoom(sentry_camera_zoom_e zoom)¶

设置摄像头缩放等级

Parameters: zoom – 缩放等级
Returns: 错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

uint8_t CameraSetRotate(bool enable)¶

设置摄像头图像旋转

Parameters: enable – true：图像旋转 180°
Returns: 错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

uint8_t CameraSetFPS(sentry_camera_fps_e fps)¶

设置摄像头帧率

Parameters: fps – 摄像头帧率
Returns: 错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

uint8_t CameraSetAwb(sentry_camera_white_balance_e awb)¶

设置摄像头白平衡

Parameters: awb – 摄像头白平衡模型
Returns: 错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

uint8_t UartSetBaudrate(sentry_baudrate_e baud)¶

设置串口波特率

Parameters: baud – 串口波特率
Returns: 错误码，返回 SENTRY_OK，则设置成功，其他，则设置失败

int rows()¶

获取图像实际宽度

Returns: 图像宽度

int cols()¶

获取图像实际高度

Returns: 图像高度

FAQ¶

编译例程提示： error: 'Serial3' was not declared in this scope

某些 Arduino 硬件（如 UNO R3 等）只有一个硬件串口，此硬件串口一般留与电脑等上位机通讯打印调试信息，所以此时需要使用其他硬件串口或软串口

Note

软串口使用例程：

#include <SoftwareSerial.h>
#include <Sentry.h>

// 此处定义软串口的 TX 和 RX 引脚
#define rxPin 10
#define txPin 11

SoftwareSerial mySerial =  SoftwareSerial(rxPin, txPin);

typedef Sentry2 Sentry;
Sentry sentry;

void setup()  {
    // Define pin modes for TX and RX
    pinMode(rxPin, INPUT);
    pinMode(txPin, OUTPUT);

    // 此处使用软串口 mySerial 代替 Serial3 即可
    mySerial.begin(9600);
    while (SENTRY_OK != sentry.begin(&mySerial)) { yield(); }
}

Arduino 串口监视器上打印乱码

首先确认下是否使用了串口，其次确认下代码中及连线是否使用了默认硬件串口 Serial，在 Arduino 中，硬件串口 Serial 被用于与电脑通讯，如果与 Sentry 连接并且打开串口监视器会将二者的通讯内容打印至电脑串口监视器，从而显示乱码，请使用其他硬件串口或软串口代替默认串口 Serial 与 Sentry 通讯。

WiFi Sentry-Mixly

颜色识别	kVisionColor
色块检测	kVisionBlob
AprilTag	kVisionAprilTag
线条检测	kVisionLine
深度学习	kVisionLearning
卡片检测	kVisionCard
人脸检测	kVisionFace
20类物体检测	kVision20Classes
二维码识别	kVisionQrCode
运动物体	kVisionMotionDetect

Tosee documentation

Sentry-Arduino¶

安装¶

快速上手¶

使用¶

例程¶

API 说明¶

FAQ¶