CLEARPATH TurtleBot 4 Lite Скачать руководство пользователя страница 49

Страница: 49 / 153

ROS Tests

The ROS tests use ROS topics and actions to test various system functionality. Test results are
saved to

~/turtlebot4_test_results/Y_m_d-H_M_S

where

Y_m_d-H_M_S

is the date and time of

the test. A rosbag is also recorded for the duration of the test and saved to the same location.

Currently supported tests:

●

Light Ring

: Test the Create® 3 light ring

●

Create® 3 Button

: Test the Create® 3 buttons

●

User LED

: Test the HMI LEDs (TurtleBot 4 model only)

●

User Button

: Test the HMI buttons (TurtleBot 4 model only)

●

Display

: Test the HMI display (TurtleBot 4 model only)

●

Dock

: Test the robots ability to undock and dock.

Running the tests:

ros2 run turtlebot4_tests ros_tests

This will launch a CLI menu where the different tests can be run.

Enter the index of the test and hit enter to start the test. Some tests will run automatically while
others require user input.

Содержание TurtleBot 4 Lite

Страница 1: ...user experience at an affordable price point TurtleBot 4 comes in two models TurtleBot 4 and TurtleBot Lite Both are equipped with an iRobot Create 3 mobile base a powerful Raspberry Pi 4 running ROS...

Страница 2: ...bot 18 Installing ROS2 Galactic on your PC 18 Network Configuration 18 WiFi Setup 19 Find the Raspberry Pi IP on your network 20 Create 3 WiFi Setup 22 TurtleBot 4 Controller Setup 23 Updating the Tur...

Страница 3: ...Node 35 Functions 36 Configuration 36 Buttons 37 Example 38 LEDs 38 Examples 39 Display 42 Menu Control 42 TurtleBot 4 Robot 43 Installation 43 Source installation 43 Base 44 GPIO Interface 44 I2C In...

Страница 4: ...lbox 55 Sensors 55 RPLIDAR A1M8 56 Connecting 56 Installing 56 Running 56 OAK D 56 Connecting 57 Installing 57 Running 57 Create 3 57 Cliff 57 Bumper 58 Wheeldrop 58 IR Proximity 58 Slip and Stall 58...

Страница 5: ...Removing the Create 3 Integration Plate and Shell 75 TurtleBot 4 Lite 76 Attaching Accessories to the Base Unit 76 Removing the Create 3 Integration Plate 77 Accessing the Raspberry Pi Computer 78 Pay...

Страница 6: ...103 Publish the lightring command with a button press 107 Toggle the lightring 108 Your first C Node 109 Creating your first node Python 113 Create a workspace 113 Create a package and node 113 Write...

Страница 7: ...Watch navigation progress in Rviz 136 Navigate Through Poses 136 Code breakdown 136 Set goal poses 138 Navigate through the poses 138 Watch navigation progress in Rviz 138 Follow Waypoints 139 Code b...

Страница 8: ...151 Access the RPi over Ethernet 151 1 Waiting to connect to bluetoothd 152 2 No default controller available 152 Common issues with the user PC 153 1 ros2 command not found 153 2 Create 3 topics are...

Страница 9: ...esearch The TurtleBot 4 is capable of mapping its surroundings navigation autonomously running AI models on its camera and more It uses a Create 3 as the base platform and builds on it with the Turtle...

Страница 10: ...B 3 0 type C ports as well as additional power ports and some Raspberry Pi pins for the user TurtleBot 4 UI Board On top of the UI board sits a RPLIDAR A1M8 360 degree lidar and an OAK D Pro camera Ab...

Страница 11: ...nents for navigation mapping and AI applications The TurtleBot 4 has the same Raspberry Pi 4B which sits in the cargo bay of the Create 3 as well as the same RPLIDAR A1M8 The camera on the TurtleBot 4...

Страница 12: ...ter Raspberry Pi 4B 4GB Raspberry Pi 4B 4GB Maximum linear velocity 0 31 m s in safe mode 0 46 m s without safe mode 0 31 m s in safe mode 0 46 m s without safe mode Maximum angular velocity 1 90 rad...

