Azure Kinect DK + ROS1 Noetic使用教程-阿里云开发者社区

Azure Kinect DK + ROS1 Noetic使用教程

2024-08-21 919

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 本文是Azure Kinect DK在Ubuntu20.04下配合ROS1 Noetic使用的教程，内容包括一键安装脚本、硬件介绍、安装SDK相关软件包、设置Udev规则、SDK基本测试、DK ROS基本测试，以及存在的一些重要缺陷和相关参考文献。教程详细指导了如何配置和使用Azure Kinect DK，提供了安装步骤和解决常见问题的方法。

作者： Herman Ye @Galbot @Auromix
版本： V1.0
测试环境： Ubuntu20.04
更新日期： 2023/08/16
注1： 本文内容中的硬件由 @Galbot 提供支持。
注2： @Auromix 是一个机器人爱好者开源组织。
注3： 本文在更新日期经过测试，确认有效。

一键安装脚本

可参考一键安装脚本，执行以下步骤，在Ubuntu18/20上安装Azure Kinect DK：

wget -O $HOME/azure_kinect_dk_install.sh https://raw.githubusercontent.com/auromix/ros-install-one-click/main/azure_kinect_dk_install.sh && sudo chmod +x $HOME/azure_kinect_dk_install.sh && bash $HOME/azure_kinect_dk_install.sh

注意： Ubuntu22.04未经测试，也可以尝试一下。

Azure Kinect DK使用教程

Azure Kinect DK 是一款开发人员工具包，配有先进的 AI 传感器，提供复杂的计算机视觉和语音模型。 Kinect 将深度传感器、带有视频摄像头的空间麦克风阵列和方向传感器整合成一体式的小型设备，提供多种模式、选项和软件开发工具包 (SDK)。

在这里插入图片描述

DK的硬件

RGB相机
Azure Kinect DK 包含 OV12A10 12MP CMOS 滚动快门传感器。
深度相机
Azure Kinect DK 集成了 Microsoft 设计的 1 兆像素时差测距 (ToF) 深度相机。
IMU
嵌入式惯性测量单元 (IMU) 为 LSM6DSMUS，包含加速度传感器和陀螺仪。加速度传感器和陀螺仪同时按 1.6 kHz 采样。样本以 208 Hz 的频率报告给主机，可以通过SDK来读取。
七麦克风阵列
正六边形x6+中心x1 标准 USB 音频类 2.0 设备的优质七麦克风环形阵列

在这里插入图片描述

DK的供电与数据传输

方式1.电源与数据拆分输入线

DK->Type-C转Type-A -> PC
DK->DC5V转Type-A-> PC

方式2.电源和数据合并线

DK->Type-C转Type-C-> PC
在这里插入图片描述

一、安装SDK相关软件包

警告： 对于Ubuntu20.04用户，请直接参考安装软件包-> 5.安装k4a-tools->解决方法，不要执行以下步骤。

1.查看系统发行版和版本号

lsb_release -a

结果类似如下：

galbot@ubuntu:~$ lsb_release -a
No LSB modules are available.
Distributor ID:    Ubuntu
Description:    Ubuntu 20.04.6 LTS
Release:    20.04
Codename:    focal

2.配置Microsoft软件包源

下载Microsoft的软件包配置文件，然后将其写入到 /etc/apt/sources.list.d/microsoft-prod.list 文件中，以配置系统以从Microsoft的软件源获取软件更新或安装软件包。

curl -sSL https://packages.microsoft.com/config/<distribution>/<version>/prod.list | sudo tee /etc/apt/sources.list.d/microsoft-prod.list

替换<distribution>和<version>为Distributor ID: Ubuntu和Release: 20.04

示例如下：

curl -sSL https://packages.microsoft.com/config/ubuntu/20.04/prod.list | sudo tee /etc/apt/sources.list.d/microsoft-prod.list

3.配置Microsoft 存储库 GPG 公钥

下载公钥

下载 Microsoft 存储库的 GPG 公钥，然后将其写入到系统的信任 GPG 目录中，以便在之后的软件包验证过程中使用该公钥进行验证，确保下载的软件包的安全性和真实性。
/etc/apt/trusted.gpg.d/microsoft.asc: 是要写入数据的目标文件。它作为系统的信任 GPG 目录中的一个文件，存放了信任的 GPG 公钥。

curl -sSL https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc

注册、安装、删除认证相关软件包

