W801/W800/W806唯一ID/CPUID/FLASHID

本文使用环境：
主控：W800-KIT (开发板)
兼容：W800 W801 AIR101
开发环境：CDK
SDK：W801/W800的SDK(tls库)，HAL库没有实现uniqueid的适配

我的联盛德问答社区主页

一、项目概述

^^^^程序功能： 读取一个ID作为识别或者其他用途。

^^^^这篇教程主要是归纳总结，相对而言比较简单。本文主要从三个角度去获取ID：CPUID、FLASHID、uniqueid。
CPUID：32位 这ID不是我们传统意义上的ID，我问过官方，这是内核ID，只要是内核一样，ID就一样，不是唯一的。
flashID：8字节 不同的flash对应的ID不一样，但是目前不清楚是不是一批次都是一个ID。
uniqueID：18字节 这个不是一个独立的ID，是将flash等参数融合过后的ID，据说是唯一的ID。

二、工程设计

^^^^本小节将会依次读取三个不同的ID，大家可以根据自己的实际情况进行使用。
^^^^三个ID共用的结构体：

typedef struct ID_DATA
{
	uint32 CPUID;
    u8 flash_id[8];
    u8 unique_id[18];
}ID_DATA;

上述代码中ID_DATA结构体中包含了三个不同的ID，cpu、flash和unique。本文下列三个ID都采用结构体进行存储。

2.1、CPUID

^^^^这个ID可以从寄存器字节读取，相同内核的ID 应该 都是一样的。ID的读取程序是参考的联盛德问答社区中ZYQ大佬的解答：

其程序如下：

uint32 GetCpuIdr(void)
{
    uint32 id = 0;

    asm volatile(
        "mfcr    %[id],    cr<13, 0>\n\t"
        :[id]"+&r"(id)
        :
        :
        );
    return id;
}

^^^^同时ZYQ也给出了这个ID的一定用途，如下：

^^^^这是大佬对我说的话，大佬说的确实是有道理，也确实是我考虑不周。大家可以参考。

2.2、flashID

^^^^同样以下程序依然采用官方提供的代码，我只是对代码进行了总结，将宏定义全部放在了一起，如果是W800和W801的官方SDK，就是tls库的demo可直接粘贴复制下列代码，直接调用函数即可。如果是HAL库，宏定义可以删除。

//add by zxx start
//flashID
#define CMD_START_Pos                         8U                                          /*!< CMD start position */
#define CMD_START_Msk                         (1UL << CMD_START_Pos)                         /*!< CMD start Mask */
#define RSA_BASE       0x40000000
/**
 * @brief          This function is used to read the flash_id id of the internal flash.
 *
 * @param[out]      flash_id                 Specified the address to save the flash_id, the length must be greater than or equals to 8 bytes.
 *
 * @retval         TLS_FLS_STATUS_OK	    if read sucsess
 * @retval         TLS_FLS_STATUS_EIO	    if read fail
 *
 * @note           The flash_id's length must be greater than or equals to 8 bytes.
 */
int readFlashUniqueId(u8 *id,u8 fls_len)
{
    if (!id || fls_len <= 8) {
		printf("id equal NULL or fls_led not equal 8\r\n");
        return -1;
    }
    M32(HR_FLASH_CMD_ADDR) = 0xBC04B;
    M32(HR_FLASH_CMD_START) = CMD_START_Msk;
    u32 *id32 = id;
    for (u8 i = 0; i < 2; i++) {
        id32[i] = M32(RSA_BASE + (i + 1) * 4);
    }
    return 0;
}
//add by zxx end

2.3、uniqueID

^^^^读取唯一的ID官方库文件有提供代码，本小节主要涉及函数调用，仅此而已。函数在 wm_internal_fls.c 文件中：