Страница 13: ...3 0 Type C x4 Programmable LEDs Create 3 Lightring Create 3 Lightring User LED x2 Status LEDs Power LED Motors LED WiFi LED Comms LED Battery LED Buttons and Switches Create 3 User buttons x2 Create...

Страница 14: ...e use this sensor For more information click here OAK D Lite OAK D Lite The OAK D Lite camera from Luxonis uses a 4K IMX214 colour sensor along with a pair of OV7251 stereo sensors to produce high qua...

Страница 15: ...ite has but uses higher resolution OV9282 stereo sensors and adds an IR laser dot projector and an IR illumination LED This allows the camera to create higher quality depth images and perform better i...

Страница 16: ...av2 Documentation https navigation ros org Github https github com ros planning navigation2 SLAM slam_toolbox https github com SteveMacenski slam_toolbox TurtleBot 4 Common package https github com tu...

Страница 17: ...RobotEducation irobot_create_msgs Luxonis OAK D Lite product details https docs luxonis com projects hardware en latest pages DM9095 html OAK D Pro product details https docs luxonis com projects hard...

Страница 18: ...nstructions to install ROS2 Galactic Desktop on your PC Also install useful tools with this command sudo apt update sudo apt install y Build essential cmake git python3 colcon common extensions python...

Страница 19: ...n the first boot the Raspberry Pi will enter AP mode which will allow you to connect to it over WiFi On a PC connect to the Turtlebot4 WiFi network The password is also Turtlebot4 Once connected you c...

Страница 20: ...Raspberry Pi IP on your network The TurtleBot 4 will display its WiFi IP address on the display WiFi IP address on a TurtleBot 4 For the TurtleBot 4 Lite you will need to check the ip topic for the ne...

Страница 21: ...should see the IP address printed out in your terminal periodically Echoing the IP address of a TurtleBot 4 If you are unable to find the IP address with the previous methods you can try to use nmap s...

Страница 22: ...P mode you can call sudo wifi sh a Create 3 WiFi Setup Press both Create 3 button 1 and 2 simultaneously until light ring turns blue Putting the Create 3 in AP mode The Create 3 is now in AP mode Conn...

Страница 23: ...4 comes with an included TurtleBot 4 Controller It is paired in advance with the Raspberry Pi If you wish to manually pair a controller follow these instructions SSH into the TurtleBot 4 sudo bluetoo...

Страница 24: ...er connect MAC_ADDRESS The CLI should report that the controller has been connected and the light on the controller will turn blue Enter exit to exit the CLI Updating the TurtleBot 4 It is recommended...

Страница 25: ...s into a browser You will be taken to the Create 3 webserver Go to the Update tab and click the Update button The robot will automatically download and install the latest firmware Updating the Create...

Страница 26: ...swu ubuntu xxx xxx xxx xxx home ubuntu SSH into the Raspberry Pi and update the Create 3 firmware over USB C sudo create_update sh Create3 G X Y swu or curl X POST data binary Create3 G X Y swu http 1...

Страница 27: ...Raspberry Pi image Warning Installing a new image on the Raspberry Pi will delete any changes you may have made Save your changes before proceeding If you wish to install the latest image onto your ro...

Страница 28: ...d e g turtlebot4_images backup_image Get the SD flash script from turtlebot4_setup and flash the SD card wget https raw githubusercontent com turtlebot turtlebot4_setup galactic scripts sd_flash sh ba...

Страница 29: ...open source under the Apache 2 0 license and is available on the TurtleBot Github There are 2 main computers that run software used by TurtleBot 4 the onboard Raspberry Pi 4 the Create 3 onboard proc...

Страница 30: ...ver ROS2 Galactic and TurtleBot 4 software The latest TurtleBot 4 images can be found here The purpose of the Raspberry Pi 4 is to run the TurtleBot 4 ROS nodes run sensor ROS nodes use bluetooth to c...

Страница 31: ...ges are automatically installed when either of turtlebot4_robot or turtlebot4_simulator is installed Debian installation Individual packages can be installed through apt sudo apt update sudo apt insta...

Страница 32: ...given number of iterations DockServo Command the robot to dock into its charging station DriveArc Command the robot to drive along an arc defined by radius DriveDistance Command the robot to drive a...

