密码卡安装手册
介绍派科信安PCIE密码卡硬件安装、软件编译与安装的方法，并进行初步使用。
适用范围
此手册适用于派科信安的如下PCIE密码卡：
- A系列：A1、A2、A3
- B系列：B1、B2、B3、B4、B5
- C系列：C1
适用于派科信安的如下Mini PCIE密码卡：
- M10、M10U
- M11、M11U
- M50
硬件安装
PCIE密码卡安装
所需安装的PCIE密码卡，与下图类似：
硬件按照以下步骤安装：
（1）关闭系统电源，并拔掉电源线；
（2）将PCIE密码卡插入PCIE插槽内，并固定挡板；
（3）检查确认PCIE密码卡安装固定好之后，插入系统电源线，启动系统。
Mini PCIE密码卡安装
所需安装的Mini PCIE密码卡，与下图类似：
Mini PCIE密码卡硬件按照以下步骤安装：
（1）关闭系统电源，并拔掉电源线；
（2）将密码卡插入Mini PCIE插槽内，并固定挡板；
（3）检查确认密码卡安装固定好之后，插入系统电源线，启动系统。
Mini PCIE密码卡安装注意事项：
（1）Mini PCIE插槽与mSATA插槽，从外观上比较相似，要注意区分。如不清楚，需要咨询主板或者主机供应商联系。
（2）标准Mini PCIE接口，可以支持一路PCIE总线和一路USB2.0总线，部分主板只支持其中的一种。派科信安的Mini PCIE密码卡系列中，以U结尾的型号，均只支持USB2.0总线，其余Mini PCIE密码卡均只支持PCIE总线。要注意主板上Mini PCIE接口的总线协议，与密码卡支持的总线协议的对应关系。如不清楚主板支持的总线协议类型，需要咨询主板或者主机供应商联系。
安装后的检查
安装后，可用lspci命令或者lsusb命令，查看硬件设备是否被正常识别。
A系列密码卡：使用lspci命令，可以看到Network and computing encryption device: Device 9118:1802。
B系列密码卡：使用lspci命令，可以看到Encryption controller: Device 1dab:7001 (rev 01)。
C系列密码卡：使用lsusb命令，可以看到厂商ID为9118设备ID为2104或2208的USB设备。
M系列密码卡：使用lsusb命令，可以看到厂商ID为9118设备ID为2104或2208的USB设备。
软件编译与安装
软件包目录结构：
名称类似piico_ccx_driver_xxx.tgz，并在Linux下解压缩文件包。解压后的目录和文件结构如下：
| 目录或文件名 | 说明 |
|---|---|
| ./driver/*.ko | 内核态.ko模块 |
| ./lib/* | 用户态.so动态库与.a静态库 |
| ./include/ | 用户态头文件，用于用户态程序开发 |
| ./tools/ | 密码卡管理工具 |
| ./examples/ | 密码卡调用的多个样例程序，用户可参考该源码进行开发 |
| Makefile | 可执行make、make install和make uninstall等操作 |
A系列密码卡
（1）查看操作系统信息：确认操作系统基本信息，包括CPU架构、操作系统版本号、内核版本号。
以Linux类操作系统为例，可分别通过cat /proc/cpuinfo | grep "name"、cat /etc/os-release、cat /proc/version进行查看。
（2）将获取到的操作系统信息，反馈给派科信安技术支持，获取密码卡驱动程序软件包。其中，driver目录下的内核.ko模块、lib目录下的用户态.so动态库，均以二进制方式提供，其他文件以源码方式提供。
（3）编译：在软件包根目录下，执行make进行用户态程序编译，包括tools目录下的密码卡管理工具，和examples样例程序。
（4）执行make install，安装内核ko模块、用户态.so动态库与.a静态库。
（5）运行tools目录下的密码卡管理工具，和examples目录下的样例程序。注意：密码卡的调用，要使用root权限。
建议：我们提供免费远程技术支持。如果您是第一次使用，建议准备好向日葵或者ToDesk远程软件，联系我们的技术支持，给您进行远程的安装与演示。
B系列密码卡
详见B系列密码卡的安装手册。
C系列密码卡
（1）获取基础软件包：通过软件包下载链接（联系派科信安技术支持），根据密码卡型号，下载对应的软件包。
lib目录下的用户态.so动态库，以二进制方式提供；其他文件，包括driver目录下的内核.ko模块，均以源码方式提供。
（2）根据操作系统信息，确认是否需要替换so动态库。
基础软件包中lib目录下的so动态库文件，默认为x86_64架构的动态库。如果使用密码卡的设备不是该架构，则需要将so动态替换为对应架构的动态库文件。
用户根据操作系统信息，在软件包下载链接中找到对应的so动态库，将其拷贝至lib目录下。如不确定选用哪一个so动态库，也可将获取到的操作系统信息，反馈给派科信安技术支持，获取技术支持。
（4）编译：在软件包根目录下，执行make进行用户态程序编译，包括内核态.ko模块，tools目录下的密码卡管理工具，和examples样例程序。
（5）执行make install，安装内核ko模块、用户态.so动态库与.a静态库。
（6）运行tools目录下的密码卡管理工具，和examples目录下的样例程序。注意：密码卡的调用，要使用root权限。
建议：我们提供免费远程技术支持。如果您是第一次使用，建议准备好向日葵或者ToDesk远程软件，联系我们的技术支持，给您进行远程的安装与演示。
M系列密码卡
M系列密码卡的软件编译与安装，同C系列密码卡。
软件程序的交叉编译
如果运行密码卡驱动的系统无法安装编译环境，则可能需要采取交叉编译的方式进行进行软件编译。
建议：如果是第一次进行密码卡的使用和测试，不建议第一次使用就在交叉编译环境下，建议现在带编译环境的操作系统下进行。在通用操作系统下测试完毕之后，可以移植至交叉编译环境下。
交叉编译，需要有对应的交叉编译工具链。
编译用户态应用程序和动态库，只需要交叉编译工具链即可。
编译内核模块，则需要对应的内核编译生成的相关文件。该文件的打包，一般内核交叉编译环境下，使用make ARCH=xxx CROSS_COMPILE=xxx-linux- rpm-pkg或者make ARCH=xxx CROSS_COMPILE=xxx-linux- deb-pkg之类的命令。可用make help查看详细信息。
参考：
make ARCH=arm64 CROSS_COMPILE=aarch64-linux- rpm-pkgmake
远程技术指导
如果您对以上安装流程感到困惑，可联系派科信安技术支持，获取远程安装技术指导。
远程桌面，建议采用“向日葵”软件。
初步使用
软件编译安装成功后，可以运行example目录下的以std_开头的样例程序。该程序会调用密码卡内的部分算法。
examples范例说明
在驱动目录下的examples文件夹中，有较多的使用范例。大致功能如下：
| 范例文件名 | 范例说明 |
|---|---|
| piicoTool | 基于UKEY的卡管理工具 |
| piicoToolWP | 基于PIN码的卡管理工具 |
| std_sm1 | SM1算法标准数据加解密 |
| std_sm2 | SM2算法签名/验签、加密/解密 |
| std_sm3 | SM3算法调用范例 |
| std_sm4 | SM4算法标准数据加解密 |
固件升级
（1） 联系生成厂商，获取upper升级包；
（2） 固件如gm_release_x.x.srec在upper目录下；
（3） 执行./upper gm_release_x.x.srec
（4） 关机断电，重起机器