3Laws Repository

3Laws' Public Repo

Explore the repo»
Explore the docs»

Introduction

This repository purpose is to offer an easy access to the binary files of the 3Laws products. The first public release of the Supervisor is already available at a beta state. To get more information about this product, please contact support@3lawsrobotics.com

Documentation and Tutorial will soon be available.

Forum

Issues, questions, announcements and general discussions can be created and found at: https://github.com/3LawsRobotics/3laws/discussions.

Releases

Release changelog and files can be found at: https://github.com/3LawsRobotics/3laws/releases. This project adheres to Semantic Versioning, although API compatibility is only guaranteed from version 1.0.0 onward.

Supervisor installation

Interactive Package installation

bash <(curl https://raw.githubusercontent.com/3LawsRobotics/3laws/master/install.sh)

Specific package

You can add arguments after the command to specify the wanted ros and ubuntu version, the desired CPU architecture and non interactive arguments like Always Yes and Force.

• -a <ARCH [amd64, arm64]>
• -v <UBUNTU_DISTRO [18.04, 20.04, 22.04]>
• -r <ROS_DISTRO [iron, humble, galactic, foxy, noetic]>
• -f <Force even if versions doesn't match>
• -y <Always yes>

bash <(curl https://raw.githubusercontent.com/3LawsRobotics/3laws/master/install.sh) [-hyf] [-r <ROS_DISTRO>] [-a <ARCH>] [-v <UBUNTU_VERSION>]

Non interactive

Download the package:

wget https://raw.githubusercontent.com/3LawsRobotics/3laws/master/install.sh

Make it executable:

chmod +x install.sh

Run it with your arguments:

sudo ./install.sh [-hyf] [-r <ROS_DISTRO>] [-a <ARCH>] [-v <UBUNTU_VERSION>]

if -yf -r <ROS_DISTRO> -a <ARCH> -v <UBUNTU_VERSION> specified, the script is non interactive

As an example:

sudo ./install.sh -yf -r foxy -a arm64 -v 20.04

Supervisor uninstall:

This command will fully remove supervisor from your computer

bash <(curl https://raw.githubusercontent.com/3LawsRobotics/3laws/master/uninstall.sh)

ROS2 install from source

For distributions without available ROS2 packages (like debian), you can use the following scrip to build and install ROS2 in a way that is compatible with 3Laws Supervisor: install_ros2.sh.

To use it, you must first install a couple of dependencies:

sudo apt-get update && sudo apt-get install -y --no-install-recommends \
  apt-transport-https \
  apt-utils \
  ca-certificates \
  curl \
  gnupg2 \
  lsb-release \
  software-properties-common \
  wget
curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /etc/apt/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") main" | tee /etc/apt/sources.list.d/ros2.list > /dev/null
sudo apt-get update && sudo apt-get install -y --no-install-recommends \
  build-essential \
  git \
  git-lfs
  python3-colcon-common-extensions \
  python3-colcon-mixin \
  python3-colcon-zsh \
  python3-dev \
  python3-flake8 \
  python3-matplotlib \
  python3-pip \
  python3-pytest-cov \
  python3-rosdep \
  python3-setuptools \
  python3-vcstool
colcon mixin add default https://raw.githubusercontent.com/colcon/colcon-mixin-repository/master/index.yaml
colcon mixin update
colcon metadata add default https://raw.githubusercontent.com/colcon/colcon-metadata-repository/master/index.yaml
colcon metadata update
sudo rosdep init
rosdep update

You can then download and run the script:

bash <(curl https://raw.githubusercontent.com/3LawsRobotics/3laws/master/install_ros2.sh)

Repo maintainer

Thomas Gurriet - tgurriet@3laws.io