Jackal RS (Humble) ================== .. image:: media/pictures/jkl_rs/jkl_rs.webp :width: 100% :align: center Getting Started --------------- To start-up the Jackal, the `instructional video playlist `__ can be used which details the opening and use of the Jackal. Platform Overview ----------------- Jackal is a durable, lightweight, and fast unmanned ground robot designed for rapid prototyping and research purposes. It comes equipped with an onboard computer, as well as essential IMU and GPS capabilities. Standard perception tools are available, featuring URDF, simulator integration, and demonstration applications. Data Sheets ----------- - `Jackal Data Sheet `__ Documentations -------------- - `Jackal Docs `__ Robot Interface --------------- Instructions for interfacing with the robot using **Ubuntu 22.04** and **ROS2 Humble**. .. important:: This procedure should be followed after reading the manuals for the Clearpath Jackal. Furthermore, all of the Jackal’s functionality can be verified via the tutorials by Clearpath. Instructions for set up can be found at `Jackal Docs `__ . +--------------------------------------------+--------------------------------------------+ |.. image:: media/pictures/battery-view.png |.. image:: media/pictures/user-tray.png | | :width: 50% | :width: 50% | | :align: center | :align: center | +--------------------------------------------+--------------------------------------------+ 1. Open the latch 2. Unscrew the user tray 3. Connect ethernet cable .. note:: The Ethernet port at the back of the Jackal can be utilized for setting up communication via LAN. Static Network Connection ~~~~~~~~~~~~~~~~~~~~~~~~~ For the first time, one needs to connect through a **LAN** cable to configure the robot’s network. To create a static connection in your PC (not the robots), in Ubuntu go to Settings → **Network** then click on **+** and create a new connection. 1. Change the connection to **Manual** in the **IPv4** settings. 2. Set the **Address** IP as **192.168.131.51** and the **Netmask** as 24. 3. Click save and restart your network. .. figure:: media/pictures/jackal_lan.jpeg :width: 100% :align: center | After a successful connection, check the host’s local IP by typing in the Host PC’s terminal: .. code:: bash ifconfig Now, ping the robot: .. code:: bash ping 192.168.131.1 Access the robot via SSH: .. code:: bash ssh -X administrator@192.168.131.1 The default password is: .. code:: bash mybotshop Jackal IP Addresses ~~~~~~~~~~~~~~~~~~~ +------------------+-----------------------+------------+ | Device | IP Address | Password | +==================+=======================+============+ | Jackal Main PC | 192.168.131.1 | mybotshop | +------------------+-----------------------+------------+ .. note:: Sometimes other networks can cause disruptions when connecting to the Jackal. It is best to have only your connection to the robot active and all others inactive. Quick-Start ----------- Powering on the Jackal ~~~~~~~~~~~~~~~~~~~~~~ .. image:: media/pictures/jackal_power.webp :width: 100% :align: center | Press the power button on the front of the Jackal. It has the power symbol as displayed. PS4 Controller ~~~~~~~~~~~~~~ .. image:: media/pictures/ps4.png :width: 100% :align: center | 1. **PS4 button** is to power on the controller. 2. **L1** is the dead man’s switch for slow speed. 3. **R1** is the dead man’s switch for high speed. 4. **LJ** is to move in x direction. Digital Twin (RVIZ2) ~~~~~~~~~~~~~~~~~~~~ To visualize the Jackal, you can run: .. code:: bash ros2 launch jkl_viz view_robot.launch | .. figure:: media/pictures/jkl_rs/jkl_dpcd.png :width: 100% :align: center **Jackal Depth Point Clouds** | .. figure:: media/pictures/jkl_rs/jkl_dimg.png :width: 100% :align: center **Jackal Depth Images** | ROS2 Drivers — MBS ------------------ The ROS2 drivers mentioned below are all automatically started when launching the **system** launch file. These drivers further expand on the functionality for interfacing as well as for independent component checking. .. ROS2 Driver — Ouster .. ~~~~~~~~~~~~~~~~~~~~ .. The Ouster is on by default from the startup job and it corresponds to the jkl_lidars/launch/include/ouster.launch.py. .. .. code:: bash .. sudo service mbs-ouster status ROS2 Navigation --------------- Navi2 — Odom Navigation ~~~~~~~~~~~~~~~~~~~~~~~ Navigate in the global frame of **odom** .. code:: bash ros2 launch jkl_nav2 odom_navi.launch.py Odom Based Navigation: After launching the drivers and commands, providing a 2D navigation goal in RViz initiates the navigation process. The brown arrow indicates the 2D navigation goal, while the small orange line represents the global planner and the green arrows depict the local planner. The green box surrounding the robot signifies the bounding box. In the map, blue areas represent the local cost map, and the grey area corresponds to the global cost map ROS2 Information ~~~~~~~~~~~~~~~~ 1. **ROS DOMAIN ID:** 0 2. **RMW Middleware:** rmw fastrtps cpp Caution ------- • Please read the instruction manuals pertaining to **Clearpath Jackal** and **Universal Robots UR5e** before operating the robot. • Always be vigilant and remain close to the emergency stop buttons when the robot is in operation. Known Issues ~~~~~~~~~~~~ ... Frequently Asked Questions ~~~~~~~~~~~~~~~~~~~~~~~~~~ ... Autonomous Mobile Robot Safety Guidelines ----------------------------------------- When deploying autonomous mobile robots, prioritizing safety procedures is essential to prevent accidents and ensure secure operations. The following guidelines outline key safety measures when working with an autonomous mobile robot: Work Area Safety ~~~~~~~~~~~~~~~~ • Maintain a clean and well-lit work area. Cluttered or poorly illuminated spaces can impede the proper functioning of sensors and navigation systems. • Avoid operating autonomous mobile robots in explosive atmospheres, such as areas with flammable liquids, gases, or dust. The robot’s components may pose a risk in such environments. • Keep bystanders and unauthorized personnel at a safe distance during robot operation to prevent interference with autonomous navigation. Electrical Safety ~~~~~~~~~~~~~~~~~ • Ensure the robot’s power system adheres to electrical safety standards. Regularly inspect and maintain power components to prevent malfunctions. • Implement mechanisms to protect the robot from adverse weather conditions, such as rain or wet environments. • Regularly inspect power cables and connections and replace damaged components promptly to minimize the risk of electrical issues. Navigation Safety ~~~~~~~~~~~~~~~~~ • Implement obstacle detection and avoidance systems to prevent collisions with objects, people, or other robots. • Define and enforce safety zones within the robot’s operational area to minimize the risk of unintended interactions with personnel or other equipment. • Regularly calibrate and test the robot’s navigation sensors and systems to ensure accurate and reliable performance. Emergency Response ~~~~~~~~~~~~~~~~~~ • Install an emergency stop mechanism to quickly halt the robot’s operation in case of unforeseen circumstances or emergencies. • Clearly mark and communicate emergency stop locations throughout the robot’s operational area. • Conduct regular emergency response drills to ensure personnel are familiar with procedures for handling unexpected situations. Data Security and Privacy ~~~~~~~~~~~~~~~~~~~~~~~~~ • Implement robust cybersecurity measures to protect the robot’s control systems and data from unauthorized access or manipulation. • Ensure compliance with privacy regulations when collecting, storing, or transmitting data captured by the robot’s sensors. Human Interaction Safety ~~~~~~~~~~~~~~~~~~~~~~~~ • Integrate sensors and communication systems to detect and respond to the presence of humans in the robot’s vicinity. • Clearly communicate the robot’s operational status and intentions using visual and audible signals to alert nearby individuals. • Establish protocols for safe human-robot collaboration, especially in shared workspaces. Residual Risks ~~~~~~~~~~~~~~ Despite the implementation of safety measures, certain residual risks may persist. These include: • Impairment of sensor functionality. • Risk of collisions in crowded or dynamic environments. • Cybersecurity vulnerabilities. • Unintended human interactions due to unforeseen circumstances. Autonomous Mobile Robots (AMR) are advanced technologies that require correct usage to avoid accidents and ensure a secure environment. Learn and follow the proper procedures diligently; prioritize both quality and safety.