大宝娱乐

函数原型

void SM2_Init(void)

参数说明

返回值

SM2_OK：初始化乐成；
；；；其他值：初始化失败，，，，详见枚举类型界说

注重事项

1. 举行SM2运算时，，，，若还未初始化或已切换到其他算法，，，，必需先挪用此函数来

开启SM2？？？椤！。。。

函数原型

uint32_t SM2_GetKey(uint8_t priKey[32], uint8_t pubKey[65])

参数说明

priKey 输出，，，，私钥，，，，字节大端输出，，，，即高位在前低位在后

pubKey 输出，，，，公钥，，，，字节大端输出，，，，首字节是 0x04，，，，然后划分是 x|y 坐标

返回值

SM2_OK：运算准确；
；；；其他值：盘算过失，，，，详见枚举类型界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？；
；；；

2.私钥即一大数，，，，要求必需在[1，，，，n-2]中，，，，n 是 SM2 曲线参数。。。。。

函数原型

uint32_t SM2_GetPubKey(uint8_t priKey[32], uint8_t pubKey[65])

参数说明

priKey 输入，，，，私钥，，，，字节大端输入，，，，即高位在前低位在后

pubKey 输出，，，，公钥，，，，字节大端输出，，，，首字节是 0x04，，，，然后划分是 x|y 坐标

返回值

SM2_OK：运算准确；
；；；其他值：盘算过失，，，，详见枚举类型界说

注重事项

1.挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？

2. 私钥即一大数，，，，要求必需在[1，，，，n-2]中，，，，n 是 SM2 曲线参数

函数原型

uint32_t SM2_PointisOnCurve(uint8_t Point[64])

参数说明

Point输入，，，， 点坐标(x|y) ，，，，x 与 y 均为字节大端输入

返回值

SM2_PointIsOnCrv_YES ：点在曲线上；
；；；其他值： 过失，，，，详见枚举类型界说

注重事项

1.挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？

函数原型

uint32_t SM2_Sign(uint8_t E[32], uint8_t priKey[32], uint8_t r[32], uint8_t s[32])

参数说明

E       输入，，，，待署名新闻的 HASH 值

priKey 输入，，，，署名者的私钥

r       输出，，，，署名效果

s       输出，，，，署名效果

返回值

SM2_OK：运算准确；
；；；其他值：盘算过失，，，，详见枚举类型界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？；
；；；

2. E 或 prikey 存储介质可以为 RAM 或 FLASH；
；；；

3. 若 E 或 prikey 为 RAM 存储，，，，则署名效果 r 和 s 可以复用此空间，，，，但需包管空间足够；
；；；

4. prikey 要求必需在[1，，，，n-1]中。。。。。

函数原型

uint32_t SM2_Verify(uint8_t E[32], uint8_t pubKey[65], uint8_t r[32], uint8_t s[32])

参数说明

E      输入，，，，待署名新闻的 HASH 值

pubKey 输入，，，，署名者的公钥

r       输入，，，，署名效果

s      输入，，，，署名效果

返回值

SM2_OK：运算准确；
；；；其他值：盘算过失，，，，详见枚举类型界说

注重事项

1.挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？

2. E 或 pubKey 存储介质可以为 RAM 或 FLASH

函数原型

uint32_t SM2_ExchangeKey(uint8_t role, uint8_t *IDA, uint32_t IDAByteLen,

uint8_t *IDB, uint32_t IDBByteLen, uint8_t dA[32], uint8_t PA[65],uint8_t

PB[65], uint8_t rA[32], uint8_t RA[65], uint8_t RB[65], uint32_t kByteLen,

uint8_t *KA, uint8_t S1[32], uint8_t SA[32])

参数说明

role        输入，，，，角色，，，，1－提倡者，，，，0－接受者

IDA       输入，，，，提倡方 ID

IDAByteLen      输入，，，，IDB 的字节数

IDB        输入，，，，接受方 ID

IDBByteLen     输入，，，，IDB 的字节数

dA[32]       输入，，，，己方私钥

PA[65]      输入，，，，己方公钥

PB[65]        输入，，，，对方公钥

rA[32]        输入，，，，己方暂时私钥

RA[65]         输入，，，，己方暂时公钥

RB[65]      输入，，，，对方暂时公钥

kByteLen       输入，，，，协商密钥字节长度

KA [kByteLen] 输出，，，，协商密钥

S1 [32]         输出，，，，己方 S1 值

SA [32]       输出，，，，己方 SA 值

返回值

SM2_OK：运算准确；
；；；其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？

2. 若是盘算后的 S1=SB,S2=SA，，，，则密钥交流乐成，，，，协商后的密钥为 KA

3. dA、PB、rA、RA、RB、ZA、ZB 存储介质可以为 RAM 或 FLASH

4. 输出参数 KA、S1、SA 不可和输入参数 dA、PB、rA、RA、RB、ZA、ZB 使用统一 buffer。。。。。 

函数原型

uint32_t SM2_GetZ(uint8_t* ID, uint16_t IDByteLen, uint8_t pubKey[65], uint8_t Z[32])

参数说明

ID            输入，，，，用户 A 的 ID

IDByteLen     输入，，，，用户 A 的 ID 的字节数- 22 -

Pubkey        输入，，，，用户 A 的公钥，，，，65 字节

Z[32]             输出，，，，用户 A 的杂凑值，，，，32 字节

返回值

SM2_OK：盘算乐成，，，，其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1.切合 SM2 算法标准

2.挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？