注意： 需要先下载packages-microsoft-prod.deb ，可能是Microsoft安全认证相关包，官方未提及。

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb

安装Microsoft安全认证相关包

sudo dpkg -i packages-microsoft-prod.deb

安装后删除安装包文件以释放磁盘空间

rm packages-microsoft-prod.deb

4.更新包索引

sudo apt update

现在，Microsoft 相关产品包能够通过sudo apt install <microsoft_package_name>正确安装。

5.安装k4a-tools

k4a-tools 包中包含 Azure Kinect查看器、Azure Kinect 录制器和 Azure Kinect 固件工具

sudo apt install k4a-tools -y

报错

galbot@ubuntu:~$ sudo apt install k4a-tools
Reading package lists... Done
Building dependency tree       
Reading state information... Done
E: Unable to locate package k4a-tools

其他用户提出的相关Issue：Unable to install k4a-tools in Ubuntu 20.04
该问题于2020年8月24日提出，2023年8月8日仍未得到解决，原因是SDK包在2023年8月8日只支持Ubuntu18.04。

根据另一个用户提出的Issue中的解决办法，该用户于2020年10月17日提出该方法，但具体的方法已有部分过时失效不可用，通过参考该用户的思路，重新提出解决方法如下。

解决方法

对于Ubuntu20.04用户，解决方式及注释如下：

清除旧配置

如果不幸已经按照微软官方提供的Ubuntu20.04 SDK安装方法来配置了，需要先清理相关资源。

删除sources.list中有关Microsoft的内容

# Delete microsoft related line
sudo nano /etc/apt/sources.list

删除packages-microsoft-prod

# remove packages-microsoft-prod
sudo apt remove packages-microsoft-prod

删除sources.list.d中有关Microsoft的内容

# remove old 20.04 microsoft-prob.list
sudo rm /etc/apt/sources.list.d/microsoft-prod.list
sudo rm /etc/apt/sources.list.d/microsoft-prod.list.save

执行新配置

如果已经清除了旧配置或者在警告提示下直接跳到了这一步，按照以下内容进行安装：

通过模拟18.04的软件下载源来欺骗Ubuntu20.04使用18.04的文件，同时指定了较老的版本以避免最新的传感器依赖等问题影响基础使用，比如Azure Kinect ROS 驱动程序需要 v1.3.0 版本的 Azure Kinect Sensor SDK 才能编译。

# Download key and add to system key list
curl -sSL https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -

# Add Microsoft Ubuntu18.04 packages list to source
curl -sSL https://packages.microsoft.com/config/ubuntu/18.04/prod.list | sudo tee /etc/apt/sources.list.d/microsoft-prod.list

# Update software source
sudo apt update

# Upgrade software
sudo apt upgrade

# Install package of Microsoft
sudo apt install libk4a1.3-dev -y
sudo apt install libk4abt1.0-dev -y
sudo apt install k4a-tools=1.3.0 -y

注意： 另一种可行的方式是直接手动下载微软源的文件，进行deb手动安装。因为微软服务器23.99.120.248虽然在亚东，但使用魔法似乎速度还是很慢，暂时不清楚原因，如果下载时间过长时建议手动，同时选择老版本的软件。

注意： 可使用apt-mark使得对应的软件包不更新，避免更新时由于新版本不支持ubuntu20.04导致的问题。

sudo apt-mark hold <app_name>

需要下载的文件如下：
libk4a1.3-dev
libk4abt1.0-dev
k4a-tools

对于ARM架构设备
libk4abt1.1-dev
libk4a1.4-dev
k4a-tools
libk4a1.4-dev ARM

二、设置Udev规则

新建udev规则

sudo nano /etc/udev/rules.d/99-k4a.rules

写入udev规则内容

# Bus 002 Device 116: ID 045e:097a Microsoft Corp.  - Generic Superspeed USB Hub
# Bus 001 Device 015: ID 045e:097b Microsoft Corp.  - Generic USB Hub
# Bus 002 Device 118: ID 045e:097c Microsoft Corp.  - Azure Kinect Depth Camera
# Bus 002 Device 117: ID 045e:097d Microsoft Corp.  - Azure Kinect 4K Camera
# Bus 001 Device 016: ID 045e:097e Microsoft Corp.  - Azure Kinect Microphone Array

BUS!="usb", ACTION!="add", SUBSYSTEM!=="usb_device", GOTO="k4a_logic_rules_end"

