如何在 UEFI 应用程序中获取 USB Token飞天汽车 ePass 2003 FIPS USB Token序列号？

如何解决如何在 UEFI 应用程序中获取 USB Token飞天汽车 ePass 2003 FIPS USB Token序列号？

开发基于 UEFI 的应用程序以启用预启动身份验证使用 飞天汽车 ePass 2003 FIPS USB 令牌。我仍处于开发过程的初始阶段。

现在我可以使用 UsbIo->UsbGetDeviceDescriptor 协议获取令牌的制造商、产品代码。但是当我尝试查找序列号时，它抛出了一个错误。

有没有其他方法可以找到USB Token的序列号？请帮我解决这个问题..

这是我查找序列号的示例代码

EFI_USB_DEVICE_DESCRIPTOR DevDesc;
EFI_USB_INTERFACE_DESCRIPTOR InterfaceDescriptor;
EFI_USB_ENDPOINT_DESCRIPTOR EndpointDescriptor;
EFI_USB_CONfig_DESCRIPTOR     ConfigDescriptor;
EFI_USB_IO_PROTOCOL *UsbIo;

EFI_STATUS Status;
EFI_HANDLE *HandleBuffer = NULL;

BOOLEAN    LangFound;
UINTN      HandleCount;
UINT8      EndpointNumber;

CHAR16* ManufacturerString = NULL;
CHAR16* ProductString = NULL;
CHAR16* SerialNumber = NULL;
UINT16* LangIDTable;
UINT16 TableSize;
INTN Index;

int index;


unsigned char* device_descriptor,* ccid_descriptor;

EFI_USB_DEVICE_REQUEST  DevReq;
UINT32 Status_uint;
 
Status = gBS->LocateHandleBuffer( ByProtocol,&gEfiUsbIoProtocolGuid,NULL,&HandleCount,&HandleBuffer );
if (EFI_ERROR(Status)) {
    Print(L"ERROR: LocateHandleBuffer.\n");
    goto ErrorExit;
}

UINT8 usbIndex;

for (usbIndex = 0; usbIndex < HandleCount; usbIndex++) {
    Status = gBS->HandleProtocol( HandleBuffer[usbIndex],(VOID**)&UsbIo );
    if (EFI_ERROR(Status)) {
        Print(L"ERROR: Open UsbIo.\n");
        goto ErrorExit;
    }
 
    Status = UsbIo->UsbGetDeviceDescriptor( UsbIo,&DevDesc );
    if (EFI_ERROR(Status)) {
        Print(L"ERROR: UsbGetDeviceDescriptor.\n");
        goto ErrorExit;
    }


    Status = UsbIo->UsbGetConfigDescriptor( UsbIo,&ConfigDescriptor );
    if (EFI_ERROR (Status))
    {
        Print(L"UsbGetConfigDescriptor %d",Status);
        goto ErrorExit;
    }

        
    Status = UsbIo->UsbGetInterfaceDescriptor( UsbIo,&InterfaceDescriptor );
    if (EFI_ERROR (Status)) {
        Print(L"ERROR: UsbGetInterfaceDescriptor.\n");
        goto ErrorExit;
    }

    if (InterfaceDescriptor.InterfaceClass != CLASS_CCID) {
        continue;            
    }

    Print(L":::::::::::::::::::::: CCID ::::::::::::::::::::::\n");

    //
    // Get all supported languages.
    //
    TableSize = 0;
    LangIDTable = NULL;
    Status = UsbIo->UsbGetSupportedLanguages(UsbIo,&LangIDTable,&TableSize);
    if (EFI_ERROR(Status)) {
        Print(L"ERROR: UsbGetSupportedLanguages.\n");
        return Status;
    }

    /* Get Manufacturer string */
    for (Index = 0; Index < TableSize / sizeof(LangIDTable[0]); Index++) {
        ManufacturerString = NULL;
        Status = UsbIo->UsbGetStringDescriptor(UsbIo,LangIDTable[Index],DevDesc.StrManufacturer,&ManufacturerString);

        if (EFI_ERROR(Status) || (ManufacturerString == NULL)) {
            continue;
        }
        Print(L"StrManufacturer ::%s\n",ManufacturerString);
        FreePool(ManufacturerString);
        break;
    }

    /* Get Product string */
    for (Index = 0; Index < TableSize / sizeof(LangIDTable[0]); Index++) {
        ProductString = NULL;
        Status = UsbIo->UsbGetStringDescriptor(UsbIo,DevDesc.StrProduct,&ProductString);

        if (EFI_ERROR(Status) || (ProductString == NULL)) {
            continue;
        }
        Print(L"StrProduct ::%s\n",ProductString);
        FreePool(ProductString);
        break;
    }

    /* Get Serial string */
    for (Index = 0; Index < TableSize / sizeof(LangIDTable[0]); Index++) {
        SerialNumber = NULL;
        Status = UsbIo->UsbGetStringDescriptor(UsbIo,DevDesc.StrSerialNumber,&SerialNumber);

        if (EFI_ERROR(Status) || (SerialNumber == NULL)) {
            Print(L"Error in finding SerialNumber \n");
            continue;
        }

        Print(L"SerialNumber :: %s\n",SerialNumber);

        FreePool(SerialNumber);
        break;
    }

    Print(L"usbIndex ::%d\n",usbIndex);
    Print(L"Idvendor ::%d\n",DevDesc.Idvendor);
    Print(L"IdProduct ::%d\n",DevDesc.IdProduct);    
}