Страница 33: ...ping or not StopStatus Whether the robot is currently stopped or not WheelStatus Current PWM readings from the robot s two wheels in addition to whether wheels are enabled WheelTicks Reading from the...

Страница 34: ...h to map yaml file to load default path to turtlebot4_navigation maps depot yaml use_sim_time Use simulation Gazebo clock if true options true false default false param_file Full path to the ROS2 para...

Страница 35: ...ormation that is to be displayed TurtleBot 4 model only ip std_msgs msg String description The IP address of the Wi Fi interface Subscribers battery_state sensor_msgs msg BatteryState description Curr...

Страница 36: ...isplay menu Currently the supported functions are Dock Call the dock action Undock Call the undock action Wall Follow Left Call the wall_follow action with direction FOLLOW_LEFT and a duration of 10 s...

Страница 37: ...in turtlebot4_node provides functionality to all buttons on the robot This includes the Create 3 buttons HMI buttons and TurtleBot 4 Controller buttons The node receives button states from the interf...

Страница 38: ...all Follow Right 3000 controller home Power 5000 Launch the robot with your new configuration ros2 launch turtlebot4_bringup standard launch py param_file home ubuntu turtlebot4_ws example yaml The bu...

Страница 39: ...vary based on battery percentage Battery percentage is received on battery_state topic User LEDs The user LEDs can be set by publishing to the hmi led topic with a UserLed message UserLed message led...

Страница 40: ...User 1 Solid Green Set USER_1 OFF ros2 topic pub hmi led turtlebot4_msgs msg UserLed led 0 color 0 blink_period 1000 duty_cycle 1 0 once...

Страница 41: ...User 1 Off Blink USER_2 red at 1hz with 50 duty cycle ros2 topic pub hmi led turtlebot4_msgs msg UserLed led 1 color 2 blink_period 1000 duty_cycle 0 5 once...

Страница 42: ...y default The menu entries are specified in configuration and are a set of the available functions The 5 menu lines can be overwritten by publishing to the hmi display message with a String message No...

Страница 43: ...nu is already showing the menu entries it will return to showing the first 5 menu entries and the first entry will be highlighted TurtleBot 4 Menu Controls TurtleBot 4 Robot Source code is available h...

Страница 44: ...erry Pi which allows it to read the state of the buttons as well as write to the LEDs and display Publishers hmi buttons turtlebot4_msgs msg UserButton description Button states of the TurtleBot 4 HMI...

Страница 45: ...to write pixels shapes and characters to the display Configuration Warning Do NOT change pin definitions if you are using the standard PCBA or do not know what you are doing The turtlebot4_base_node p...

Страница 46: ...ve running bringup turtlebot4 To read the most recent logs from the service call sudo journalctl u turtlebot4 r To stop the service call sudo systemctl stop turtlebot4 service This will kill all of th...

Страница 47: ...the TurtleBot 4 nodes Lite Launches all necessary nodes for the TurtleBot 4 Lite Standard Launches all necessary nodes for the TurtleBot 4 Config files TurtleBot 4 Controller Configurations for the T...

Страница 48: ...frequency of images from the OAK D colour sensor stereo image Check the frequency of depth images from the OAK D hazard_detection Check for detected hazards imu Check the frequency of IMU messages mo...

Страница 49: ...Test the Create 3 light ring Create 3 Button Test the Create 3 buttons User LED Test the HMI LEDs TurtleBot 4 model only User Button Test the HMI buttons TurtleBot 4 model only Display Test the HMI d...

Страница 50: ...Running the Light Ring test...

Страница 51: ...04 with ROS2 Galactic Debian installation To install the metapackage through apt sudo apt update sudo apt install ros galactic turtlebot4 desktop Source installation To manually install this metapack...

Страница 52: ...e the TurtleBot 4 in Ignition Gazebo Installation Source code is available here Note The turtlebot4_simulator metapackage can be installed on a PC running Ubuntu Desktop 20 04 with ROS2 Galactic Dev T...

Страница 53: ...imulator dependencies repos rosdep install from path src yi Build the packages source opt ros galactic setup bash colcon build symlink install Ignition Bringup The turtlebot4_ignition_bringup package...

