基于聆思CSK6视觉AI开发套件实现剪子包袱锤游戏

本文来自极术社区聆思CSK6视觉AI开发套件试用活动文章。作者用聆思CSK6芯片支持的手势识别能力结合8X8点阵实现一款剪子包袱锤的游戏。

一 开发环境搭建

1.1 硬件环境

如下图所示，本次产品有聆思的CSK6011-NanoKit视觉开发套件和8*8点阵组成，CSK6011-NanoKit负责手势的识别，点阵负责图形的显示，两者通过SPI总线连接在一起。

1.2 软件环境

软件开发环境搭建可以参考CSK6环境搭建，聆思很贴心的提供了完整的打包开发环境，利用lisa工具可以完成项目的创建、编译和下载，此外厂商还基于VSCODE插件的方式提供了完整的IDE开发环境。

二 点阵的使用

2.1 硬件连接

8x8点阵的主控是GC7219（完全兼容MAX7219），其典型的应用图如下所示：

芯片可以通过GPIO或者SPI来驱动，官方提供了SPI的参考demo，本次将基于其实现对点阵的控制。将GC7219（点阵）与CSK6011的SPI0连接，利用板载的3.3V管脚供电，相关管脚的连接示意图如下：

2.2 图标建模

由于CSK6011目前支持5种手势，分别为LIKE()、OK()、STOP()、YES()、SIX()，采用相似原则，取LIKE=锤，STOP=包袱，YES=剪刀。相关示图标建模（共阴）如下：

2.3 驱动开发

2.3.1 建立SPI开发工程

参见SPI参考工程的实现，搭建SPI驱动开发工程。

2.3.2 GC7219的适配

由GC7219的手册可知，其支持MSB模式，且最高频率只有10M，因此spi的Config需要做如下修改。

 

    /* spi master 8bit, LSB first*/
    spi_cfg.operation = SPI_WORD_SET(8) | SPI_OP_MODE_MASTER | SPI_TRANSFER_LSB;
    spi_cfg.frequency = 10 * 1000000UL;

 

改为：

 

    /* spi master 8bit, MSB first*/
    spi_cfg.operation = SPI_WORD_SET(8) | SPI_OP_MODE_MASTER | SPI_TRANSFER_MSB;
    spi_cfg.frequency = 5 * 1000000UL;

 

2.3.3 添加点阵驱动

如图2.2所示，GC7219支持共阴点阵，各图像的数组定义如下代码片段。

 

unsigned char jiandao_table[8][2] = {
    {0x01,0x24},{0x02,0x24},{0x03,0x24},{0x04,0x7E},
    {0x05,0x7E},{0x06,0x7E},{0x07,0x7E},{0x08,0x00}
};


unsigned char shitou_table[8][2] = {
    {0x01,0x00},{0x02,0x40},{0x03,0x40},{0x04,0x7C},
    {0x05,0x7C},{0x06,0x7C},{0x07,0x7C},{0x08,0x00}
};


unsigned char bu_table[8][2] = {
    {0x01,0x08},{0x02,0x1C},{0x03,0x1E},{0x04,0x1E},
    {0x05,0x5E},{0x06,0x7E},{0x07,0x7E},{0x08,0x00}
};

 

由zephr的API调用可知，其发送函数spi_write需要传入一个数据链表，然后会按照列表逐一发送相关数据，完整的代码如下：

 

/*
 * SPDX-License-Identifier: Apache-2.0
 */


#include 
#include 
#include 
#include 
#include 
#include 
#include 


unsigned char work_state[2]={0x0C, 0x1};  // normal work mode
unsigned char test_state[2]={0x0F, 0x0};  // no test mode
unsigned char decode_cfg[2]={0x09, 0x0};  // no decode
unsigned char scan_range[2]={0x0B, 0x7};  // scan 0-7


unsigned char jiandao_table[8][2] = {
    {0x01,0x24},{0x02,0x24},{0x03,0x24},{0x04,0x7E},
    {0x05,0x7E},{0x06,0x7E},{0x07,0x7E},{0x08,0x00}
};


unsigned char shitou_table[8][2] = {
    {0x01,0x00},{0x02,0x40},{0x03,0x40},{0x04,0x7C},
    {0x05,0x7C},{0x06,0x7C},{0x07,0x7C},{0x08,0x00}
};


unsigned char bu_table[8][2] = {
    {0x01,0x08},{0x02,0x1C},{0x03,0x1E},{0x04,0x1E},
    {0x05,0x5E},{0x06,0x7E},{0x07,0x7E},{0x08,0x00}
};


#define TX_PACKAGE_MAX_CNT    8