Print(L"\n");
FreePool(HandleBuffer);
return Status;

解决方法

据我所知，飞天科技 ePass2003 使用英飞凌 M7893 或 SLE 78CUFX5000PH (M7893-B) 安全芯片。

如您所见，ePass2003 的序列号并未存储在 USB 设备描述符中，而是存储在安全芯片中。

为了获取芯片全局数据，例如 OEM 信息、算法支持、FIPS 模式指示器、RAM 大小和序列号，使用了 GetData 原语。请参阅 M7893 编程指南。如果您可以访问它。

OpenSC 中 ePass2003 的驱动程序称为“epass2003”。源代码目前可在 https://github.com/OpenSC/OpenSC/blob/master/src/libopensc/card-epass2003.c 获得。它依赖于 OpenSSL 和 ASN.1 以及一些非 EDK2 标头，但这些很容易解决。

如果您只需要序列号，那么通过研究 OpenSC ePass2003 驱动程序的工作原理，编写 UEFI 应用程序（或驱动程序）来获取该信息应该相当容易（提示 - 查看 {{1 }} 或者学习ePass2003 SDK，它可以从飞坦和其他地方免费获得。

2015 年 4 月发布的 UEFI 2.5 规范详细介绍了与智能卡相关的 2 个协议，即智能卡读卡器和智能卡边缘。

epass2003_get_serialnr

EDK2 目前不包含示例实现。但是，您可能对 Ludovic Rousseau 提供的 GPL2 许可示例实现感兴趣，该实现可在 typedef struct _EFI_SMART_CARD_READER_PROTOCOL { EFI_SMART_CARD_READER_CONNECT SCardConnect; EFI_SMART_CARD_READER_DISCONNECT SCardDisconnect; EFI_SMART_CARD_READER_STATUS SCardStatus; EFI_SMART_CARD_READER_TRANSMIT SCardTransmit; EFI_SMART_CARD_READER_CONTROL SCardControl; EFI_SMART_CARD_READER_GET_ATTRIB SCardGetAttrib; } EFI_SMART_CARD_READER_PROTOCOL; typedef struct _EFI_SMART_CARD_EDGE_PROTOCOL { EFI_SMART_CARD_EDGE_GET_CONTEXT GetContext; EFI_SMART_CARD_EDGE_CONNECT Connect; EFI_SMART_CARD_EDGE_DISCONNECT Disconnect; EFI_SMART_CARD_EDGE_GET_CSN GetCsn; EFI_SMART_CARD_EDGE_GET_READER_NAME GetReaderName; EFI_SMART_CARD_EDGE_VERIFY_PIN VerifyPin; EFI_SMART_CARD_EDGE_GET_PIN_REMAINING GetPinRemaining; EFI_SMART_CARD_EDGE_GET_DATA GetData; EFI_SMART_CARD_EDGE_GET_CREDENTIAL GetCredential; EFI_SMART_CARD_EDGE_SIGN_DATA SignData; EFI_SMART_CARD_EDGE_DECRYPT_DATA DecryptData; EFI_SMART_CARD_EDGE_BUILD_DH_AGREEMENT BuildDHAgreement; } EFI_SMART_CARD_EDGE_PROTOCOL; 获得。大约有 5 年历史且我尚未测试过的实现代码位于 https://github.com/LudovicRousseau/edk2/tree/SmartCard。也请阅读他的博客 (https://ludovicrousseau.blogspot.com/)，因为他还提供了有用的示例应用程序。