Страница 54: ...turtlebot4_node yaml world Which world to use for simulation default depot robot_name What to name the spawned robot default turtlebot4 Running the simulator with default settings ros2 launch turtleb...

Страница 55: ...ignition_toolbox package contains the source code for the TurtleBot 4 HMI node The TurtleBot 4 HMI node acts as a bridge between the turtlebot4_node and ros_ign_bridge to convert the custom TurtleBot...

Страница 56: ...ev rules are installed the RPLIDAR will appear as dev RPLIDAR Otherwise it will be dev ttyUSB0 To check that the USB device exists use the command ls dev RPLIDAR If the device exists the terminal will...

Страница 57: ...launch py Other nodes are available in the DepthAI ROS examples package For example ros2 launch depthai_examples mobile_publisher launch py AI examples are available on the DepthAI github To view the...

Страница 58: ...he robot is lifted off of the ground the spring is decompressed and the wheeldrop hazard is activated IR Proximity The IR proxmity sensors are located on the front of the bumper and are used for the w...

Страница 59: ...t is installed by default with ROS2 and requires a desktop version of Ubuntu to use turtlebot4_desktop provides launch files and configurations for viewing the TurtleBot 4 in Rviz2 View Model To inspe...

Страница 60: ...2 launch turtlebot4_viz view_robot launch py This is useful when mapping or navigating with the robot Rviz2 launched with the View Robot configuration Rviz2 Displays Rviz2 offers support for displayin...

Страница 61: ...Adding Displays in Rviz2...

Страница 62: ...messages On the TurtleBot 4 the RPLIDAR supplies this data on the scan topic LaserScan displayed in Rviz2 Camera The Camera display shows camera images from sensor_msgs msg Image messages The OAK D c...

Страница 63: ...Camera image displayed in Rviz2...

Страница 64: ...the links that make up the robot When you first add the TF display it will show every link that makes up the robot TF with default settings You can uncheck the All Enabled box and then select the lin...

Страница 65: ...comes in This results in maps with high accuracy and detail The downside to synchronous SLAM is that it requires high processing power from the computer running it to keep up with the sensor data Thi...

Страница 66: ...us SLAM ros2 launch turtlebot4_navigation slam_async launch py Saving the map Once you have driven the robot around and generated the map you can use the following call to save the map to your current...

Страница 67: ...default off localization Launch localization with an existing map options true false default false map Path to existing map default path to turtlebot4_navigation maps depot yaml params_file Full path...

Страница 68: ...map and costmaps can be viewed in Rviz2 ros2 launch turtlebot4_viz view_robot launch py Nav2 with SLAM Obstacles that are detected on the map will have a padding around with a radius equivalent to the...

Страница 69: ...e easiest way to set a navigation goal is to use Nav2 Goal in Rviz2 With Nav2 running select the Nav2 Goal tool at the top of Rviz2 and click the location on the map where you would like to navigate t...

Страница 70: ...se the ros_ign_bridge This ROS node translates data from ROS to Ignition and vice versa Installing Ignition Gazebo Requirements Ubuntu 20 04 ROS2 Galactic Recommended PC with dedicated GPU Follow the...

Страница 71: ...TurtleBot 4 in Ignition Gazebo TurtleBot 4 Lite launch ros2 launch turtlebot4_ignition_bringup ignition launch py model lite TurtleBot 4 Lite in Ignition Gazebo...

Страница 72: ...at the top that is easy to modify in order to attach additional sensors and peripherals Warning Modifications to the plate should only be done when it is removed from the robot attempting to modify th...

Страница 73: ...ories to the Base Unit There is space for sensors to be attached to the base unit above the PCBA as well as near the Create 3 User Buttons and inside the Shell To attach accessories above the PCBA mou...

Страница 74: ...low the steps below to remove the PCBA 1 Remove the Top Integration Plate and the four standoffs 2 Disconnect the USB cables connected to the Oak D Camera and the RPLIDAR Feed these cables through the...

Страница 75: ...disconnect the USB C cable and the power harness from the Create 3 base Feed these cables through the slot at the back of the Create 3 Using the tabs on the Create 3 twist the plate counter clockwise...

Страница 76: ...nsors and accessories to be attached to the base unit around the Oak Camera and RPILIDAR To attach accessories to the Create 3 the existing holes in the plate can be used These 3 5mm holes are spaced...

