LETOU乐投

函数原型

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