最后更新
管道自动校准
自 ROS 驱动程序版本
3.2.1 起,管道 自动校准 默认启用。要禁用它,请将 driver.i_pipeline_auto_calibration_mode 设置为 OFF。r_ 开头的参数可以在运行时自由修改,例如使用 rqt。以 i_ 开头的参数在相机初始化时设置,要更改它们,您必须调用 stop 和 start 服务。这可用于在运行时热插拔神经网络、更改分辨率等。驱动程序
driver.i_publish_tf_from_calibration: true<bool> - 将此设置为 true 将启动 TFPublisherdriver.i_tf_device_name: [NODE_NAME]<string> - 如果未设置,则默认为节点名称driver.i_tf_device_model: ''<string> - 如果未设置,将自动检测。如果节点无法检测到设备的 STL 文件,则将其设置为OAK-D-S2。要在driver.launch.py中明确设置,请设置override_cam_model:=truedriver.i_tf_base_frame: oak<string> - 用作相机帧根的帧,通常与 CAM_A(OAK-D 系列的中心传感器)位于同一位置driver.i_tf_parent_frame: oak_parent_frame<string> - 设置为您要连接相机的帧(例如机器人末端执行器)driver.i_tf_cam_pos_x: '0.0'<string> - 基本帧相对于父帧的位置driver.i_tf_cam_pos_y: '0.0'<string> - 基本帧相对于父帧的位置driver.i_tf_cam_pos_z: '0.0'<string> - 基本帧相对于父帧的位置driver.i_tf_cam_roll: '0.0'<string> - 基本帧相对于父帧的方向driver.i_tf_cam_pitch: '0.0'<string> - 基本帧相对于父帧的方向driver.i_tf_cam_yaw: '0.0'<string> - 基本帧相对于父帧的方向 除了与 TF 发布相关的参数外,driver还有其他参数
i_usb_speed: SUPER<string> - 用于使用当前接口的 USB 速度,它会自动推断,但可以覆盖,例如明确使用 SUPER_PLUS 可用选项:- LOW
- FULL
- HIGH (USB2)
- SUPER (USB3)
- SUPER_PLUS - 用于连接高速接口(如 Thunderbolt),在某些情况下可能不稳定
i_device_id: ""<string> - 用于连接具有特定 ID 的设备i_ip ""<string> - 用于连接具有特定 IP 的设备i_usb_port_id: ""<string> - 用于连接特定 USB 端口上的设备i_pipeline_dump: false<bool> - 是否将创建的管道转储到 JSON 文件(用于调试)i_calibration_dump: false<bool> - 是否将校准转储到 JSON 文件i_external_calibration_path: ""<string> - 用于覆盖设备校准i_pipeline_auto_calibration_mode: ""<string or bool> - 管道自动校准模式。空值表示 DepthAI 管道默认值不变。设置为OFF以禁用自动校准。有效的字符串值为OFF、ON_START和CONTINUOUS。布尔值也接受用于向后兼容的配置:true映射到ON_START,false映射到OFF。i_enable_ir : true<bool> - 是否启用红外投影仪i_restart_on_diagnostics_error: false<bool> - 如果管道中启用了诊断发布并且报告了错误,驱动程序将重新启动i_rs_compat: false<bool> - 开启 Realsense 兼容性。主题、帧名称和参数名称将更改以反映 RS 相机。r_laser_dot_intensity: 0.6<float> <0.0-1.0> - 设置激光点投影仪强度。USB 相机可能需要通过 Y 型适配器提供额外电源r_floodlight_intensity: 0.6<float> <0.0-1.0> - 设置泛光灯投影仪强度。USB 相机可能需要通过 Y 型适配器提供额外电源
管道生成
pipeline_gen 开头i_pipeline_type可以是以下之一RGB- 仅发布 RGB 流,NN 可用RGBD- 发布 RGB + 深度流(为左右相机设置i_publish_topic以启用它们),NN 和空间 NN 可用Stereo- 发布左右传感器的流,NN 可以为每个传感器单独设置RGBStereo- 发布 RGB + 左 + 右流,NN 可以为每个传感器单独设置Depth- 仅发布深度流,NN 可以通过参数在立体节点上设置CamArray- 发布所有检测到的传感器的流,NN 可以为每个传感器单独设置Tof- 仅发布 TOF 流,无 NN 可用DepthTof- 发布深度 + TOF 流,特定于 OAK-D-SR-POE,NN 可以通过参数在立体节点上设置StereoToF- 发布立体 + TOF 流,特定于 OAK-D-SR-POE,NN 可以通过参数在立体节点上设置RGBToF- 发布 RGB + TOF 流,特定于 OAK-D-SR-POE,NN 可以通过参数在立体节点上设置Thermal- 针对 OAK-T 相机,发布 RGB + 热流。
i_nn_type: spatial<string> - 要使用管道创建的 NN 类型i_enable_imu: true<bool> - 是否在某些管道中启用 IMU 节点i_enable_diagnostics: false<bool> - 是否启用诊断节点i_enable_rgbd: false<bool> - 是否在某些管道中启用 RGBD 节点
图像传感器
sensor_name.[PARAMETER_NAME] 开头,例如 rgb.i_width初始参数
i_board_socket_id<int> - 传感器的插槽 ID,主要用于对齐、校准和推断帧名称,每个传感器自动检测但可以覆盖i_enable_feature_tracker: false<bool> - 为此特定传感器启用 FeatureTracker 节点i_enable_nn: false<bool> - 为此特定传感器启用 NeuralNetworki_max_q_size: 8<int> - 设置 DAI 队列大小i_low_bandwidth: false<bool> - 当设置为 true 时,为此特定传感器启用 VideoEncoder 以提高相机和主机之间的延迟。默认情况下,DAI 编码帧(仅在 MJPEG 编码器的情况下,对于 H264 启用i_publish_compressed参数)在主机上解码为 ROS 图像消息。i_low_bandwidth_profile: 4<int> - 使用的编码器类型。以下类型可用:- H264_BASELINE
- H264_HIGH
- H264_MAIN
- H265_MAIN
- MJPEG (默认)
i_low_bandwidth_frame_freq: 30<int> - 编码器的帧频率,用于 H26X 类型i_low_bandwidth_bitrate: 0<int> - 编码器的比特率,用于 H26X 类型i_low_bandwidth_quality: 50<int> - MJPEG 编码器的质量i_publish_compressed: false<bool> - 不将 DAI 编码帧转换为 ROS 图像消息,而是以各自的压缩图像格式发布它们(MJPEG 的 CompressedImage 和 H26X 类型的 FFMPEGMsgs::FFMPPEGPacket)i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_calibration_file: ""<string> - 用于使用 ROS 校准覆盖 DAI 校准i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_enable_lazy_publisher: true<bool> - 是否仅在图像/相机信息主题上检测到订阅时才发布数据i_add_exposure_offset: false<bool> - 是否将曝光偏移添加到 ROS 时间戳i_exposure_offset: 0<int> - 曝光偏移类型:- START
- MIDDLE
- END
i_reverse_stereo_socket_order: false<bool> - 有关更多信息,请参阅下面的“立体插槽顺序”部分i_synced: :false<bool> - 是否将输出添加到同步输出组,所有同步的发布者将发布具有相同时间戳的图像i_publish_topic: true/false<bool> - 是否在 ROS 主题上发布,默认情况下在 CAM_A 插槽上的传感器上为 true,否则为 falsei_publish_full_resolution: false<bool> - 是否发布全分辨率图像i_use_max_resolution_possible: false<bool> - 是否使用最大可能分辨率i_width: 640<int> - 图像宽度i_height: 400<int> - 图像高度i_fps: 30.0<float> - 传感器帧率i_undistorted: true<bool> - 是否对图像进行去畸变i_resize_mode: "CROP"<string> - 图像去畸变时使用的调整大小类型,请参阅 DAI Camera 节点了解更多信息,可以是:- CROP
- LETTERBOX
- STRETCH
i_fsync_continuous: false<bool> - 是否设置帧同步模式。如果启用,i_fsync_mode参数用于该模式i_fsync_mode: "INPUT<string> - 帧同步模式类型,可以是:- OFF
- OUTPUT
- INPUT
i_fsync_trigger: false<bool> - 是否使用外部触发器进行图像捕获i_num_frames_burst: 1<int> - 触发突发中的帧数i_num_frames_discard: 0<int> - 初始突发中要丢弃的帧数(它们的质量可能较差)
运行时参数
r_iso: 800<int> <100-1600> - 设置手动曝光时的 ISO 设置,设置r_set_man_exposure以使用r_exposure: 1000<int> <1-33000> - 设置手动曝光时的曝光设置,设置r_set_man_exposure以使用r_set_man_exposure: false<bool> - 是否设置手动曝光r_set_autoexposure_limit: false<bool> - 是否限制自动曝光r_auto_exposure_limit: 1000<int> - 自动曝光限制r_set_man_focus: false<bool> - 是否设置手动对焦r_focus: 1<int> <1-255> - 对焦值r_set_man_whitebalance: false<bool> - 是否设置手动白平衡r_whitebalance: 3000<int> <1000-12000> - 手动白平衡r_set_sharpness: false<bool> - 是否手动设置锐度r_sharpness: 1<int> <1-4> - 锐度级别r_set_chroma_denoise: false- 是否手动设置色度降噪r_chroma_denoise: 1<int> <1-4> - 色度降噪级别r_set_luma_denoise: false- 是否手动设置亮度降噪r_luma_denoise: 1<int> <1-4> - 亮度降噪级别r_set_auto_exp_region: false<bool> - 是否使用图像的一部分来控制曝光r_auto_exp_region_start_x: 0<int> - 用于自动曝光的矩形起始点(在图像坐标中,即 X 向右,Y 向下)r_auto_exp_region_start_y: 0<int> - 用于自动曝光的矩形起始点(在图像坐标中,即 X 向右,Y 向下)r_auto_exp_region_width: 0<int> - 自动曝光区域的宽度r_auto_exp_region_height: 0<int> - 自动曝光区域的高度
立体参数
深度对齐
stereo.aligned: true 时,立体输出将对齐到 stereo.i_board_socket_id 参数指定的板载插槽(默认为 0/CAM_A)您可以通过设置例如 i_publish_right_rect: true 来启用校正后的立体流。立体插槽顺序
stereo.i_reverse_stereo_socket_order: true(这也可以为单个传感器设置)。自定义传感器插槽
stereo.i_left_socket_id/stereo.i_right_socket_id。请注意,目前如果您想使用 rgb/center 插槽而不是给定的其中一个对,您将需要为此构建一个自定义管道。参数
i_max_q_size: 30<int> - 设置 DAI 队列大小i_fps: 30.0<float> - 立体帧率i_low_bandwidth: false<bool> - 请参阅Sensor节点中的参数说明。注意 此参数与i_subpixel参数不兼容。i_low_bandwidth_profile: 4<int> - 使用的编码器类型。以下类型可用:- H264_BASELINE
- H264_HIGH
- H264_MAIN
- H265_MAIN
- MJPEG (默认)
i_low_bandwidth_frame_freq: 30<int> - 编码器的帧频率,用于 H26X 类型i_low_bandwidth_bitrate: 0<int> - 编码器的比特率,用于 H26X 类型i_low_bandwidth_quality: 50<int> - MJPEG 编码器的质量i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_calibration_file: ""<string> - 用于使用 ROS 校准覆盖 DAI 校准i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_enable_lazy_publisher: true<bool> - 是否仅在图像/相机信息主题上检测到订阅时才发布数据i_add_exposure_offset: false<bool> - 是否将曝光偏移添加到 ROS 时间戳i_exposure_offset: 0<int> - 曝光偏移类型:- START
- MIDDLE
- END
i_reverse_stereo_socket_order: false<bool> - 有关更多信息,请参阅下面的“立体插槽顺序”部分i_synced: :false<bool> - 是否将输出添加到同步输出组,所有同步的发布者将发布具有相同时间戳的图像i_publish_topic: true/false<bool> - 是否在 ROS 主题上发布,默认情况下在 CAM_A 插槽上的传感器上为 true,否则为 falsei_output_disparity: false<bool> - 是否输出视差而不是深度i_enable_left_spatial_nn: false<bool> - 是否创建以左传感器作为 RGB 源的空间 NNi_enable_right_spatial_nn: false<bool> - 是否创建以右传感器作为 RGB 源的空间 NNi_enable_left_rgbd: false<bool> - 是否创建以左传感器作为 RGB 源的 RGBD 节点i_enable_right_rgbd: false<bool> - 是否创建以右传感器作为 RGB 源的 RGBD 节点i_aligned: true<bool> - 是否将立体节点对齐到i_board_socket_idi_run_align_on_host: true<bool> - 是否在主机上运行对齐节点(仅适用于 RVC4)i_depth_preset: FAST_ACCURACY<string> - 应用何种默认深度预设。警告 对于 FAST_ACCURACY 以外的类型,其他立体滤波参数可能会被覆盖。此外,在某些情况下会应用抽取滤波器,导致最终图像尺寸减小,并且增加的处理可能会减少与例如 RVC2 设备上的神经网络共享的可用资源。以下设置已公开:- FAST_ACCURACY
- DEFAULT
- FACE
- HIGH_DETAIL
- ROBOTICS
i_enable_distortion_correction: true<bool> - 切换输出流上的畸变校正i_set_disparity_to_depth_use_spec_translation: false<bool> - 是否使用 CAD 数据中的基线,而不是校准数据i_bilateral_sigma: 0<int> <0-65535> - 双边 sigma 滤波器值。此参数值越大,像素邻域内较远的颜色将混合在一起,导致大面积的半等色。i_lrc_threshold: 10<int> <0-255> - 左右、右左视差图组合的阈值。i_stereo_conf_threshold: 15<int> <0-255> - 视差计算的置信度阈值。高值意味着更多深度值被丢弃i_subpixel: true<bool> - 使用亚像素插值计算视差(默认 3 个小数位。适用于长距离。目前与扩展视差和低带宽模式不兼容。设置亚像素会导致输出更多深度值(点云中可见的“步长”更少,但会消耗更多带宽和资源。在某些深度预设上自动启用。i_subpixel_fractional_bits: 3<int> <3-5> - 定义小数视差的数量:2^xi_rectify_edge_fill_color: 0<int> <-1-255> - 边缘缺失数据的填充颜色。0-255 用于灰度或 -1 用于复制像素i_enable_alpha_scaling: false<bool> - 启用 alpha 缩放。i_alpha_scaling: 0.0<float> - Alpha 缩放参数。它是 0(未畸变图像中的所有像素都有效)和 1(未畸变图像中保留所有源图像像素)之间的自由缩放参数。在某些高畸变镜头上,和/或由于校正(图像旋转),即使 alpha=0 也可能出现无效区域,在这些情况下 alpha < 0.0 有助于去除无效区域。i_disparity_width: DISPARITY_96<string> - 视差搜索范围。值:- DISPARITY_64
- DISPARITY_96
i_extended_disp: false<bool> - 视差范围从 0-95 增加到 0-190,结合全分辨率和缩小图像。适用于短距离物体。目前与亚像素视差不兼容。i_enable_companding: false<bool> - 使用稀疏匹配启用视差压缩。对 N 个视差进行逐像素匹配。对 M 个视差进行每隔 2 个像素匹配。对 T 个视差进行每隔 4 个像素匹配。在 96 个视差的情况下:N=48,M=32,T=16。这样,通过稀疏匹配,搜索范围扩展到 176 个视差。请注意,启用此标志时,只有深度图会受到影响,视差图不会。i_enable_temporal_filter: false<bool> - 启用时间滤波器。i_temporal_filter_alpha: 0.4<float> <0.0-1.0> - 指数移动平均中的 alpha 因子,Alpha=1 - 无滤波器。Alpha=0 - 无限滤波器。确定应平均的时间历史的范围。i_temporal_filter_delta: 20<int> - 步长边界。建立用于保留“边缘”的阈值。如果相邻像素之间的视差值超过此 delta 参数设置的视差阈值,则将暂时禁用滤波。默认值 0 表示自动:3 个视差整数级别。在亚像素模式下,它是 3 * 亚像素级别数。i_temporal_filter_persistency: VALID_2_IN_LAST_4<string> - 持久性模式。如果当前视差/深度值无效,它将根据持久性模式被较旧的值替换。有效值:- PERSISTENCY_OFF
- VALID_8_OUT_OF_8
- VALID_2_IN_LAST_3
- VALID_2_IN_LAST_4
- VALID_2_OUT_OF_8
- VALID_1_IN_LAST_2
- VALID_1_IN_LAST_5
- VALID_1_IN_LAST_8
- PERSISTENCY_INDEFINITELY
i_enable_speckle_filter: false<bool> - 启用斑点滤波器。i_speckle_filter_speckle_range: 50<int> - 斑点搜索范围。i_enable_disparity_shift: false<bool> - 将输入帧移动一定数量的像素以增加最小深度。例如,移动 48 个像素将把有效视差搜索范围从 (0,95] 更改为 [48,143]。这是减少 minZ 的另一种方法。我们通常只在已知没有物体比 MaxZ 更远时才建议这样做,例如将深度相机安装在桌子上方并指向桌子表面。i_disparity_shift: 0<int> - 视差偏移值。i_enable_spatial_filter: false<bool> - 启用空间滤波器。i_spatial_filter_hole_filling_radius: 2<int> - 在滤波器通过期间水平应用的启发式对称孔洞填充模式。旨在以最小的性能影响纠正微小伪影。孔洞填充的搜索半径。i_spatial_filter_alpha: 0.5<float> - 指数移动平均中的 Alpha 因子,Alpha=1 - 无滤波器。Alpha = 0 - 无限滤波器。确定平滑量。i_spatial_filter_delta: 20<int> - 类似于时间滤波器中的 delta。i_spatial_filter_num_iterations: 1<int> - 图像在水平和垂直方向上的迭代次数。i_enable_threshold_filter: false<bool> - 启用阈值滤波器i_threshold_filter_min_range: 400<int> - 深度单位(毫米)的最小范围。低于此值的深度值无效。i_threshold_filter_max_range: 15000<int> - 深度单位的最大范围。超过此值的深度值无效。i_enable_brightness_filter: false<bool> - 启用亮度滤波器i_brightness_filter_min_brightness: 0<int> - 最小像素亮度。如果输入像素小于或等于此值,则深度值无效。i_brightness_filter_max_brightness: 255<int> - 最大像素亮度。如果输入像素大于或等于此值,则深度值无效。i_enable_decimation_filter: false<bool> - 启用抽取滤波器。影响最终图像尺寸。i_decimation_filter_decimation_mode: PIXEL_SKIPPING<string> - 抽取算法类型。可用值:- PIXEL_SKIPPING
- NON_ZERO_MEDIAN
- NON_ZERO_MEAN
i_decimation_filter_decimation_factor: 1<int> <1-4> - 有效值为 1,2,3,4。视差/深度图 x/y 分辨率将以此值抽取。i_use_neural_depth: false<bool>- 是否使用神经深度而不是常规立体(仅在 RVC4 上可用)i_neural_depth_model: NEURAL_DEPTH_SMALL<string> - 神经深度类型。以下类型可用- NEURAL_DEPTH_LARGE
- NEURAL_DEPTH_MEDIUM
- NEURAL_DEPTH_SMALL
- NEURAL_DEPTH_NANO
r_edge_threshold: 10<int> - 神经深度的边缘阈值r_confidence_threshold: 125<int> - 神经深度的置信度阈值- 以下参数对于左右校正流相同,为简洁起见,下面是左侧的参数
i_publish_left_rect: false<bool> - 是否发布校正后的左流i_left_rect_low_bandwidth: false<bool> - 左侧校正低带宽配置文件i_left_rect_low_bandwidth_profile: 4<int> - 左侧校正低带宽配置文件i_left_rect_low_bandwidth_frame_freq: 30<int> - 左侧校正低带宽帧频率i_left_rect_low_bandwidth_bitrate: 0<int> - 左侧校正低带宽比特率i_left_rect_low_bandwidth_quality: 50<int> - 左侧校正低带宽质量i_left_rect_publish_compressed: false<bool> - 是否发布左侧校正的压缩图像i_left_rect_add_exposure_offset: false<bool> - 左侧校正添加曝光偏移i_left_rect_exposure_offset: 0<int> - 左侧校正曝光偏移设置i_left_rect_enable_feature_tracker: false<bool> - 是否为校正后的左侧添加特征跟踪器i_left_rect_synced: false<bool> - 是否将左侧校正与其它流同步
特征跟踪器
depthai_ros_msgs/msg/TrackedFeatures 消息。 例如,要在 rgb 节点上启用功能,请设置 rgb: i_enable_feature_tracker: true。要在校正流上启用发布,例如设置 stereo: i_left_rect_enable_feature_tracker参数
i_motion_estimation_type: LUKAS_KANADE_OPTICAL_FLOW<string> - 运动估计器类型,可以是:- LUKAS_KANADE_OPTICAL_FLOW
- HW_MOTION_ESTIMATION
i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)
IMU
参数:
i_max_q_size: 8<int> - 设置 DAI 队列大小i_acc_freq: 480<int> - 加速度计传感器频率i_acc_cov: 0.0<float> - 加速度计协方差i_batch_report_threshold: 5<int> - 批处理报告大小i_enable_rotation: false<bool> - 是否启用旋转矢量和磁力计数据(在使用 IMU_WITH_MAGN/IMU_WITH_MAGN_SPLIT 消息类型和 BNO086 传感器时可用)i_gyro_cov: 0.0<float> - 陀螺仪协方差i_gyro_freq: 400<int> - 陀螺仪频率i_mag_cov: 0.0<float> - 磁力计协方差i_mag_freq: 100<int> - 磁力计频率i_max_batch_reports: 10<int> - 每批最大报告数i_message_type: IMU<string> - ROS 发布者类型:IMU- sensor_msgs/ImuIMU_WITH_MAG- depthai_ros_msgs/ImuWithMagneticFieldIMU_WITH_MAG_SPLIT- 两个发布者 - sensor_msgs/Imu 和 sensor_msgs/MagneticField
i_rot_cov: -1.0<float> - 旋转协方差i_rot_freq: 400<int> - 旋转频率i_sync_method: COPY<string> - 同步方法。可用选项(警告 RVC4 设备目前仅支持 COPY):COPYLINEAR_INTERPOLATE_GYROLINEAR_INTERPOLATE_ACCEL
i_rotation_vector_type<string> - 旋转矢量类型,更多信息请参阅 此链接。可用选项:ROTATION_VECTORGAME_ROTATION_VECTORGEOMAGNETIC_ROTATION_VECTORARVR_STABILIZED_ROTATION_VECTORARVR_STABILIZED_GAME_ROTATION_VECTOR
i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)
神经网络
camera.i_nn_type可以是none(无 NN)、rgb或spatial。这决定了我们加载的 NN 是否也应该获取深度信息(例如提供 3D 格式的检测)。默认设置为spatial
参数
i_nn_family: detection<string> - 设置我们想要哪种 NN。目前可用的选项有:detectionsegmentation(目前仅在 RVC2 上)
i_nn_model: yolov6-nano<string> - 我们要加载哪个模型,模型在驱动程序启动时会自动从网络下载,类似于 DepthAI C++/Python 示例。i_nn_confidence_threshold: 0.5<float> - NN 的置信度阈值i_nn_depth_lower_threshold: 100<int> - (仅限空间)检测的下限深度阈值(毫米)i_nn_depth_upper_threshold: 10000<int> - (仅限空间)检测的上限深度阈值(毫米)i_enable_passthrough: false<bool> - 是否发布 RGB 直通图像i_enable_passthrough_depth: false<bool> - 是否发布深度直通图像i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_bounding_box_scale_factor: 0.5<float> <0.0-1.0> - 检测的边界框比例因子i_max_q_size: 8<int> - 设置 DAI 队列大小
sensor_name.i_enable_nn 设置为 true 来选择在特定传感器上运行 NN。之后,您可以类似地将 sensor_name_nn.i_nn_model 设置为配置文件路径。 您还可以为立体节点设置空间 NN,并将其左/右流之一用作 RGB 输入。这可以在带有 RGB 侧传感器的相机中启用,例如 OAK-D-SR 和 OAK-D-LR。设置也类似:stereo.i_enable_left_spatial_nn- 设置为 true 以启用以左传感器作为输入的空间 NN
同步
pipeline_gen: i_enable_sync: true,例如 rgb.i_synced: true 和 stereo.i_synced: true。 此示例配置在运行 driver.launch.py 并带有 pointcloud.enable:=true 参数时应用。参数
i_sync_threshold: 10<int> - 设置组中消息之间的最大间隔(毫秒)。i_sync_attempts: 10<int> - 同步尝试次数
ToF
参数
i_publish_topic: true<bool> - 是否发布主题i_max_q_size: 8<int> - 设置 DAI 队列大小i_low_bandwidth: false<bool> - 请参阅Sensor节点中的参数说明。注意 此参数与i_subpixel参数不兼容。i_low_bandwidth_profile: 4<int> - 使用的编码器类型。以下类型可用:- H264_BASELINE
- H264_HIGH
- H264_MAIN
- H265_MAIN
- MJPEG (默认)
i_low_bandwidth_frame_freq: 30<int> - 编码器的帧频率,用于 H26X 类型i_low_bandwidth_bitrate: 0<int> - 编码器的比特率,用于 H26X 类型i_low_bandwidth_quality: 50<int> - MJPEG 编码器的质量i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_calibration_file: ""<string> - 用于使用 ROS 校准覆盖 DAI 校准i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_enable_lazy_publisher: true<bool> - 是否仅在图像/相机信息主题上检测到订阅时才发布数据i_publish_compressed: false<bool> - 是否发布压缩图像i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_add_exposure_offset: false<bool> - 是否将曝光偏移添加到 ROS 时间戳i_exposure_offset: 0<int> - 曝光偏移类型:- START
- MIDDLE
- END
i_width: 640<int> - 图像宽度i_height: 400<int> - 图像高度i_fps: 30<int> - 图像帧率i_aligned :false<bool> - 是否将图像对齐到其他传感器i_aligned_socket_id: ""<string> - 对齐图像的插槽i_run_align_on_host: true<bool> - 是否在主机上运行对齐节点(仅适用于 RVC4)i_synced: :false<bool> - 是否将输出添加到同步输出组,所有同步的发布者将发布具有相同时间戳的图像i_preset_mode: TOF_MID_RANGE<string> - 图像过滤的预设模式
热像仪
参数
i_publish_topic: true<bool> - 是否发布主题i_max_q_size: 8<int> - 设置 DAI 队列大小i_low_bandwidth: false<bool> - 请参阅Sensor节点中的参数说明。注意 此参数与i_subpixel参数不兼容。i_low_bandwidth_profile: 4<int> - 使用的编码器类型。以下类型可用:- H264_BASELINE
- H264_HIGH
- H264_MAIN
- H265_MAIN
- MJPEG (默认)
i_low_bandwidth_frame_freq: 30<int> - 编码器的帧频率,用于 H26X 类型i_low_bandwidth_bitrate: 0<int> - 编码器的比特率,用于 H26X 类型i_low_bandwidth_quality: 50<int> - MJPEG 编码器的质量i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_calibration_file: ""<string> - 用于使用 ROS 校准覆盖 DAI 校准i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_enable_lazy_publisher: true<bool> - 是否仅在图像/相机信息主题上检测到订阅时才发布数据i_publish_compressed: false<bool> - 是否发布压缩图像i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_add_exposure_offset: false<bool> - 是否将曝光偏移添加到 ROS 时间戳i_exposure_offset: 0<int> - 曝光偏移类型:- START
- MIDDLE
- END
i_width: 640<int> - 图像宽度i_height: 400<int> - 图像高度i_fps: 30.0<float> - 图像帧率i_aligned :false<bool> - 是否将图像对齐到其他传感器i_aligned_socket_id: ""<string> - 对齐图像的插槽i_run_align_on_host: true<bool> - 是否在主机上运行对齐节点(仅适用于 RVC4)i_synced: :false<bool> - 是否将输出添加到同步输出组,所有同步的发布者将发布具有相同时间戳的图像i_orientation: NORMAL<string> - 图像方向。可用选项:- NORMAL
- MIRROR
- FLIP
- MIRROR_FLIP
r_auto_ffc: false<bool> - 自动平场校正。控制快门是否由传感器模块自动控制。r_close_manual_shutter: false<bool> - 当 autoFFC 禁用时,将此设置为 True/False 以关闭/打开快门。r_brightness_level: 0<int> <0-255> - 图像亮度级别。r_time_noise_filter_level: 0<int> <0-3> - 时间噪声滤波器级别。过滤掉随时间出现的噪声。
RGBD
pipeline_gen.i_enable_rgbd 参数或在 Stereo 节点中设置 i_enable_left/right_rgbd 来在某些管道中打开。参数
i_publish_topic: true<bool> - 是否发布主题i_max_q_size: 2<int> - 设置 DAI 队列大小i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_num_threads: 1<int> - 用于 RGBD 节点的线程数i_run_sync_on_host: true<bool> - 是否在主机上同步消息i_run_align_on_host: true<bool> - 是否在主机上运行对齐节点(仅适用于 RVC4)
VIO
pipeline_gen.i_enable_vio 参数在某些管道中打开。参数
i_publish_topic: true<bool> - 是否发布主题i_max_q_size: 2<int> - 设置 DAI 队列大小i_update_ros_base_time_on_ros_msg: false<bool> - 如果您的系统出现时间偏移(例如系统时钟由外部控制),请启用此功能i_get_base_device_timestamp: false<bool> - 控制是否将获取的数据的 DAI 时间戳与主机同步(时间戳本身仍与 ROS 时间对齐)i_run_sync_on_host: true<bool> - 是否在主机上同步消息i_imu_update_rate: 400<int> - 更新 imu 消息的速率i_width: 640<int> - 图像宽度i_height: 400<int> - 图像高度i_fps: 60.0<float> - 图像帧率i_config_path: 'depthai_ros_driver_default.json'<string> - 使用的 config.json 的完整路径,当使用默认值时,使用 depthai_ros_driver/config/custom 中的配置i_override_local_transform: false<bool> - 是否覆盖局部变换,启用时可设置以下参数i_local_transform_x: 0.0<float> - X 位置i_local_transform_y: 0.0<float> - Y 位置i_local_transform_z: 0.0<float> - Z 位置i_local_transform_qx: 0.0<float> - 四元数的 X 分量i_local_transform_qy: 0.0<float> - 四元数的 Y 分量i_local_transform_qz: 0.0<float> - 四元数的 Z 分量i_local_transform_qw: 0.0<float> - 四元数的 w 分量
i_override_imu_extrinsics: false<bool> - 是否用其他值覆盖 IMU 外参i_imu_extr_x: 0.0<float> - X 位置i_imu_extr_y: 0.0<float> - Y 位置i_imu_extr_z: 0.0<float> - Z 位置i_imu_extr_qx: 0.0<float> - 四元数的 X 分量i_imu_extr_qy: 0.0<float> - 四元数的 Y 分量i_imu_extr_qz: 0.0<float> - 四元数的 Z 分量i_imu_extr_qw: 0.0<float> - 四元数的 w 分量
i_set_acc_bias: false<bool> - 覆盖默认加速度计偏差i_accel_bias: 9x0.0<vector<double>> - 加速度计偏差i_set_acc_noise_std: false<bool> - 覆盖加速度计的标准噪声i_acc_noise_std: 3x0.0<vector<double>> - 加速度计标准噪声i_set_gyro_bias: false<bool> - 覆盖默认陀螺仪偏差i_gyro_bias: 9x0.0<vector<double>> - 陀螺仪偏差i_set_gyro_noise_std: false<bool> - 覆盖陀螺仪的标准噪声i_gyro_noise_std: 3x0.0<vector<double>> - 陀螺仪标准噪声i_publish_tf: true<bool> - 是否也发布 TF 帧i_frame_id: odom<string> - 消息的帧 IDi_child_frame_id: oak_parent_frame<string> - 子帧 IDi_covariance: 36x0.0<vector<double>> - 消息的协方差