OneNET麒麟座应用开发之九：与SD卡通讯并保存数据

由于需要记录的数据量比较大，而且有些时候，有的用户不方便实时上传数据，所以要求使用SD卡存储数据然后人工收取上传。为此我们选择了一种通用的SD卡读写器。

1、读卡器简介

该读卡器整合 SD 卡规范和 FAT 文件格式规范，只要通过本模块规定的通讯协议就可以把数据存储在 SD 卡中的文件中。该读卡器连接方便采用串口通讯方式，如下图：

该读卡器摸块通讯协议比较简单，本模块的通讯协议分为命令发送和命令的应答两部分，其中命令格式由4个部分组成：命令识别码（0x55 0xAA），命令号，字节数（参数的个数，占2个字节，先发送低位字节，再发送高位字节），参数（根据命令的不同而不同），校验和（除命令识别码和校验和本身，所有发送数据之和的低 8 位数据）。命令格式如图：

应答分为两部分：命令的执行情况（编码将附录 1），数据。数据根据命令的不同而不同。

2、硬件连接

因为采用的是串口通讯，所以硬件的连接比较简单。麒麟座上的USART1（PA9：USART1_TX，PA10：USART1_RX）端口已经引到了J2端子排的J2_6和J2_5，所以我们就是用这一接口，至于5V电源和接地以及控制及状态信号悬着相应的引脚即可。

3、软件设计

接下来我们根据协议编写读写SD卡的软件，主要实现状态检测、创建文件、打开文件、写文件、关闭文件、保存文件以及获取文件信息等。

（1）获取系统的状态命令

获取系统的状态命令是用来获取模块当前的状态。命令编码是：0x01，命令格式如下：

//检测系统SD卡的状态

uint8_t GetSDCardStatus(void)

{

  uint8_t CommandText[]={0x55,0xAA,0x01,0x00,0x00,0x01};

  uint8_t StatusByte=0xaa;

  StatusByte = SendCommand(CommandText,);

  Delayms();

  return StatusByte;

}

（2）创建文件命令

创建文件命令提供给主机创建文件的功能。参数为 N 字节 8.3 文件格式的文件名（字符串格式，即文件名以 0 结尾），即 8 字节的基本文件名（模块不支持汉字编码，字母不区分大小写），3 字节扩展名。命令编码是：0x02，命令格式如下：

//创建文件,返回操作状态

uint8_t CreateFile(uint8_t fileName[])

{

  uint8_t CommandText[]={0x55,0xAA,0x02,0x0D,0x00,0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38,0x2E,0x74,0x78,0x74,0x00,0x41};

  uint8_t StatusByte;

  StatusByte=0xaa;

  uint16_t i;

  for(i=;i<;i++)

  {

    CommandText[i+]=fileName[i];

  }

  uint8_t checksum=0x00;

  for(i=;i<;i++)

  {

    checksum+=CommandText[i];

  }

  CommandText[]=checksum;

  StatusByte = SendCommand(CommandText,);

  return StatusByte;

}

(3)打开文件命令

该命令为主机提供打开文件的功能。参数为 N 字节 8.3 文件格式的文件名（字符串格式，即文件名以0 结尾），即 8 字节的基本文件名（模块不支持汉字编码，字母不区分大小写），3 字节扩展名。命令编码是：0x06命令格式如下，其中个数占 2 字节，低字节先发送：

//打开文件

uint8_t OpenFile(uint8_t fileName[])

{

  uint8_t CommandText[]={0x55,0xAA,0x06,0x0D,0x00,0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38,0x2E,0x74,0x78,0x74,0x00,0x45};//打开文件命令 0x06

  uint8_t StatusByte=0xaa;

  uint16_t i;

  for(i=;i<;i++)

  {

    CommandText[i+]=fileName[i];

  }

  uint8_t checksum=0x00;

  for(i=;i<;i++)

  {

    checksum+=CommandText[i];

  }

  CommandText[]=checksum;

  StatusByte = SendCommand(CommandText,);

  return StatusByte;

}

（4）获取文件信息命令

本命令为主机提供了读取当前打开文件的文件指针值和文件大小的功能。命令编码是：0x09，其命令格式如下：

//获取文件信息命令

void GetFileStatus(uint8_t rxData[])

