用M4芯片的HASH模块计算SHA1和HMAC_SHA1

STM32F439芯片，以下用M4称呼。M4的HASH模块，可以计算SHA1、SHA224、SHA256、MD5这些校验值，也可以计算基于它们的HMAC加密校验值，都是硬件计算。在此以SHA1及其HMAC_SHA1为例，讨论其用法。

介绍一下HMAC的概念：
HMAC(message) = Hash[((key | pad) XOR 0x5C) | Hash(((key | pad) XOR 0x36) | message)]

其中，(key | pad)表示在key的后面缀上若干数量的零，使得其总长度为64bytes，即512bits。假如key本身就已经达到512bits，就不必后缀零了。假如key超过了512bits，那么计算这个key的HASH值来代替原本的key。XOR 0x5C表示这64个byte全部要异或0x5C。XOR 0x36同理，剩下的 | 符号只是简单的连接前面的bit串和后面的bit串。

首先要说明的是，这些校验算法，对原始数据的尺寸，都是以bit为单位的。只不过，平时在电脑上常用的CRC32啦、MD5啦、SHA1啦，因为都是用来校验文件的，而文件的尺寸是以byte为单位的，所以常见的HASH函数都是以byte为单位，就连M4的固件库也不例外。固件库里面的函数如下：

ErrorStatus HASH_SHA1(uint8_t *Input, uint32_t Ilen, uint8_t Output[20])
{
  ……
  
  /* Number of valid bits in last word of the Input data */
  nbvalidbitsdata = 8 * (Ilen % 4);

  /* HASH peripheral initialization */
  HASH_DeInit();

  ……

  /* Configure the number of valid bits in last word of the data */
  HASH_SetLastWordValidBitsNbr(nbvalidbitsdata);

  /* Write the Input block in the IN FIFO */
  for(i=0; i<Ilen; i+=4)
  {
    HASH_DataIn(*(uint32_t*)inputaddr);
    inputaddr+=4;
  }

  /* Start the HASH processor */
  HASH_StartDigest();

  ……

  if (busystatus != RESET)
  {
     status = ERROR;
  }
  else
  {
    /* Read the message digest */
    HASH_GetDigest(&SHA1_MessageDigest);
    *(uint32_t*)(outputaddr)  = __REV(SHA1_MessageDigest.Data[0]);
    outputaddr+=4;
    *(uint32_t*)(outputaddr)  = __REV(SHA1_MessageDigest.Data[1]);
    
    ……
  }
  return status;
}

首先初始化该模块，然后第一个配置的就是NBW寄存器（HASH_SetLastWordValidBitsNbr函数）。后面的循环，用来将原始数据以32bits为单位，一点点压到寄存器中（HASH_DataIn函数）。由于数据并不一定正好按照32bits拆分完，所以循环的最后一次，究竟有多少bits是有效的，就要用NBW寄存器来指明了。最后给DCAL寄存器置位 （ HASH_StartDigest函数） ，表示原始数据已经传完，可以收尾了。延时等待硬件计算完成，就可以把结果拿出来（HASH_GetDigest函数），放到我们给的缓冲区中。

函数已经包装的很好了，只可惜直接拿来用还是用不了，明明固件库就是为了方便众人使用的，可是这个不能直接用，让人很无语啊……

好吧，其实只要在调用这个函数之前，使能某个总线的时钟即可：

RCC_AHB2PeriphClockCmd (RCC_AHB2Periph_HASH, ENABLE);

算完之后，用同样的函数把时钟禁用࿰