ATTRS{
   
   idVendor}=="045e", ATTRS{
   
   idProduct}=="097a", MODE="0666", GROUP="plugdev"
ATTRS{
   
   idVendor}=="045e", ATTRS{
   
   idProduct}=="097b", MODE="0666", GROUP="plugdev"
ATTRS{
   
   idVendor}=="045e", ATTRS{
   
   idProduct}=="097c", MODE="0666", GROUP="plugdev"
ATTRS{
   
   idVendor}=="045e", ATTRS{
   
   idProduct}=="097d", MODE="0666", GROUP="plugdev"
ATTRS{
   
   idVendor}=="045e", ATTRS{
   
   idProduct}=="097e", MODE="0666", GROUP="plugdev"

LABEL="k4a_logic_rules_end"

重启udev服务

sudo service udev restart

设置用户组权限

sudo usermod -aG plugdev $USER

重启设备

拔出设备USB线，重新插入。

三、SDK基本测试

通过官方k4aviewer确认红外图、深度图、色彩图、麦克风阵列、IMU功能正常。

# Open a new terminal
k4aviewer

在这里插入图片描述

四、DK ROS基本测试

注意： 此处默认ROS1 Noetic已被正确安装并配置，如果还没有安装ROS1，请参考ROS1 Noetic一键安装脚本

下载、依赖安装、编译、配置

mkdir -p galbot_ws/src
cd galbot_ws/src
git clone https://github.com/microsoft/Azure_Kinect_ROS_Driver.git
cd ..
rosdep install --from-paths src --ignore-src -r -y
catkin_make
echo "source ~/galbot_ws/devel/setup.bash" >> ~/.bashrc
source ~/.bashrc

运行

# Terminal 1
roslaunch azure_kinect_ros_driver driver.launch

# Terminal 2
rviz

添加DK可发布的话题数据在RViz中进行可视化如下：
在这里插入图片描述

五、重要的缺陷

SDK默认不支持Ubuntu20.04、Ubuntu22.04
Azure Kinect ROS Driver不支持自身的麦克风阵列
Azure Kinect ROS Driver官方默认只支持ROS1 Melodic
不使用直插而使用USB拓展坞可能会造成ROS启动问题

六、参考文献

官方

DK official docs
DK official docs 中文
 Azure Kinect Sensor SDK Github
Sensor SDK官方下载
 Sensor SDK API文档
 Sensor SDK示例代码
 Sensor SDK示例代码2
更新DK固件
 SDK安装文档及对应版本固件下载
 Azure Kinect ROS Driver
麦克风使用参考
 语音服务案例
 DK 硬件规格书
 麦克风硬件规格书部分

第三方

image_proc
setup-azure-kinect-on-jetson-x-nx_18.04
Azure Kinect SDK 及 ROS 驱动安装
 Azure Kinect DK Python封装

Azure Kinect DK + ROS1 Noetic使用教程

一键安装脚本

Azure Kinect DK使用教程

DK的硬件

DK的供电与数据传输

方式1.电源与数据拆分输入线

方式2.电源和数据合并线

一、安装SDK相关软件包

1.查看系统发行版和版本号

2.配置Microsoft软件包源

3.配置Microsoft 存储库 GPG 公钥

下载公钥

注册、安装、删除认证相关软件包

4.更新包索引

5.安装k4a-tools

报错

解决方法

清除旧配置

执行新配置

二、设置Udev规则

三、SDK基本测试

四、DK ROS基本测试

五、重要的缺陷

六、参考文献

官方

第三方

热门文章

最新文章

相关课程

推荐镜像

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

Azure Kinect DK + ROS1 Noetic使用教程

一键安装脚本

Azure Kinect DK使用教程

DK的硬件

DK的供电与数据传输

方式1.电源与数据拆分输入线

方式2.电源和数据合并线

一、安装SDK相关软件包

1.查看系统发行版和版本号

2.配置Microsoft软件包源

3.配置Microsoft 存储库 GPG 公钥

下载公钥

注册、安装、删除认证相关软件包

4.更新包索引

5.安装k4a-tools

报错

解决方法

清除旧配置

执行新配置

二、设置Udev规则

三、SDK基本测试

四、DK ROS基本测试

五、重要的缺陷

六、参考文献

官方

第三方

热门文章

最新文章

相关课程

推荐镜像