# pursuit_agv_release

**Repository Path**: cloudkernel-tech/pursuit_agv_release

## Basic Information

- **Project Name**: pursuit_agv_release
- **Description**: release file for pursuit AGV production
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-04-13
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 1. Intro

Release guide for pursuit autopilot, and more information can be referred in https://cloudkernel.cn/pursuit


# 2. First Time Use Setup

## Method 1: Setup with Docker container for pursuit production [Recommended]


(1) Seek the docker image file (cloudkernel_dasa_rosnav.tar.gz) from our customer service and place it in the home directory.


(2) Plug the ROS cable from pursuit autopilot into a USB port in the host computer.


(3) Run the convenience script for host setup in one shoot:

	bash Tools/install_prerequisites_host.sh

Users may run the scripts for several times depending on whether the docker tool and USB port rule are configured, please refer to the messages from the script.

The setup process is successful only when the message "host setup completed successfully!" shows up.


## Method 2: Setup with native Ubuntu 18.04 host computer

The pursuit software is designed specifically for Ubuntu 18.04 with ROS melodic. For users with other Ubuntu versions, please refer to Method 2 alternatively.

(1) Add pursuit repository for apt update

	# Just add the key locally
	sudo apt-key add pubkey_pursuit2025.asc

        echo "deb [arch=$( dpkg --print-architecture )] https://mirror.cloudkernel.cn $(lsb_release -cs) pursuit-main" | sudo tee /etc/apt/sources.list.d/ros-pursuit.list

        sudo apt update

        sudo apt upgrade

(2) Download pursuit program for manual installation

Ubuntu 18.04 + ROS melodic computer only:

	# Clone release files 
	cd ~
	git clone https://gitee.com/cloudkernel-tech/pursuit_agv_release

	# Perform installation in the host computer
	cd ~/pursuit_agv_release
	bash Tools/install_prerequisites_host.sh



# 3. How to Update Software in the Docker Container

The pursuit software is maintained in the cloud, users are recommended to perform upgrade periodically:

		# Enter the pursuit_agv_container
		docker start pursuit_agv_container 
		docker exec -it pursuit_agv_container bash

		cd /home/src/catkinws_nav

		# First time use
		sudo apt install ros-melodic-yocs-velocity-smoother
		sudo apt-get -y install libgeographic-dev

		# Download and install required pursuit pkgs
		bash download_deb_from_pursuit_host.sh
		bash install_all_deb.sh


# Convenience Scripts for Operations

- Tools/run_pursuit_agv_nodes.sh: script to launch all nodes in the host computer and docker container for outdoor avoidance. Please run in the host computer only.