tecgihan_driver

Package Description - パッケージ概要

This package contains softwares for Tec Gihan Co.,Ltd. sensor amplifiers running with Linux and ROS (Robot Operating System).

本パッケージはテック技販製センサアンプの Linux および ROS(Robot Operating System) 用ソフトウェアパッケージです．

Sensors and Amplifiers - 対応センサ・アンプ

• Tec Gihan Co.,Ltd. - テック技販
  • Amplifiers for Robot - ロボット用アンプ
    • DMA-03 for Robot
  • Force Sensors - 力センサ
    • USL06-H5 Series
    • USL08-H6 Series
      

System Requirement - システム要件

tecgihan_driver supports the following system combinations.
tecgihan_driver は下記のシステムの組み合わせに対応しています．

• Ubuntu 22.04 + ROS Humble
• Ubuntu 24.04 + ROS Jazzy

Software Configurations of DMA-03 for Robot Amplifier Driver
- ロボット用 DMA-03 アンプドライバソフトウェア構成

Launch Files - Launch ファイル

1. dma03_demo_launch.xml
   • ROS launch file to launch the DMA-03 for Robot amplifier demonstration
     ロボット用 DMA-03 アンプのデモンストレーションを起動する ROS launch ファイル
2. dma03_ros_launch.py / dma03_ros_launch.xml
   • ROS launch file that launches the software of dma03_ros_publisher.py with parameter settings
     dma03_ros_publisher.py のソフトウェアをパラメータ設定と合わせて起動する ROS launch ファイル

Python Scripts - Python スクリプト

1. dma03_driver.py
   • Linux software for DMA-3 for Robot Amplifier communication and control software for DMA-03 amplifier for robots
     ロボット用 DMA-03 アンプの Linux デバイス通信・制御ソフトウェア
   • Linux software that does not depend on ROS
     ROS には依存していない Linux ソフトウェア
   • DMA03DriverForRobot API
2. dma03_ros_publisher.py
   • ROS wrapper that publishes data retrieved using 1 as ROS Topics
     1 を利用して取得したデータを ROS トピックとして発行する ROS ラッパー
   • Publish when data is acquired from the amplifier, or by a timer event
     アンプからのデータ取得時に発行，もしくはタイマーイベントによる発行
   • ROS Topic Message Type - ROS トピックメッセージ型
     • Vector3Stamped
       • header : Header
         • stamp : Type: Time
           • sec : Type: int
           • nanosec : Type: int
         • frame_id : Type: string
       • vector: Type: Vector3
         • x : Type: float
         • y : Type: float
         • z : Type: float
3. force_to_wrench.py
   • A program that converts a Vector3Stamped type message topic published by dma03_ros_publisher.py into a WrenchStamped type message topic that can be displayed in RViz and publishes it as a ROS topic
     dma03_ros_publisher.py で発行される Vector3Stamped 型メッセージを RViz で表示できる WrenchStamped 型メッセージに変換して ROS トピックとして発行するプログラム
4. set_udev_rules.py
   • A program to set the permissions for using the DMA-03 for Robot amplifier on Linux
     Linux で DMA-03 ロボット用アンプの利用権限を設定するプログラム

Installation - インストール

Before this installation, make sure that the appropriate version of ROS is already installed on your Ubuntu PC.

インストールの前提として既に Ubuntu PC に適切なバージョンの ROS がインストールされていることを確認してください．

• ROS 2 Documentation: Jazzy - Installation / Ubuntu (deb packages)
  • https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debs.html
• ROS 2 Documentation: Humble - Installation / Ubuntu (deb packages)
  • https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html

Open a terminal and install tecgihan_driver with running the following commands line by line.

ターミナルを起動して次の各行のコマンドを実行して tecgihan_driver をインストールします．

• $ROS_DISTRO : Replace as jazzy or humble
$ROS_DISTRO : jazzy もしくは humble で置き換えてください．

sudo apt update
sudo apt full-upgrade
sudo apt install ros-$ROS_DISTRO-tecgihan-driver

When installing with the apt command above, the user is configured to belong to the dialout group in order to enable access to the DMA-03 for Robot amplifier. To enable the changes to the group settings, please do one of two methods below.

File truncated at 100 lines see the full file