README.md · pointcloudai/PCIR-Examples

#  PCIR-Examples
 
 ## 产品描述
 该工程是点云智能给人脸识别机器提供温度检测模组（PCIR-xxCx 系列产品的使用说明）。例程包括python例程，java例程，规格书，串口指令文档，及硬件设计文档。该产品系列支持Melexis MLX90640，MLX90641，MLX90621.
 
 1. [Python 例程](https://gitee.com/pointcloudai/PCIR-Examples/tree/master/visual_monitor)  命令行参数：python ir_demo.py -p serialPort  
 
    example: `python3 ir_demo.py -p /dev/cu.usbserial-1410`(/dev/cu.usbserial-1410 这个端口名称就是使用者实际的使用名称 例如：COMx on windows or /dev/cu.xxxxx on OSX)
 
 2. [Android 例程](https://gitee.com/pointcloudai/PCIR-Examples/tree/master/android_visual_monitor)
 
 ## 产品详情
 
  **1. 产品外观**

![MLX90640_1](https://images.gitee.com/uploads/images/2020/0324/182357_9950db7a_5484807.png "90640_board.png")
![MLX90640_2](https://images.gitee.com/uploads/images/2020/0324/181221_ca126112_5484807.png "90640_board.png")

**2. 电脑端开发套件（购买咨询：support@pointcloud.ai）**
1.   安装电脑端驱动 ([串口驱动](http://www.wch.cn/downloads/category/30.html)).
2.   连接Type-c线到电脑端和设备端. 
3.   安装python3 环境和 pySerial包(use pip tool).
3.   在PC端运行Visual monitor
该开发套件支持Windows 10, mac OS ,Unbuntu 系统。
![开发套件](https://images.gitee.com/uploads/images/2020/0324/182443_5826c56b_5484807.png "90640_devkit.png")

**2. 运行Visual Monitor 例程**

这个例程图形化的方式在电脑端显示拍摄物体的温度数据。
 ## Python 源代码 [visual monitor](https://gitee.com/pointcloudai/PCIR-Examples/tree/master/visual_monitor)

![MLX90640 Visual Monitor例程](https://images.gitee.com/uploads/images/2020/0317/230625_d4215c52_5484807.png "visual_monitor.png")

## 文档列表

1.    [串口命令行列表](https://gitee.com/pointcloudai/PCIR-Examples/blob/master/Doc/200313PCIR-xxCx%20series%E6%8C%87%E4%BB%A4%E6%89%8B%E5%86%8C%20v1.4.pdf)
2.    [产品规格书](https://gitee.com/pointcloudai/PCIR-Examples/blob/master/Doc/%E4%BA%A7%E5%93%81%E8%A7%84%E6%A0%BC%E4%B9%A6.pdf)
3.    [硬件接口使用](https://gitee.com/pointcloudai/PCIR-Examples/blob/master/Doc/PCIR-40C%E7%A1%AC%E4%BB%B6%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97.pdf)
4.    [版型尺寸](https://gitee.com/pointcloudai/PCIR-Examples/tree/master/Doc)

## 接口调用
 
 1. 接口: UART
 2. 串口速率:  **230400**  [固件版本 ver1.0 速率:460800]
 
## 返回数据帧格式
 
### Evaluate 模式
 该模式提供给客户用于快速评估产品的性能，指标是否满足产品的需求。产品模组只要插上电就可以连续往上位机发送数据。数据格式使用ASCII码显示温度数据。
 
 
 1. 插上电后输出的分辨率每个模组不一样 PCIR-40CA/PCIR-40CB 为 32x24=768个数据，PCIR-41CA/PCIR-41CB 为 16x12=198个数据.PCIR-21CA/PCIR-21CB 为 16*4=64个数据.
 
 3. 数据格式为小数点后两位的ascii数值
 
 4. 例如: 一帧数据 = 32x24(768 个数据，逗号隔开 \r\n为一帧) 
 
    	\r\n36.01,35.02,34.03....................37.01,36.21,36.01,35.02,34.03\r\n
 
### Operate 模式

该模式提供给客户集成到他们的脸部识别产品上：
      数据格式:  'DAT' + Data Bytes Length[2 bytes] + Envirment Temp[4 Bytes float type] + data[pixelx4bytes float] + '\r\n'

例如mlx90640 32x24 点阵:
     3Bytes + 2Byte + 4Bytes + 32X24X4 + 2Bytes = 3083Bytes
	 example mlx90641 16x12 pixel:
     3Bytes + 2Byte + 4Bytes + 16X12X4 + 2Bytes = 779Bytes
 
## 串口命令列表:
**串口命令典型使用方法:**

1.设置Operate模式： 'CMDE\x00\x19' ,即16进制： 43 4D 44 4D 00 19 
    2.设置2Fps： 'CMDF\x02\x1C', 即16进制：43 4D 44 46 02 1C
    3.打开端口接收数据： 'CMDC\x01\x18'，即16进制：43 4D 44 43 01 18
    4.解析数据帧 'DAT',读取2个字节 解析数据长度， 计算帧长度判断真尾是否为'\r\n'.
命令的使用说明详见[设计文档](https://gitee.com/pointcloudai/PCIR-Examples/tree/master/Doc)中的命令手册。
  
 1.    命令行长度 6BYTE = 'CMD'+Type[1Byte]+Value[1Byte]+CRC[1Byte].（除了设置common offset 命令长度 9 BYTES）
 
     Open     command:  Type = C  Value = [1-open | 0-close | 2- 1 Frame if Mode command ==0]
     Mode     command:  Type = M  Value = [0-receive frame manual | 1-receiver frame continuous]
     Object   command:  Type = O  value = [1-body measure| 0-object measure]
     Freq     command:  Type = F  Value = [0-1/2fps | 1-1fps | 2-2fps | 3-3fps | 4-4fps]
     Version  command:  Type = V  Value = [0]
     Evaluate command:  Type = E  Value = [ 0-Operate mode | 1- Evaluate mode | 2- get Evaluate mode status]
     （当该命令设置模式状态时, 该状态会写入ROM中，即使掉电也会保存状态)
    Offset get  command:  Type = T  Value = [0-get common offset]
    Offset set  command: this command have 9BYTE= 'CMDE'+Value[4Byte float format]+CRC[1Byte].
    (当设置offset 命令时，该值会写入ROM中，即使掉电也会保存)

2.    命令返回列表:  'RETCMD + Type[1Byte] + Value[multiple Byte] + '\r\n'

Open     result:   'RET' + Open Command[6 bytes] + '\r\n'
     Mode     result:   'RET' + Mode Command[6 bytes] + '\r\n'
     Object   result:   'RET' + Object Command[6 bytes] + '\r\n'
     Freq     result:   'RET' + Freq Command[6 bytes] + '\r\n'
     Version  result:   'RETCMDV' + firmware version[4 bytes] + ',' + calibrate version[4 bytes] + '\r\n'
     Evaluate command:  'RETCMDE' + type[1 bytes] + '\r\n'
     Offset   command:  'RETCMDT' + common offset[6 bytes] + '\r\n'

3.    错误指令返回列表: 'RETERR' + command[6 bytes] + '\r\n'

## 校准

the difference distance need calibration for accurate body temperature measurement. we offer calibration file to adjust actual temperature value suitable for real environment.  **for use calibration tools you maybe install**  [esp32-idf framework](https://docs.espressif.com/projects/esp-idf/en/stable/get-started/)

1.    src [src code](https://gitee.com/pointcloudai/PCIR-Examples/tree/master/calibration)
2.    calibration file: data/cali.dat there have two line. following is file structure of cali.dat ( **file name Can not be change** )

1    calibration version
    2.0  common offset of temperature

3.    compile to .bin file that firmware can recognition

cd [caliration directory]
    ./spiffsgen.py 20480 ./data/ ./cali_001.bin

4.    upload to device **/dev/cu.usbserial-1420 is changed to your real usb serial port** 
    
    ./esptool.py -p /dev/cu.usbserial-1420 -b 230400 --before default_reset  --after hard_reset --chip esp32 write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x110000 ./cali_001.bin

pointcloudai/PCIR-Examples

简介

发行版

贡献者

近期动态

pointcloudai/PCIR-Examples .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

pointcloudai/PCIR-Examples