Страница 77: ...cables through the slot opening at the back of the Robot TurtleBot 4 Lite Cable Passthrough 1 Using the tabs on the Create 3 twist the plate counter clockwise until it snaps to unlock it and remove t...

Страница 78: ...RPLIDAR Accessing the Raspberry Pi Computer The Raspberry Pi is found in the rear tray of the robot To fully access the Raspberry Pi disconnect the USB cables connected to the Oak Camera and RPLIDAR...

Страница 79: ...y using a custom plate 2 Add an additional caster wheel to the rear of the Create 3 This will ensure that the payload is fully supported and balanced Detailed instructions as well as design files are...

Страница 80: ...erts of the robot are M4x0 7mm The mounting pattern can be taken from 3D CAD available on Github or it can be transferred from the integration plate itself TurtleBot 4 Mounting Inserts When reassembli...

Страница 81: ...rd The manipulator was mounted such that the COG was further forward and supported by the front caster wheel An external NEC ALM 12V7 Battery 0 9kg was also attached to power the device In this partic...

Страница 82: ...TurtleBot 4 Lite with a NED2 arm...

Страница 83: ...y enabled and 0 46 m s with safety overridden The angular velocity is limited to 1 9 rad s For heavy payloads you may want to limit this further The method to do this will vary based on how you are dr...

Страница 84: ...3 actions you can set velocity limits in the action goal Nav2 To limit velocity during navigation you can create a modified nav2 yaml configuration file Changing parameters such as controller_server...

Страница 85: ...n 1 The VBAT line is fused with a PTC fuse rated at 2A Create 3 Power Adapter left and J7 connector right The Create 3 power adapter also supplies the Raspberry Pi 4 with power and communication throu...

Страница 86: ...n connector and a USB 3 0 Type B cable The USB 3 0 type cable enables communication to 4 USB C ports on the UI board while the ribbon cable passes the 40 GPIO pins of the Raspberry Pi through to the U...

Страница 87: ...iew The TurtleBot 4 comes with an additional User Interface board that expands on the Raspberry Pi 4 functionality to give the user ease of control over the Create 3 robot and Raspberry Pi and to act...

Страница 88: ...PIO numbers are a direct match to the Raspberry Pi 4 GPIO Table 1 2x20 RPi Connector Pinout GPIO Function Pin Pin Function GPIO 3V3_RPi 1 2 5V_RPi GPIO2 USER_PORT 3 4 5V_RPi GPIO3 USER_PORT 5 6 GND GP...

Страница 89: ...e 2X12 Auxiliary connectors Table 2 2x12 User I O Pinout GPIO Function Pin Pin Function GPIO 3V3_RPi 1 2 5V_RPi GPIO2 USER_PORT 3 4 5V_RPi GPIO3 USER_PORT 5 6 GND GND 7 8 USER_PORT GPIO14 3V3_RPi 9 10...

Страница 90: ...ition to these GPIO ports the user has two additional power ports available supplying 3 3V 5V 12V VBAT 14 4V and two grounds each TurtleBot 4 Additional Power Ports The pinout and power ratings can be...

Страница 91: ...50 2 12V 300 350 3 GND 4 5V 500 500 5 3V3 250 300 6 GND Molex Picoblade 6 Pin cable assembly The two connectors are both 6 Pin Molex PicoBlade P N 0532610671 The cable assembly needed to use these con...

Страница 92: ...ords each port is capable of supplying 3A if the others aren t in use or the available 3A is shared amongst ports that are in use The bandwidth for communication is split among 4 dynamically depending...

Страница 93: ...for the other Thus although maximum theoretical power consumption of individual components is mentioned in Table 2 the true limiting factor is the remaining power available to the whole system Table...

Страница 94: ...2 User LEDs 5 0 007 0 17 USER PWR Ports VBAT 0 3 4 32 12 0 3 3 6 5 0 5 2 5 3 3 0 25 0 825 OAK D Lite 5 1 5 OAK D Pro connected to RPi 5 1 5 OAK D Pro connected to UI Board 5 1 5 7 5 RPLIDAR A1M8 5 0 6...

