diff --git a/fetch_binary_drivers/.gitignore b/fetch_binary_drivers/.gitignore new file mode 100644 index 0000000..1b58f98 --- /dev/null +++ b/fetch_binary_drivers/.gitignore @@ -0,0 +1,3 @@ +build +*.tar.gz +*.so diff --git a/fetch_binary_drivers/CMakeLists.txt b/fetch_binary_drivers/CMakeLists.txt new file mode 100644 index 0000000..b7514e9 --- /dev/null +++ b/fetch_binary_drivers/CMakeLists.txt @@ -0,0 +1,82 @@ +cmake_minimum_required(VERSION 3.5) +project(fetch_drivers) + +### +# +# This is the public version of fetch_drivers. +# +# This is a binary only release of our dirvers and firmware. +# The drivers and firmware have been compiled for our research robots, inside of Docker containers on our TeamCity build servers. +# +# The resulting output of that build job a tar.gz, where the build job should only copy in what is required for the research robots. +# This public repository, just pulls in that tar.gz and extracts installs it into ROS/catkin paths. +## + +find_package(catkin REQUIRED + COMPONENTS + mk +) + +## System dependencies are found with CMake's conventions +find_package(Boost REQUIRED + COMPONENTS + filesystem + program_options + python + thread + system +) + +add_custom_target( + binary_driver ALL + COMMAND cmake -E chdir ${PROJECT_SOURCE_DIR} $(MAKE) -f Makefile.tarball + COMMAND cmake -E make_directory ${CATKIN_DEVEL_PREFIX}/${CATKIN_GLOBAL_LIB_DESTINATION}/${PROJECT_NAME} + COMMAND cmake -E copy_if_different ${PROJECT_SOURCE_DIR}/build/output/lib/libfetch_drivers.so ${CATKIN_DEVEL_PREFIX}/${CATKIN_GLOBAL_LIB_DESTINATION}/libfetch_drivers.so + COMMAND cmake -E copy_if_different ${PROJECT_SOURCE_DIR}/build/output/lib/libfetch_drivers_odva.so ${CATKIN_DEVEL_PREFIX}/${CATKIN_GLOBAL_LIB_DESTINATION}/libfetch_drivers_odva.so + COMMAND cmake -E copy ${PROJECT_SOURCE_DIR}/build/output/lib/${PROJECT_NAME}/* ${CATKIN_DEVEL_PREFIX}/${CATKIN_GLOBAL_LIB_DESTINATION}/${PROJECT_NAME}/ + COMMAND cmake -E make_directory ${CATKIN_DEVEL_PREFIX}/${CATKIN_GLOBAL_SHARE_DESTINATION}/${PROJECT_NAME} + COMMAND cmake -E copy_if_different ${PROJECT_SOURCE_DIR}/build/output/share/${PROJECT_NAME}/firmware.tar.gz ${CATKIN_DEVEL_PREFIX}/${CATKIN_GLOBAL_SHARE_DESTINATION}/${PROJECT_NAME}/ +) + +################################### +## catkin specific configuration ## +################################### +## The catkin_package macro generates cmake config files for your package +## Declare things to be passed to dependent projects +## INCLUDE_DIRS: uncomment this if your package contains header files +## LIBRARIES: libraries you create in this project that dependent projects also need +## CATKIN_DEPENDS: catkin_packages dependent projects also need +## DEPENDS: system dependencies of this project that dependent projects also need +catkin_package( +# INCLUDE_DIRS include +# LIBRARIES fetch_binary_drivers +# CATKIN_DEPENDS other_catkin_pkg +# DEPENDS system_lib +) + +########### +## Build ## +########### + +############# +## Install ## +############# + +install( + FILES build/output/lib/libfetch_drivers.so build/output/lib/libfetch_drivers_odva.so + DESTINATION ${CATKIN_PACKAGE_LIB_DESTINATION} +) + +install( + DIRECTORY build/output/lib/fetch_drivers + DESTINATION ${CATKIN_PACKAGE_LIB_DESTINATION} + PATTERN "build/output/lib/fetch_drivers/*" + PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ + GROUP_EXECUTE GROUP_READ + WORLD_EXECUTE WORLD_READ +) + +install( + FILES build/output/share/${PROJECT_NAME}/firmware.tar.gz build/output/share/${PROJECT_NAME}/laser_filters.xml + DESTINATION ${CATKIN_PACKAGE_SHARE_DESTINATION} +) diff --git a/fetch_binary_drivers/Makefile.tarball b/fetch_binary_drivers/Makefile.tarball new file mode 100644 index 0000000..1988c2f --- /dev/null +++ b/fetch_binary_drivers/Makefile.tarball @@ -0,0 +1,19 @@ +all: binary_driver + +# TODO: There are some more things to automate. +DRIVER_VERSION = 0.8.0 +TARBALL = build/fetch-drivers-0.8.0.tar.gz +TARBALL_URL = http://packages.fetchrobotics.com/binaries/fetch-drivers-0.8.0.tar.gz +SOURCE_DIR = build/output +MD5SUM_FILE = fetch-drivers-0.8.0.tar.gz.md5sum +UNPACK_CMD = tar zxvf +include $(shell rospack find mk)/download_unpack_build.mk + +binary_driver: $(SOURCE_DIR)/unpacked + echo "binary driver built in: " $(SOURCE_DIR) + +clean: + -rm -rf $(SOURCE_DIR) + +wipe: clean + -rm -rf build diff --git a/fetch_binary_drivers/README.md b/fetch_binary_drivers/README.md new file mode 100644 index 0000000..deb9ff9 --- /dev/null +++ b/fetch_binary_drivers/README.md @@ -0,0 +1,43 @@ +# Fetch Binary Drivers + +This is a public binary version of our drivers and firmware for the Fetch Research Platforms. + +https://fetchrobotics.com/robotics-platforms/ + +We have two Fetch Research Platforms. Commonly known as Fetch and Freight. Fetch is the one with the arm. +The drivers and firmware in this package are for both. + +https://docs.fetchrobotics.com/ + +# Fetch Drivers + +The catkin package inside of this folder is called `fetch_drivers`, not `fetch_binary_drivers`. +This is because we've previously been releasing packages which depend on `fetch_drivers`. +We're just changing how we distribute our drivers. + +# About + +This package should only be needed if you're using one of the Fetch Research Platforms. + +Our goal is to better support our our Fetch Research Platform customers through an improved, more automated build and release process. This will get enable us to get updates out faster. + +We discussed at [ROSCon 2018](https://roscon.ros.org/2018/) in a talk "Hermetic Robot Deployment Using Multi-Stage Dockers" +by @levavakian & @bluryi some of our internal way of doing build/test/deployment using Docker: +[Video](https://vimeo.com/293626218), +[Slides](https://roscon.ros.org/2018/presentations/ROSCon2018_multistage_docker_for_robot_deployment.pdf). + +This public repository, is designed to consume the output of our private `fetch_drivers` repository and enable +Fetch Research Platform users access to the drivers/firmware faster via the official ros packages. + +To create the output of our private package, we have a special build job which runs inside of a docker container to ensure we don't accidentally +pull in any private dependencies, and also doesn't output any of the additional commercial robot drivers. + +Previously, we built our drivers on a private buildbot, and hosted them on our own packages site. +We also had a manually synced mirror of the ros packages. This allowed us to ensure we tested the versions of dependancies which were on our mirror. +The old process was not as automated as we would like. + +We're in the process of testing melodic, and setting up our hosted stable mirror, and documenting the upgrade process to ensure Fetch Research Platform customers have a smooth transition. + +We will announce to our customers when we're officially ready and supporting melodic. + +See https://docs.fetchrobotics.com for more information. diff --git a/fetch_binary_drivers/fetch-drivers-0.8.0.tar.gz.md5sum b/fetch_binary_drivers/fetch-drivers-0.8.0.tar.gz.md5sum new file mode 100644 index 0000000..d9b95ba --- /dev/null +++ b/fetch_binary_drivers/fetch-drivers-0.8.0.tar.gz.md5sum @@ -0,0 +1 @@ +1d283854b2406e1945319a57e660c5ec /tmp/fetch-drivers-0.8.0.tar.gz diff --git a/fetch_binary_drivers/package.xml b/fetch_binary_drivers/package.xml new file mode 100644 index 0000000..b50b7db --- /dev/null +++ b/fetch_binary_drivers/package.xml @@ -0,0 +1,47 @@ + + + fetch_drivers + 0.0.0 + + The public fetch_drivers package is a binary only release. + + fetch_drivers contains both the drivers and firmware for the fetch and freight research robots. + There should be no reason to use these drivers unless you're running on a fetch or a frieght research robot. + This package, is a cmake/make only package which installs the binaries for the drivers and firmware. + + + + Alexander Moriarty + FetchRobotics Open Source Team + + + Proprietary + + + + http://wiki.ros.org/fetch_drivers + https://docs.fetchrobotics.com + https://fetchrobotics.com/robotics-platforms/ + + + + Alexander Moriarty + + + catkin + mk + actionlib + boost + robot_controllers + robot_controllers_interface + rosconsole + roscpp_serialization + roscpp + rostime + urdf + + + + + +