Skip to content

Latest commit

 

History

History
148 lines (119 loc) · 4.91 KB

README.md

File metadata and controls

148 lines (119 loc) · 4.91 KB

phoxi_camera_ros2

This is the development for the ros2 driver of Photoneo Phoxi 3D scanner (refer to its ROS1 driver https://github.com/photoneo/phoxi_camera) image

Installation

Installation steps

  • Download latest PhoXi Control according to your ubuntu version
  • Add rights to execute downloaded file
sudo chmod +x PhotoneoPhoXiControlInstaller-xxxxx.run
  • Install downloaded file
sudo ./PhotoneoPhoXiControlInstaller-xxxxx.run
  • Clone phoxi_camera_ros2 repository to your ROS2 workspace (usually ros2_ws/src)
cd ros2_ws/src
git clone https://github.com/zyadan/phoxi_camera_ros2
  • Change working directory to your root ROS workspace folder (usually ros2_ws)
cd ros2_ws
  • Install all dependencies needed by phoxi_camera package
rosdep install --from-paths src --ignore-src -r -y
  • Build the packages
colcon build
  • Copy libPhoXi_API_gcc11.3.0_Release.so.1.10.0 to ros2_ws/install/phoxi_camera/lib folder (need to be fixed in next stage)
cd ros2_ws
cp /opt/Photoneo/PhoXiControl-1.10.0/API/lib/libPhoXi_API_gcc11.3.0_Release.so.1.10.0 ./install/phoxi_camera/lib/

Parameters

~/scanner_id_                  - Default PhoXi 3D Scannet to connect after startup. Default value: "2019-07-005-LC3"
~/frame_id:                    - Frame id to which captured data relies to. Default value: "PhoXi3Dscanner_sensor"
~/latch_topics_                 - Default value: false
~/topic_queue_size_             - Default value: 1
~/init_from_config_             - Default value: false # if true all following parameters will be initialized from this config otherwise from 
                                  PhoXi control application.
~/organized_cloud_               - Default value: false  # if true organized point cloud will be published, other otherwise unorganized

  
~/log_level                     - Default value: info    # debug log level [DEBUG|INFO|WARN|ERROR|FATAL]
~/config_file                   - Default value:         # yaml config file
~/start_acquisition_            - Default value: false 
~/stop_acquisition_             - Default value: false
~/resolution_                   - Default value:  1
~/scan_multiplier_              - Default value:  1
~/confidence_                   - Default value:  3.0
~/send_confidence_map_          - Default value: true
~/send_depth_map_               - Default value:   true
~/send_normal_map_              - Default value:  true
~/send_point_cloud_             - Default value:  true
~/send_texture_                 - Default value:  true
~/shutter_multiplier_           - Default value:  1
~/timeout_                      - Default value:  -3
~/trigger_mode_                 - Default value:  1
~/coordinate_space_             - Default value:  1
~/ambient_light_suppression_    - Default value:  false'
~/single_pattern_exposure_      - Default value:  2
~/camera_only_mode_             - Default value:  false

Available ROS services

~/phoxi_camera/V2/is_acquiring
~/phoxi_camera/V2/is_connected
~/phoxi_camera/V2/start_acquisition
~/phoxi_camera/V2/stop_acquisition
~/phoxi_camera/V2/set_transformation
~/phoxi_camera/V2/set_coordinate_space
~/phoxi_camera/V2/save_last_frame
~/phoxi_camera/connect_camera
~/phoxi_camera/disconnect_camera
~/phoxi_camera/get_device_list
~/phoxi_camera/get_frame
~/phoxi_camera/get_hardware_indentification
~/phoxi_camera/get_supported_capturing_modes
~/phoxi_camera/is_acquiring
~/phoxi_camera/is_connected
~/phoxi_camera/save_frame
~/phoxi_camera/set_parameters
~/phoxi_camera/start_acquisition
~/phoxi_camera/stop_acquisition
~/phoxi_camera/trigger_image

~/phoxi_camera_node/describe_parameters
~/phoxi_camera_node/get_parameter_types
~/phoxi_camera_node/get_parameters
~/phoxi_camera_node/list_parameters
~/phoxi_camera_node/set_parameters
~/phoxi_camera_node/set_parameters_atomically

Available ROS topics

~/phoxi_camera/confidence_map
~/phoxi_camera/depth_map
~/phoxi_camera/normal_map
~/phoxi_camera/points
~/phoxi_camera/rgb_texture
~/phoxi_camera/texture

Test PhoXi ROS2 interface with real device

  • Start PhoXiControl application image

  • Run Interface node

ros2 run phoxi_camera phoxi_camera_node
# or run with launch file
ros2 launch phoxi_camera phoxi_camera_launch.py

image

  • Use available ROS2 services to control your 3D scanner image