Страница 95: ...plest way to get your robot driving is to use a keyboard application on your PC You can install the teleop_twist_keyboard package on your PC by running the following commands sudo apt update sudo apt...

Страница 96: ...ler s light turns blue If your controller is not paired or connecting refer to the Controller Setup section Note If you are using a TurtleBot 4 Lite the Bluetooth packages will not be installed by def...

Страница 97: ...ic uses a geometry_msgs Twist message to tell the robot what linear and angular velocities should be applied You can manually publish to this topic through the command line by calling ros2 topic pub c...

Страница 98: ...our files For this tutorial we will create a package called turtlebot4_cpp_tutorials with a node called turtlebot4_first_cpp_node source opt ros galactic setup bash cd turtlebot4_ws src ros2 pkg creat...

Страница 99: ...RED find_package rclcpp REQUIRED find_package irobot_create_msgs REQUIRED and add this line under add_executable turtlebot4_first_cpp_node src turtlebot4_first_cpp_node cpp ament_target_dependencies t...

Страница 100: ...eBot4FirstNode Node turtlebot4_first_cpp_node Notice that our class calls the Node constructor and passes it the name of our node turtlebot4_first_cpp_node We can now create our node in the main funct...

Страница 101: ...rface_buttons rclcpp SensorDataQoS std bind TurtleBot4FirstNode interface_buttons_callback this std placeholders _1 private Interface buttons subscription callback void interface_buttons_callback cons...

Страница 102: ...n 1 is pressed Edit the interface_buttons_callback function to look like this Interface buttons subscription callback void interface_buttons_callback const irobot_create_msgs msg InterfaceButtons Shar...

Страница 103: ...ber of packages that you want to build in case you don t want to build all packages in your workspace Now try running the node ros2 run turtlebot4_cpp_tutorials turtlebot4_first_cpp_node When you run...

Страница 104: ...buttons subscription callback void interface_buttons_callback const irobot_create_msgs msg InterfaceButtons SharedPtr create3_buttons_msg Button 1 is pressed if create3_buttons_msg button_1 is_presse...

Страница 105: ...n 0 LED 1 lightring_msg leds 1 red 0 lightring_msg leds 1 blue 255 lightring_msg leds 1 green 0 LED 2 lightring_msg leds 2 red 0 lightring_msg leds 2 blue 0 lightring_msg leds 2 green 255 LED 3 lightr...

Страница 106: ...with whatever colours we want LED 0 lightring_msg leds 0 red 255 lightring_msg leds 0 blue 0 lightring_msg leds 0 green 0 LED 1 lightring_msg leds 1 red 0 lightring_msg leds 1 blue 255 lightring_msg...

Страница 107: ...our lightring publisher Simply call button_1_function inside the interface_buttons_callback Interface buttons subscription callback def interface_buttons_callback self create3_buttons_msg InterfaceBut...

Страница 108: ...he light void button_1_function Create a ROS2 message auto lightring_msg irobot_create_msgs msg LightringLeds Stamp the message with the current time lightring_msg header stamp this get_clock now Ligh...

Страница 109: ...override_system false Publish the message lightring_publisher_ publish lightring_msg Toggle the lights on status lights_on_ lights_on_ Now the Create 3 will regain control of the lightring if we pres...

Страница 110: ...rclcpp SensorDataQoS private Interface buttons subscription callback void interface_buttons_callback const irobot_create_msgs msg InterfaceButtons SharedPtr create3_buttons_msg Button 1 is pressed if...

Страница 111: ...ing_msg leds 4 green 255 LED 5 lightring_msg leds 5 red 0 lightring_msg leds 5 blue 255 lightring_msg leds 5 green 255 Lights are currently on else Disable system override The system will take back co...

Страница 112: ...status bool lights_on_ int main int argc char argv rclcpp init argc argv rclcpp spin std make_shared TurtleBot4FirstNode rclcpp shutdown return 0 Don t forget to build the package again before runnin...

Страница 113: ...tutorial we will create a package called turtlebot4_python_tutorials with a node called turtlebot4_first_python_node source opt ros galactic setup bash cd turtlebot4_ws src ros2 pkg create build type...

