您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Azure Kinect DK 固件工具Azure Kinect DK firmware tool

Azure Kinect 固件工具可用于查询和更新 Azure Kinect DK 的设备固件。The Azure Kinect Firmware Tool can be used to query and update the device firmware of the Azure Kinect DK.

列出已连接的设备List connected devices

可以使用 -l 选项获取已连接的设备列表。You can get a list of connected devices by using the -l option. AzureKinectFirmwareTool.exe -l

 == Azure Kinect DK Firmware Tool ==
Found 2 connected devices:
0: Device "000036590812"
1: Device "000274185112"

检查设备固件版本Check device firmware version

可以使用 -q 选项检查第一个附加设备的当前固件版本,例如 AzureKinectFirmwareTool.exe -qYou can check the current firmware versions of the first attached device by using -q option, for example, AzureKinectFirmwareTool.exe -q.

 == Azure Kinect DK Firmware Tool ==
Device Serial Number: 000036590812
Current Firmware Versions:
    RGB camera firmware:      1.5.92
    Depth camera firmware:    1.5.66
    Depth config file:        6109.7
    Audio firmware:           1.5.14
    Build Config:             Production
    Certificate Type:         Microsoft

如果附加了多个设备,可以通过将完整的序列号添加到命令,来指定要查询的设备,例如:If there's more than one device attached, you can specify which device you want to query by adding the full serial number to the command, such as:

AzureKinectFirmwareTool.exe -q 000036590812

更新设备固件Update device firmware

此工具的最常见用途是更新设备固件。The most common use of this tool is to update device firmware. 使用 -u 选项调用该工具可以执行更新。Do the update by calling the tool using the -u option. 固件更新可能需要几分钟时间,具体取决于必须更新哪些固件文件。A firmware update can take few minutes, depending on which firmware files must be updated.

有关固件更新的分步说明,请参阅 Azure Kinect 固件更新For step-by-step firmware update instruction, see Azure Kinect firmware update.

AzureKinectFirmwareTool.exe -u firmware\AzureKinectDK_Fw_1.5.926614.bin

如果附加了多个设备,可以通过将完整的序列号添加到命令,来指定要查询的设备。If there's more than one device attached, you can specify which device you want to query by adding the full serial number to the command.

AzureKinectFirmwareTool.exe -u firmware\AzureKinectDK_Fw_1.5.926614.bin 000036590812

重置设备Reset device

如果必须将设备置于某种已知状态,可以使用 -r 选项重置附加的 Azure Kinect DK。An attached Azure Kinect DK can be reset using -r option, if you must get the device into a known state.

如果附加了多个设备,可以通过将完整的序列号添加到命令,来指定要查询的设备。If there's more than one device attached, you can specify which device you want to query by adding the full serial number to the command.

AzureKinectFirmwareTool.exe -r 000036590812

检查固件Inspect firmware

在更新实际设备之前,可以通过检查固件从固件 bin 文件中获取版本信息。Inspecting firmware allows you to get the version information from a firmware bin file before updating an actual device.

AzureKinectFirmwareTool.exe -i firmware\AzureKinectDK_Fw_1.5.926614.bin

 == Azure Kinect DK Firmware Tool ==
Loading firmware package ..\tools\updater\firmware\AzureKinectDK_Fw_1.5.926614.bin.
File size: 1228844 bytes
This package contains:
  RGB camera firmware:      1.5.92
  Depth camera firmware:    1.5.66
  Depth config files: 6109.7 5006.27
  Audio firmware:           1.5.14
  Build Config:             Production
  Certificate Type:         Microsoft
  Signature Type:           Microsoft

固件更新工具选项Firmware update tool options

 == Azure Kinect DK Firmware Tool ==
* Usage Info *
    AzureKinectFirmwareTool.exe <Command> <Arguments>

Commands:
    List Devices: -List, -l
    Query Device: -Query, -q
        Arguments: [Serial Number]
    Update Device: -Update, -u
        Arguments: <Firmware Package Path and FileName> [Serial Number]
    Reset Device: -Reset, -r
        Arguments: [Serial Number]
    Inspect Firmware: -Inspect, -i
        Arguments: <Firmware Package Path and FileName>

    If no Serial Number is provided, the tool will just connect to the first device.

Examples:
    AzureKinectFirmwareTool.exe -List
    AzureKinectFirmwareTool.exe -Update c:\data\firmware.bin 0123456

后续步骤Next steps