#!/usr/bin/env bash # Hand-eye calibration helpers. # Scripts: ~/ros2/scripts/run_handeye.sh # Package YAML: ~/ros2/src/arm_application/config/handeye_*.yaml # Site overrides (board / motion): ~/ros2/config/site.yaml → handeye: # Runtime output: /tmp/handeye_calib/ # # Usage: # bash ~/ros2/scripts/run_handeye.sh calibrate # bash ~/ros2/scripts/run_handeye.sh waypoints # bash ~/ros2/scripts/run_handeye.sh teach # RDK 软拖拽(推荐) # bash ~/ros2/scripts/run_handeye.sh teach --append # 接着上次点位继续采 # bash ~/ros2/scripts/run_handeye.sh teach --ros # 示教器 Free Drive # bash ~/ros2/scripts/run_handeye.sh merge [taught.txt] # bash ~/ros2/scripts/run_handeye.sh --arm 91 teach # bash ~/ros2/scripts/run_handeye.sh --arm 91 calibrate # # calibrate / waypoints 需要: # T1: bash ~/ros2/scripts/run_real.sh --arm 89|91 # T2: bash ~/ros2/scripts/run_camera_d405.sh --arm 89|91 --preview # teach(拖拽)需要: 先停掉 run_real.sh 和相机(RDK + D405 都独占) # 89 与 91 的结果文件、示教点、workdir 完全分开,禁止混用。 set -eo pipefail ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" # shellcheck disable=SC1091 source "${ROOT}/scripts/lib/parse_arm_args.sh" parse_arm_args "$@" set -- "${PARSE_ARM_REST[@]}" CMD="${1:-}" shift || true usage() { sed -n '2,18p' "$0" } # shellcheck disable=SC1091 source "${ROOT}/scripts/env.sh" # shellcheck disable=SC1091 source "${ROOT}/scripts/lib/load_site_config.sh" # Prefer package source tree (editable); fall back to install share APP_CFG="${ROOT}/src/arm_application/config" if [[ ! -d "${APP_CFG}" ]]; then APP_CFG="$(ros2 pkg prefix arm_application 2>/dev/null)/share/arm_application/config" || true fi WP="${SITE_HANDEYE_WAYPOINTS:-${APP_CFG}/handeye_poses.yaml}" CAL="${SITE_HANDEYE_CALIBRATE:-${APP_CFG}/handeye_calibrate.yaml}" TOUR="${SITE_HANDEYE_TOUR:-${APP_CFG}/handeye_waypoints.yaml}" RES="${SITE_HANDEYE_FILE:-${APP_CFG}/handeye_result.yaml}" WORKDIR="${SITE_HANDEYE_WORKDIR:-/tmp/handeye_calib}" TAUGHT="${WORKDIR}/taught_poses.txt" PREFIX="${SITE_JOINT_PREFIX:-Rizon4-063989_}" CAM="${SITE_CAM_NAME:-d405}" _kill_servo() { pkill -f 'visual_servo.launch' 2>/dev/null || true pkill -f 'lib/arm_application/servo_node' 2>/dev/null || true pkill -f 'lib/arm_application/perception_node' 2>/dev/null || true sleep 1 } _need_files() { local f for f in "$@"; do if [[ ! -f "$f" ]]; then echo "ERROR: missing $f" >&2 exit 2 fi done } _need_robot() { if ! ros2 service list 2>/dev/null | grep -q '/set_named_pose'; then echo "ERROR: start run_real.sh first" >&2 exit 1 fi } _need_camera() { if ! ros2 topic list 2>/dev/null | grep -q "/${CAM}/color/image_raw"; then echo "ERROR: no /${CAM}/color/image_raw — start run_camera_d405.sh" >&2 exit 1 fi } cmd_show() { echo "=== hand-eye (package + site) ===" echo " arm : ${SITE_ROBOT_SN:-} ${SITE_ROBOT_LABEL:-}" echo " package cfg : ${APP_CFG}" echo " calibrate : ${CAL}" echo " poses : ${WP}" echo " tour : ${TOUR}" echo " result : ${RES}" echo " workdir : ${WORKDIR}" echo " board : ${SITE_HANDEYE_BOARD_COLS:-?}x${SITE_HANDEYE_BOARD_ROWS:-?} inner, square=${SITE_HANDEYE_SQUARE_M:-?} m" python3 "${ROOT}/scripts/lib/export_site_env.py" --print || true if [[ -f "${WP}" ]]; then python3 - <&2; exit 1 ;; esac done echo "=== kill visual_servo + camera (D405 exclusive) ===" _kill_servo pkill -f 'run_camera_d405' 2>/dev/null || true pkill -f 'realsense_color_pub' 2>/dev/null || true pkill -f 'realsense2_camera_node' 2>/dev/null || true sleep 1 if [[ "${backend}" == "rdk" ]]; then if ros2 service list 2>/dev/null | grep -q '/set_named_pose'; then echo "ERROR: RDK 拖拽与 run_real.sh 互斥。请先在那个终端 Ctrl-C 停掉 run_real.sh" >&2 exit 1 fi else _need_robot fi mkdir -p "${WORKDIR}/images" if [[ "${append}" == true ]]; then echo "=== append: keep existing ${TAUGHT} ===" else # 重新设点:丢掉上次 taught,避免 merge 混进旧位姿 : > "${TAUGHT}" fi echo "=== interactive teach backend=${backend} → ${WORKDIR} ===" echo " 窗口按键: d=拖拽开 s=拖拽关 Enter=拍照记点 q=结束" echo " 建议 8–12 个姿态,棋盘占画面约 30–70%" echo " 结束后: bash ~/ros2/scripts/run_handeye.sh merge" echo " bash ~/ros2/scripts/run_handeye.sh calibrate" TEACH_ARGS=( -p backend:="${backend}" -p robot_sn:="${SITE_ROBOT_SN:-Rizon4-063989}" -p joint_prefix:="${PREFIX}" -p camera_source:="${CAM}" -p output_dir:="${WORKDIR}" ) if [[ -n "${SITE_CAM_SERIAL:-}" ]]; then TEACH_ARGS+=(-p camera_serial:="${SITE_CAM_SERIAL}") fi if [[ -n "${SITE_CAM_WIDTH:-}" ]]; then TEACH_ARGS+=(-p width:="${SITE_CAM_WIDTH}" -p height:="${SITE_CAM_HEIGHT:-480}" -p fps:="${SITE_CAM_FPS:-30}") fi TEACH_ARGS+=( -p auto_exposure:="$([ "${SITE_CAM_AUTO_EXPOSURE:-1}" = "1" ] && echo true || echo false)" -p ae_limit_us:="${SITE_CAM_AE_LIMIT_US:-1800}" -p emitter_enabled:="$([ "${SITE_CAM_EMITTER:-0}" = "1" ] && echo true || echo false)" -p exposure_us:="${SITE_CAM_EXPOSURE_US:-0}" -p gain:="${SITE_CAM_GAIN:-0}" ) exec ros2 run arm_application handeye_teach --ros-args "${TEACH_ARGS[@]}" } case "${CMD}" in calibrate|calib) cmd_calibrate ;; waypoints|tour) cmd_waypoints "$@" ;; teach) cmd_teach "$@" ;; merge) cmd_merge "$@" ;; show) cmd_show ;; -h|--help|help|"") usage; [[ -n "${CMD}" ]] || exit 0; exit 0 ;; *) echo "Unknown: ${CMD}" >&2; usage >&2; exit 1 ;; esac