安服优F-1串口存储 日志数据存储模块

一、产品介绍

F-1离线串口日志记录器是由深圳市安服优智能互联科技有限公司开发的一款智能工具，该记录器可以用于UART数据的离线记录，将UART数据线上发送的内容存储于SD卡中，为开发调试与产品测试带来极大方便。F-1离线串口日志记录器采用32位MCU作为主控，能够大幅度提升串口波特率的速度，在高速连续传输下仍能保证日志记录的完整，该记录器还支持时间戳、HEX存储、文本过滤等功能。

二、应用场景

F-1日志记录器也可以做为工控设备，无人机，机器人等设备的黑匣子，工作稳定，数据记录完整可靠，成本低。

三、产品参数

主要参数如下表所示：

接口定义

接口定义如下图所示：

注：调试口的3.3V和GND是对外供电，并不用于给本模块供电。需使用记录串口供电口。

USB-TTL模块  --------->  日志记录模块【串口通信接口】

GND  --------->      GND

RXD  --------->      TXD

TXD  --------->      RXD

3.3V或5V ---------> 3.3V 或 5V选其中一种接即可

打开Sscom串口调试助手：默认波特率：115200，不是HEX格式不要勾选HEX显示,但记得一定要 勾选“加回车换行”再去发送指令~

四、使用说明 

由于使用说明总体篇幅过长，所以节选部分使用说明内容展示，大家可以在“未购买允许下载附件：”查看完整使用说明

4.1．SD卡存储

sd卡文件系统需为FAT32.

param_config.txt为配置参数的文件，如果被删除，在上电或者SD卡重新插入时会自动创建。此时如据配置文件中param hexlog为1的配置新建log.hex.txt若param hexlog为0会新建log.txt文件。

log.txt为文本格式的日志文件，存储的是UART接收到的直接数据流，可用于文本日志或CSV表格。

log.hex.txt为HEX格式的日志文件，存储时将接收到的数据转化为可视HEX存储。

4.1.2．生成csv表格

当配置为文件名为csv且设置csvbyte大于0时，日志记录器在接收数据时会自动生成行与列，单元格的字符个数由csvbyte参数定义。

csv 表格在csvbyte大于0时,还可以配置序号跟表头，序号会在csv文件的第一列插入递增的数字，表头是在文件新建时自动插入。

4.1.3．读日志

使用read命令可以读出指定的文件，或者读时间戳之间的日志。

4.1.4．时间戳配置

串口日志模块配置时间戳注意事项：

1、一定要接侧边的调试串口才可以配置时间戳，如小图所示侧边调试串口

2、侧边3V3是不接电的，需要在底部通信串口接3.3V 或 5V选其中一种来供电

3、装纽扣电池，不装电池断电就没有时间戳了，纽扣电池的作用就是断电也能保持RTC时间。

4、线要接正确，

侧边调试串口接线说明:

GND--> GND

    RXD-->TXD

    TXD-->RXD

5、如果接线对了还是时间戳没成功，看看是不是排针或是线松了没卡紧导致没配置好。

6、以下是成功配置时间戳如下图：

7、命令：param usetime 时间戳使能查询与设置: 

param usetime 1为使能，param usetime 0 为关闭

4.1.5．波特率配置

4.2. 调试模式

4.2.1调试串口配置

115200波特率 数据位8bit 停止位1bit 无校验位 关闭hex发送 结尾加上回车换行。

4.2.2调试命令说明（节选部分）

通过调试串口可以命令查询与修改配置参数，在PC上使用串口工具可以发送调试命令，命令须以回车换行为结尾。

命令列表：

4.2.3使用记录串口收发调试命令

使用记录串口发送配置命令前需要将sd卡中param_config.txt文件中的cmden设置为1（如果没有该配置在文件最后加上cmden 1即可）。注意在使用记录串口配置时hexlog需要关闭。如果您不想在记录时由于记录数据与我们的配置命令相似导致记录器配置变更可以关闭此功能，如果是记录串口发送命令需要发：param cmden 1。

4.3. 配置文件

4.3.1 使用配置文件设置参数

除了命令调试命令，在SD卡根目录下的param_config.txt文件也可以查询与设置参数，参数的范围与调试命令一致。

4.3.2 使用配置文件设置过滤词

是配置文件中的filterstr与filterhex不需要指定位置，只需要逐行写下即可。

五、演示视频

视频一是对模块进行软件烧录工作，一般是出货前软件已经烧录成功，无需买家在烧录

视频二是演示模块收发演示

视频二说明：用模块底部串口进行通信收发，侧边串口只是用来调试和配置参数；

1、视频中，用了USB转ttl连接串口日志模块进行测试收发txt文件进行测试

接线如下：USB-TTL模块  --------->  日志记录模块【串口通信接口】

GND  --------->      GND

RXD  --------->      TXD

TXD  --------->      RXD

3.3V或5V ---------> 3.3V 或 5V选其中一种接即可

2、正确连线之后，模块的黄绿灯会闪烁一秒，接着是黄灯持续闪烁等待识别TF；

3、插入TF卡之后黄灯会熄灭，说明模块已经识别到卡了，如果没有黄灯没熄灭证明没识别到卡，熄灭黄灯才算识别到卡；

4、打开串口调试工具sscom工具，选择一个txt的测试文件发送到模块卡中，发送过程黄绿灯会快闪，文件发送完毕会黄绿灯会熄灭；

5、文件发送完毕后，取出TF卡，用读卡器读卡文件即可。

六、注意事项

1.在LED2亮的时候不要拔出SD卡，否则可能造成文件损坏

2.掉电后RTC时钟保持需要安装RTC电池

3.调试口的3.3V为对外供电，不能给本模块供电

七、FAQ

Q: 离线串口记录器适用于什么设备？

A: arduino、树莓派、STM32等各种单片机设备。

Q: 离线串口记录器传输数据稳定吗？

A: 稳定，经过高压测试，可以长时间存储数据并且不会丢失。

Q: 功耗怎么样？

A: 待机无写卡时电流一般为6mA多，休眠电流小于6uA，功耗非常低。

Q: 文件存满了会怎样？

A: 文件存满了会自动删除早期的文件，循环存储

Q: 卡支持热拔插吗？

A: 在模块供电且串口无数据写入时拔插卡都是安全的，如果卡正在写数据，可能会丢失正在写入的数据，在高速连续写入时拔插也可能会损失文件系统。

Q: 时间戳使用什么样的格式？

A: 时间戳使用24小时制，包括年月日 时分秒 毫秒。

Q: 我的卡没有记录数据怎么办？

A: 首先查看模块的灯有没有亮，有没有正确供电，可以查看调试日志有没有正常读到卡，确认卡有没有正确格式化为FAT32文件系统，在使用3.3V供电时有一些SD卡要求的工作电压较高可能会无法正常初始化，这样的卡可以使用5V供电尝试。

Q: 怎么给RTC校时？

A: 使用调试串口或者数据串口的time命令，数据串口使用调试命令前需要先打开cmden。

Q: 读时间戳没有读到所有的日志是什么原因？

A: 时间戳的检索会使用到文件的时间戳，如果SD卡中的日志文件在电脑上被编辑过，它的时间戳会改变，日志模块检索时会过滤掉这样的文件。

Q: 我的串口不是3.3V TTL能记录吗？

A：如果是232或者485接口，可以搭配安服优PIN2PIN的232转接模块/485转接模块，如果是1.8V或者5V的UART，也可以搭配使用安服优的电平转换模块。