/**
 * @brief          This function is used to read the unique id of the internal flash.
 *
 * @param[out]      uuid                 Specified the address to save the uuid, the length must be greater than or equals to 18 bytes.
 *
 * @retval         TLS_FLS_STATUS_OK	    if read sucsess
 * @retval         TLS_FLS_STATUS_EIO	    if read fail
 *
 * @note           The uuid's length must be greater than or equals to 18 bytes.
 */
int tls_fls_read_unique_id(unsigned  char *uuid)
{
	unsigned int value = 0;
	unsigned int addr_read = 0;
	int i = 0;
	int len;
	unsigned char FLASH_BUF[20];
	unsigned char *addr = &FLASH_BUF[0];
	int dumy_bytes = 0;
	int uni_bytes = 0;
	unsigned char rid;
	int word;
	int byte;
    if (inside_fls == NULL)
    {
    	return TLS_FLS_STATUS_EPERM;
    }

	tls_os_sem_acquire(inside_fls->fls_lock, 0);
	memset(uuid, 0xFF, 18);
	rid = readRID();
	switch(rid)
	{
		case SPIFLASH_MID_GD:
		case SPIFLASH_MID_PUYA:
		case SPIFLASH_MID_TSINGTENG:
			dumy_bytes = 4;
			uni_bytes = 16;
			break;
		case SPIFLASH_MID_WINBOND:
		case SPIFLASH_MID_FUDANMICRO:
		case SPIFLASH_MID_BOYA:
		case SPIFLASH_MID_XMC:
			dumy_bytes = 4;
			uni_bytes = 8;
			break;
		case SPIFLASH_MID_ESMT:
		case SPIFLASH_MID_XTX:
		default:
			tls_os_sem_release(inside_fls->fls_lock);
			return -1;
	}
	uuid[0] = rid;
	uuid[1] = (unsigned char)(uni_bytes & 0xFF);
	len = dumy_bytes + uni_bytes;
	word = len/4;
	byte = len%4;
	
	value = 0xC04B|((len-1) << 16);
	M32(HR_FLASH_CMD_ADDR) = value;
	M32(HR_FLASH_CMD_START) = CMD_START_Msk;		

	addr_read = RSA_BASE_ADDRESS;
	for(i = 0;i < word; i ++)
	{
		M32(addr) = M32(addr_read);	
		addr += 4;
		addr_read += 4;
	}

	if(byte > 0)
	{
		M32(addr) = M32(addr_read);	
		addr += 3;							//point last byte
		while(byte)
		{
			*addr = 0;
			addr --;
			byte --;
		}
	}
	addr = &FLASH_BUF[0];
	memcpy(&uuid[2], addr + dumy_bytes, uni_bytes);
	tls_os_sem_release(inside_fls->fls_lock);

	return 0;
}

上述函数将很多的ID进行了组合。
小疑惑： 这个函数我觉得还不是很理想，因为函数内部并未判断传入的参数是否合法，如果我传个很小的数组？传个非法地址？这样数据读出来可能是错的。当然这是题外话，大家使用的时候一定要注意。参数的合法性。

三、测试

3.1、测试代码

^^^^编写测试程序测试是否正确读取ID。读取比较简单只提供代码，自己封装函数即可。

	while(1)
	{
		ID_DATA id_data;
		readFlashUniqueId(id_data.flash_id,sizeof(id_data.flash_id));
		printf("flashid:  ");
		for(int i=0;i<8;i++)
			printf("%d ",id_data.flash_id[i]);
		printf("\r\n");
		tls_fls_read_unique_id(id_data.dev_id);
		printf("uniqueid:  ");
		for(int i=0;i<18;i++)
			printf("%d ",id_data.dev_id[i]);
		printf("\r\n");
		id_data.cpuid = GetCpuIdr();
		printf("cpuid:  %d\r\n",id_data.cpuid);
		while(1);
	}

3.2、W800测试结果

3.3、W801测试结果

第一块W801：

第二块W801：

3.4、AIR101测试结果