{

  uint8_t CommandText[]={0x55,0xAA,0x09,0x00,0x00,0x09};//获取文件信息命令0x09

  uint16_t i;

  for(i=;i<;i++)

  {

    //等待传送结束

    while(USART_GetFlagStatus(UART4, USART_FLAG_TXE) == RESET)

    {

    }

    // 写一个字节到对应的串口传送数据寄存器

    USART_SendData(UART4, CommandText[i]);

  }

  Delayms();

  for(i=;i<;i++)

  {

    // 等待字节被对应的串口完全接收

    //while(USART_GetFlagStatus(UART4, USART_FLAG_RXNE) == RESET)

    //{

    //}

    // 获取接收到的字节

    rxData[i] = USART_ReceiveData(UART4);

  }

}

（5）写文件命令

该命令为主机提供向已打开文件中写入数据的功能。每写一个数据文件指针自动加1，当数据写完，文件指针指向最后一个数据地址加1的位置。命令编码是：0x05，命令格式如下，其中个数占2字节，低字节先发送，起始地址占4字节，低字节先发送：

//写文件,返回写操作的状态

uint8_t WriteToFile(uint8_t * address,uint8_t data[],uint16_t datalength)

{

  uint16_t count=datalength++;

  uint8_t CommandText[];

  uint8_t StatusByte=0xaa;

  uint16_t i;

  CommandText[]=0x55;

  CommandText[]=0xAA;

  CommandText[]=0x05;

  CommandText[]=datalength++;

  CommandText[]=0x00;

  CommandText[]=0xFF;

  CommandText[]=0xFF;

  CommandText[]=0xFF;

  CommandText[]=0xFF;

  for(i=;i<datalength;i++)

  {

    CommandText[i+]=data[i];

  }

  CommandText[datalength+]=(saveDate[]/)+0x30;

  CommandText[datalength+]=(saveDate[]%)+0x30;

  CommandText[datalength+]=0x2D;

  CommandText[datalength+]=(saveDate[]/)+0x30;

  CommandText[datalength+]=(saveDate[]%)+0x30;

  CommandText[datalength+]=0x2D;

  CommandText[datalength+]=(saveDate[]/)+0x30;

  CommandText[datalength+]=(saveDate[]%)+0x30;

  CommandText[datalength+]=0x20;

  CommandText[datalength+]=(saveDate[]/)+0x30;

  CommandText[datalength+]=(saveDate[]%)+0x30;

  CommandText[datalength+]=0x3A;

  CommandText[datalength+]=(saveDate[]/)+0x30;

  CommandText[datalength+]=(saveDate[]%)+0x30;

  CommandText[datalength+]=0x3A;

  CommandText[datalength+]=(saveDate[]/)+0x30;

  CommandText[datalength+]=(saveDate[]%)+0x30;

  CommandText[datalength+]=0x0D;

  CommandText[datalength+]=0x0A;

  uint8_t checksum=0x00;

  for(i=;i<count-;i++)

  {

    checksum+=CommandText[i];

  }

  CommandText[count-]=checksum;

  StatusByte = SendCommand(CommandText,count);

  return StatusByte;

}

（6）保存文件命令

该命令为主机提供保存当前打开文件的功能，为了防止频繁写 SD 卡，每次送入模块的数据先是保存在模块的 512 字节的扇区缓冲中，所以为了防止数据丢失，完成所有数据的传输后，要发送保存文件命令来保存文件。命令编码是：0x04，命令格式如下：

//保存文件,返回操作执行状态

uint8_t SaveFile(void)

{

  uint8_t CommandText[]={0x55,0xAA,0x04,0x00,0x00,0x04};//保存文件命令 0x04

  uint8_t StatusByte=0xaa;

  StatusByte = SendCommand(CommandText,);

  return StatusByte;

}

（7）关闭文件命令

该命令为主机提供关闭当前打开的文件的功能。在创建文件、创建文件夹、打开文件之前要求关闭当前打开的文件，才可以执行这些命令，否则返回失败。命令编码是：0x08，命令格式如下：

//关闭文件,返回操作执行状态

uint8_t CloseFile(void)

{

  uint8_t CommandText[]={0x55,0xAA,0x08,0x00,0x00,0x08};//关闭文件命令 0x08

  uint8_t StatusByte=0xaa;

  StatusByte = SendCommand(CommandText,);

  return StatusByte;

}

编写完程序，我们测试以我们想要的格式写一些数据下去文件被保存为文本文件，以时间为文件名，数据格式与预期一致。至此SD卡读写完成。