EC接口

介绍EC编解码接口。

接口格式

int KsalEcEncode(uint8_t **data, uint8_t **parity, struct HecParam *param);

int KsalEcDecode(uint8_t **data, uint8_t **parity, struct HecParam *param);

参数释义

参数名	类型	描述	输入/输出
data	指针数组	数据块指针数组。	输入/输出
parity	指针数组	校验块指针数组。	输入/输出
param	编解码参数指针	编解码参数。	输入
ret	整型数	返回0表示成功，其他则表示失败。	输出

数据结构

成员名	类型	描述
dataNum	整型数	数据块个数。
parityNum	整型数	校验块个数。
sectorSize	整型数	扇区大小，最小编解码粒度，当前支持4096和4160。
blockSize	整型数	数据块或者校验块的大小，须为sectorSize的整数倍。
targetColNum	整型数	损失块的个数，解码接口使用。
targetColArray[6]	整型数	损失块列表，各个元素取值范围为[0, dataNum + parityNum)。
version	整型数	算法版本号，当前为0。

使用依赖

ksal/ksal_erasure_code.h

使用实例

编写EC测试代码。

新建“test.c”文件。
```
vi test.c
```

按“i”键进入编辑模式，添加如下测试代码。

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ksal/ksal_erasure_code.h>

int main(int argc, char **argv)
{
    struct HecParam param = {4, 2, 4096, 8192, 2, {3, 4}};
    uint8_t tmp[20][8192];
    uint8_t *ptrs[20];
    uint8_t *bptrs[20];
    for (size_t i = 0; i < param.dataNum + param.parityNum; ++i) {
        for (size_t j = 0; j < param.blockSize; j++) {
                tmp[i][j] = (uint8_t)rand() & 0xff;
        }
        ptrs[i] = tmp[i];
        bptrs[i] = tmp[i];
    }
    KsalEcEncode(ptrs, ptrs + param.dataNum, &param);
    bptrs[3] = tmp[18];
    bptrs[4] = tmp[19];
    KsalEcDecode(bptrs, bptrs + param.dataNum, &param);
    if (memcmp(bptrs[3], ptrs[3], param.blockSize) == 0 &&
        memcmp(bptrs[4], ptrs[4], param.blockSize) == 0) {
        printf("decode succ!!\r\n");
    } else {
        printf("decode fail!!\r\n");
    }
    return 0;
}

按“Esc”键退出编辑模式，输入:wq!并按“Enter”键保存退出文件。

编译“test.c”文件，生成test可执行文件。
```
gcc test.c -lksal -o test
```
运行test可执行文件。
```
./test
```
执行输出如下。
```
decode succ!!
```

父主题： KSAL开发参考