Страница 114: ...bot_create_msgs msg import InterfaceButtons LightringLeds import rclpy from rclpy node import Node from rclpy qos import qos_profile_sensor_data Create a class Now that the dependencies are set we can...

Страница 115: ...erface_buttons topic self interface_buttons_subscriber self create_subscription InterfaceButtons interface_buttons self interface_buttons_callback qos_profile_sensor_data Interface buttons subscriptio...

Страница 116: ...self create3_buttons_msg InterfaceButtons Button 1 is pressed if create3_buttons_msg button_1 is_pressed self get_logger info Button 1 Pressed Now every time we receive a message the one interface_bu...

Страница 117: ...to enter any number of packages that you want to build in case you don t want to build all packages in your workspace Now try running the node ros2 run turtlebot4_python_tutorials turtlebot4_first_py...

Страница 118: ...self lightring_publisher self create_publisher LightringLeds cmd_lightring qos_profile_sensor_data Note The Lightring publisher uses the LightringLeds message type Next lets create a function that wi...

Страница 119: ...lightring_msg leds 4 green 255 LED 5 lightring_msg leds 5 red 0 lightring_msg leds 5 blue 255 lightring_msg leds 5 green 255 Publish the message self lightring_publisher publish lightring_msg This fun...

Страница 120: ...tring_msg leds 2 red 0 lightring_msg leds 2 blue 0 lightring_msg leds 2 green 255 LED 3 lightring_msg leds 3 red 255 lightring_msg leds 3 blue 255 lightring_msg leds 3 green 0 LED 4 lightring_msg leds...

Страница 121: ...buttons_callback self create3_buttons_msg InterfaceButtons Button 1 is pressed if create3_buttons_msg button_1 is_pressed self get_logger info Button 1 Pressed self button_1_function Test this out by...

Страница 122: ...stamp self get_clock now to_msg Lights are currently off if not self lights_on_ Override system lights lightring_msg override_system True LED 0 lightring_msg leds 0 red 255 lightring_msg leds 0 blue...

Страница 123: ...ate 3 will regain control of the lightring if we press button 1 again Your first Python Node You have finished writing your first Python node The final py file should look like this from irobot_create...

Страница 124: ...n_1_function self Create a ROS2 message lightring_msg LightringLeds Stamp the message with the current time lightring_msg header stamp self get_clock now to_msg Lights are currently off if not self li...

Страница 125: ...currently on else Disable system override The system will take back control of the lightring lightring_msg override_system False Publish the message self lightring_publisher publish lightring_msg Togg...

Страница 126: ...map Launch SLAM First make sure that the RPLIDAR and description nodes are running on the TurtleBot 4 Then run SLAM It is recommended to run synchronous SLAM on a remote PC to get a higher resolution...

Страница 127: ...drive the robot around the area you wish to map Check out the driving tutorial if you are unsure of how to drive the robot Keep watch of RVIZ as you drive the robot around the area to make sure that...

Страница 128: ...ave_map slam_toolbox srv SaveMap name data map_name This will save the map to your current directory View the map Once the map is saved it will generate a map_name pgm file which can be viewed in an i...

Страница 129: ...tion uses an existing map along with live odometry and laserscan data to figure out the position of the robot on the given map It does not update the map if any changes have been made to the environme...

Страница 130: ...t in as a launch argument For example ros2 launch turtlebot4_ignition_bringup ignition launch py nav true slam off localization true world classroom map classroom yaml Interacting with Nav2 In a new t...

Страница 131: ...the arrow on the map to approximate the position and orientation of the robot Setting the initial pose Publish Point The Publish Point tool allows you to click on a point on the map and have the coor...

Страница 132: ...ool allows you to set a goal pose for the robot The Nav2 stack will then plan a path to the goal pose and attempt to drive the robot there Make sure to set the initial pose of the robot before you set...

Страница 133: ...iour as Nav2 Goal The Nav2 stack is given a pose on the map with which it calculates a path The robot then attempts to drive along the path This example is demonstrated in the depot world of the Turtl...

Страница 134: ...object This will initialise any ROS2 publishers subscribers and action clients that we need rclpy init navigator TurtleBot4Navigator Dock the robot Next we check if the robot is docked If it is not we...