3.运算竣事后，，，，本函数内部已再次挪用 SM2_Init()启动 SM2 ？？？椤！。。。

函数原型

uint32_t SM2_GetE(uint8_t* M, uint32_t MByteLen, uint8_t Z[32], uint8_t E[32])

参数说明

M            输入，，，，待署名验证新闻

MByteLen      输入，，，，待署名验证新闻的字节数

Z              输入，，，，署名者的 ID 杂凑值

E             输出，，，，输入值 M 与 Z 的杂凑值，，，，32 字节

返回值

SM2_OK：盘算乐成，，，， 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1.切合 SM2 算法标准；
；；；

2. 运算竣事后，，，，本函数内部已再次挪用 SM2_Init()启动 SM2 ？？？椤！。。。

函数原型

uint32_t SM2_EncryptInit(uint8_t pubKey[65], uint8_t C1[65])

参数说明

Pubkey      输入，，，，公钥

C1     输出，，，，密文的第一组成部分

返回值

SM2_OK：盘算乐成，，，， 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？；
；；；

2. pubkey 存储介质可以为 RAM 或 FLASH；
；；；

3. pubkey 和 C1 也不可是统一 buffer；
；；；

4.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。

函数原型

uint32_t SM2_EncryptUpdate(uint8_t* M, uint32_t MByteLen, uint8_t* C2)

参数说明

M                    输入，，，，待加密新闻

MByteLen       输入，，，，新闻的字节数

C2                   输出，，，，密文的第二组成部分，，，，长度与 MByteLen 相同

返回值

SM2_OK：运算准确，，，， 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？，，，，且需与 SM2_EncryptInit 配合使用；
；；；

2. M 存储介质可以为 RAM 或 FLASH；
；；；

3. M 和 C2 可以是统一 buffer；
；；；

4.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。 

函数原型

uint32_t SM2_EncryptDone(uint8_t C3[32] 

参数说明

C3 输出，，，，密文的第三组成部分

返回值

SM2_OK：加密准确；
；；； 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？，，，，且需与 SM2_EncryptInit、SM2_EncryptUpdate 配合使用；
；；；

2.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。

函数原型

uint32_t SM2_Encrypt(uint8_t *M, uint32_t MByteLen, uint8_t pubKey[65],

uint8_t *C, uint32_t *CByteLen)

参数说明

M                      输入，，，，明文

MByteLen         输入，，，，明文的字节长度，，，，0< MByteLen < (232 -97)

Pubkey               输入，，，，公钥

C                        输出，，，，密文

CByteLen          输出，，，，密文的字节长度，，，，应为(MByteLen +97)

返回值

SM2_OK：运算准确；
；；； 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？；
；；；

2. M 或 pubkey 存储介质可以为 RAM 或 FLASH；
；；；

3. M 和 C 不可是统一 buffer；
；；；pubkey 和 C 也不可是统一 buffer；
；；；

4.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。

函数原型

uint32_t SM2_DecryptInit(uint8_t priKey[32], uint8_t C1[65])

参数说明

priKey      输入，，，，私钥

C1             输入，，，，密文的第一组成部分

返回值

SM2_OK：运算准确；
；；； 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？；
；；；

2. priKey 存储介质可以为 RAM 或 FLASH；
；；；

3.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。

函数原型

uint32_t SM2_DecryptUpdate(uint8_t* C2, uint32_t C2ByteLen, uint8_t* M)

参数说明

C2              输入，，，，密文的第二组成部分

C2ByteLen    输入，，，，C2 的字节数

M                 输出，，，，新闻，，，，长度与 C2ByteLen 相同

返回值

SM2_OK：运算准确；
；；； 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动 SM2 ？？？，，，，且需与 SM2_DecryptInit 配合使用；
；；；

2. C2 存储介质可以为 RAM 或 FLASH；
；；；

3. M 和 C2 可以是统一 buffer；
；；；

4.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。

函数原型

uint32_t SM2_DecryptDone(uint8_t C3[32])

参数说明

C3 输入，，，，密文的第三组成部分

返回值

SM2_OK：解密准确；
；；； 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？，，，，且需与 SM2_DecryptInit、SM2_DecryptUpdate 配合使用；
；；；

2.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。  

函数原型

uint32_t SM2_DecryptDone(uint8_t C3[32])

参数说明

C3 输入，，，，密文的第三组成部分

返回值

SM2_OK：解密准确；
；；； 其他值：盘算过失，，，，详见枚举类型值界说

注重事项

1. 挪用本函数前，，，，若还未初始化或已切换到其他算法，，，，先挪用 SM2_Init()启动SM2 ？？？，，，，且需与 SM2_DecryptInit、SM2_DecryptUpdate 配合使用；
；；；

2.凭证新的国密规范，，，，密文顺序从 C1||C2||C3 修正为 C1||C3||C2。。。。。  

函数原型

参数说明

返回值

注重事项

1. SM2 运算完后，，，，可挪用本函数关闭 SM2 ？？？椤！。。。

函数原型

void SM2_Version(uint8_t *type, uint8_t *customer, uint8_t date[3], uint8_t*version)

参数说明

type                   商业或清静版本

customer           标准或定制版本

date                  年，，，，月，，，，日

version             //版本 x.x

返回值

注重事项

*type = 0x03;                    // 商业和清静版

*customer = 0x00;             // 标准版本

date[0] = 18;                    //Year()

date[1] = 12;                    //Month()

date[2] = 28;                   //Day ()

*version = 0x10;             //体现版本 1.0