void main(void)
{
    int idx=0;
    const struct device *spi;
    struct spi_config spi_cfg = {0};
    struct spi_buf_set tx_set;
    unsigned char digit[2]={0};


    printk("spi master example
");


    spi = DEVICE_DT_GET(DT_NODELABEL(spi0));
    if (!device_is_ready(spi)) {
        printk("SPI device %s is not ready
", spi->name);
        return;
    }


    /* spi master 8bit, LSB first*/
    spi_cfg.operation = SPI_WORD_SET(8) | SPI_OP_MODE_MASTER | SPI_TRANSFER_MSB;
    spi_cfg.frequency = 5 * 1000000UL;


    /* Make spi transaction package buffers */
    struct spi_buf *tx_package = k_calloc(TX_PACKAGE_MAX_CNT, sizeof(struct spi_buf));
    if (tx_package == NULL) {
        printk("tx_package calloc failed
");
        return;
    }


    /* Init 7219 */
    tx_package[0].buf = work_state;
    tx_package[0].len = 2;
    tx_package[1].buf = test_state;
    tx_package[1].len = 2;
    tx_package[2].buf = decode_cfg;
    tx_package[2].len = 2;
    tx_package[3].buf = scan_range;
    tx_package[3].len = 2;


    tx_set.buffers = tx_package;
    tx_set.count   = 4;


    printk("Init 7219 ...
");
    spi_write(spi, &spi_cfg, &tx_set);


    do {
        k_msleep(1000);
        printk("spi master sending jiandao_table data ...
");
        for (idx=0; idx<8; idx++) {
            digit[0]=jiandao_table[idx][0];
            digit[1]=jiandao_table[idx][1];
            tx_package[0].buf = digit;
            tx_package[0].len = 2;
            tx_set.buffers    = tx_package;
            tx_set.count      = 1;
            spi_write(spi, &spi_cfg, &tx_set);
        }


        k_msleep(1000);
        printk("spi master sending shitou_table data ...
");
        for (idx=0; idx<8; idx++) {
            digit[0]=shitou_table[idx][0];
            digit[1]=shitou_table[idx][1];
            tx_package[0].buf = digit;
            tx_package[0].len = 2;
            tx_set.buffers    = tx_package;
            tx_set.count      = 1;
            spi_write(spi, &spi_cfg, &tx_set);
        }


        k_msleep(1000);
        printk("spi master sending bu_table data ...
");
        for (idx=0; idx<8; idx++) {
            digit[0]=bu_table[idx][0];
            digit[1]=bu_table[idx][1];
            tx_package[0].buf = digit;
            tx_package[0].len = 2;
            tx_set.buffers    = tx_package;
            tx_set.count      = 1;
            spi_write(spi, &spi_cfg, &tx_set);
        }
    } while (1);
}

 

2.3.4 搭建AI工程

参考文档AI能力-视觉的相关步骤搭建AI工程，这里主要说明一下遇到的几个问题和注意事项。

1）因为此处使用的是最新git工程，所以打印可能与文档有出入，git版本和打印对应如下：

2）如果直接下载git工程编译升级，PC端工具无法正常使用，需要执行如下两条命令，参考连接一键拉取-sample-和-sdk-异常解决方法，然后再执行编译烧写操作。

 

lisa zep init-app 
lisa zep update

 

3）基于Edge浏览器如果直接打开在线PC工具，点击"Windows系统"会出现404错误，所以建议直接下载pc工具工程到本地离线使用。

 

git clone https://cloud.listenai.com/zephyr/applications/csk_view_finder_spd.git

 

4）执行"lisa zep flash"后如果立即执行如下资源下载命令可能会失败，这时候建议拔插一下DAP口或者检查一下串口是否被占用。

经过上述步骤以后，通过PC端工具查看效果如下：

2.3.5 识别和显示

将SPI-GC7219的工程和AI手势识别的工程融合在一起，程序流程如下：

三 效果展示

效果如下，机器会根据人类的出拳来出拳，用来给做简单的演示还是挺有意思的。

四 总结

整体体验下来，感觉聆思在SOM的易用性、接口的完整性、文档的丰富度、和支持的及时性上做的都不错，按照文档一步步做下来，很快就可以入门做一些简单的产品。美中不足的是目前聆思的AI训练和调参工具还没有面向大众开放，可能是因为技术性比较强，但因此少了一部分趣味性，在手势AI识别的demo中也能够感觉到光照和距离对识别的准确性影响很大，但是在如此低的功耗和性能下做到这样的程度已经很棒了。最后祝聆思科技的产品越做越棒，极术社区越做越大带给广大开发兴趣人员更多丰富的活动。

转自 | 安谋科技学堂

　　审核编辑：汤梓红