Страница 135: ...e we start sending navigation goals navigator waitUntilNav2Active Note This call will block until Nav2 is ready Make sure you have launched nav bringup in a separate terminal Set the goal pose Now we...

Страница 136: ...Navigate Through Poses behaviour tree The Nav2 stack is given a set of poses on the map and creates a path that goes through each pose in order until the last pose is reached The robot then attempts t...

Страница 137: ...e Set goal poses goal_pose goal_pose append navigator getPoseStamped 0 0 1 0 TurtleBot4Directions NORTH goal_pose append navigator getPoseStamped 1 7 1 0 TurtleBot4Directions EAST goal_pose append nav...

Страница 138: ...d navigator getPoseStamped 1 6 3 5 TurtleBot4Directions NORTH goal_pose append navigator getPoseStamped 6 75 3 46 TurtleBot4Directions NORTH_WEST goal_pose append navigator getPoseStamped 7 4 1 0 Turt...

Страница 139: ...ypoints the robot will plan to reach each waypoint individually rather than planning to reach the last pose by driving through the other poses This example is demonstrated in the depot world of the Tu...

Страница 140: ...avigator getPoseStamped 2 1 6 3 TurtleBot4Directions EAST goal_pose append navigator getPoseStamped 2 0 1 0 TurtleBot4Directions SOUTH goal_pose append navigator getPoseStamped 1 0 0 0 TurtleBot4Direc...

Страница 141: ...s Then we use the Follow Waypoints behaviour to follow those poses This example was run on a physical TurtleBot 4 To run this example start nav bringup on your PC or on the Raspberry Pi ros2 launch tu...

Страница 142: ...createPath if len goal_pose 0 navigator error No poses were given exiting exit 0 Start on dock if not navigator getDockedStatus navigator info Docking before intialising pose navigator dock Set initia...

Страница 143: ...exit 0 Set initial pose and clear costmaps Next we set the initial pose and clear all costmaps We clear costmaps because the 2D Pose Estimate tool is subscribed to by the Nav2 stack and every time we...

Страница 144: ...We finish the example by docking the robot This assumes that the last pose in the created path is near the dock If it is not you can remove this action Creating a path with Rviz Running this example...

Страница 145: ...ncy To check that diagnostics are running properly call ros2 node list You should see a node called turtlebot4_diagnostics Additionally calling ros2 topic list should list topics such as diagnostics d...

Страница 146: ...ndow and a summary of all topics in the All devices section at the bottom Each topic has a status level of OK WARNING ERROR or STALE There is also a more detailed message included as well You can clic...

Страница 147: ...Color camera diagnostics...

Страница 148: ...tests that can be run from CLI to test basic system functions Each test uses a ROS2 topic action or service to perform the action To run Create 3 tests the Create 3 must be connected to the Raspberry...

Страница 149: ...Test results are saved to turtlebot4_test_results Y_m_d H_M_S where Y_m_d H_M_S is the date and time of the test A rosbag is also recorded for the duration of the test and saved to the same location...

Страница 150: ...C port Make sure it is illuminated If the LED is not on then the Raspberry Pi is not powered Check the USB C connection and make sure the Create 3 power adapter board is inserted fully Check for obst...

Страница 151: ...see the Turtlebot4 access point you can connect directly to the RPi using an ethernet cable You may need a USB to Ethernet adapter for your PC Connecting to the TurtleBot 4 over Ethernet The Raspberr...

Страница 152: ...ain run sudo systemctl start bluetooth 2 No default controller available This error occurs if you are attempting to connect a bluetooth device to the Raspberry Pi with sudo bluetoothctl and the hciuar...

Страница 153: ...e If it is connected to WiFi check if you can see Create 3 topics on the Raspberry Pi If topics are visible on the Raspberry Pi ensure that your PC has the following configuration set for CycloneDDS C...

Результаты поиска

Содержание TurtleBot 4 Lite

Отзывы:

Похожие инструкции для TurtleBot 4 Lite

Бренды по названию

Популярные бренды

CLEARPATH TurtleBot 4 Lite, Руководство пользователя

Результаты поиска

Содержание TurtleBot 4 Lite

Отзывы:

Похожие инструкции для TurtleBot 4 Lite

Бренды по названию

Популярные бренды