yahboom
HomeTutorialsProduct
Solution
Blog
Online Store
About Us
EN/中文
Store
Jetson Orin NANO Developer Kit📖
01.Get started
  • 01. Learning route
  • 02. Get started quickly
  • 03. System Update Notes
  • 04. Disabling automatic updates and troubleshooting issues
  • 05. Jetson Orin Nano official kit screwdriver instructions
02.Jetson basic course
  • 01.Jetson board introduction
  • 02.Write Jetson original system
  • 03.Installing Jetson environment
  • 04.Backup SSD system
  • 05.Restore initial image system
  • 06.Upgrade to SUPER version (Optional)
  • 07.Write SUPER boot (Must read)
  • 08.SSD expansion
  • 09.Jetpack old system upgraded to Yahboom SUPER factory system
  • 10.Write the system onto your own SSD
03.Basic setting course
  • 01.Basic knowledge
  • 02.Network configuration
  • 03.SSH remote login
  • 04.VNC remote control
  • 05.RDP remote control
  • 06.Remote file transfer
  • 07.Jtop tool
  • 08.Exchange space expansion
  • 09.Use VSCode
  • 10.Use VMware
  • 11.Modify screen resolution
04.GPIO control course
  • 01.GPIO description
  • 02.GPIO library installation
  • 03.GPIO reading
  • 04.GPIO output
  • 05.Serial communication
  • 06.I2C communication
05.Vision basic course
  • 01.CSI camera preview
  • 02.USB camera preview
  • 03.Use Jupyter Lab
  • 04.Use JetCam
06.OpenCV basic course
  • 01.Image reading
  • 02.Image saving
  • 03.Image modification
  • 04.Image scaling
  • 05.Image cropping
  • 06.Image translation
  • 07.Image mirroring
  • 08.Image grayscale conversion
  • 09.Image binarization
  • 10.Image edge detection
  • 11.Add line segments
  • 12.Add rectangles
  • 13.Add circular shape
  • 14.Add ellipses
  • 15.Add polygons
  • 16.Add Text
  • 17.Preview USB camera image
  • 18.Preview CSI camera image
07.Vision advanced course
01.Environment construction
  • 01.TensorFlow
  • 02.PyTorch
  • 03.Torchvision
02.DeepStream development
  • 01.DeepStream environment
  • 02.License plate detection and recognition
  • 03.Parallel multi-model inference
  • 04.Object embedding vector generation
  • 05.Pose recognition
  • 06.NV optical flow anomaly detection
  • 07.Single-view 3D tracking
  • 08.Multi-view 3D tracking
03.NVIDIA TAO toolkit application
  • 01.Traffic scene object detection
  • 02.Person object detection
  • 03.Vehicle brand classification
  • 04.Vehicle model classification
  • 05.License plate detection and recognition
  • 06.Person semantic segmentation
  • 07.Retail product detection and recognition
  • 08.Person feature extraction and matching (ReID)
  • 09.Person action and pose classification
  • 10.Transformer-based person detection
  • 11.3D human skeleton detection
  • 12.LiDAR 3D point cloud detection
04.YOLO11 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
05.Mediapipe development
  • 01.Mediapipe environment
  • 02.Hand detection
  • 03.Face detection
  • 04.Face effects
  • 05.3D object recognition
  • 06.Virtual brush
  • 07.Gesture recognition
  • 08.Finger control
  • 09.Posture estimation
  • 10.Face mask
  • 11.Overall detection
  • 12.Green scene removal(Human)
06.YOLO26 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
07.QR code recognition
  • QR code recognition
08.Docker basic course
  • 01.Docker introduction
  • 02.Docker installation
  • 03.Docker command
  • 04.Docker usage
  • 05.Docker interaction
09.ROS2-Jazzy
01.ROS2 basic course
  • 1.Introduction to ROS2
  • 2.ROS2 install Jazzy
  • 3.ROS2 development environment
  • 4.ROS2 workspace
  • 5.ROS2 function package
  • 6.ROS2 node
  • 7.ROS2 topic communication
  • 8.ROS2 service communication
  • 9.ROS2 action communication
  • 10.ROS2 custom interface message
  • 11.ROS2 parameter service case
  • 12.ROS2 meta-function package
  • 13.ROS2 distributed communication
  • 14.ROS2 DDS
  • 15.ROS2 time related API
  • 16.ROS2 common command tools
  • 17.ROS2 rviz2 use
  • 18.ROS2 rqt toolbox
  • 19.ROS2 Launch startup file configuration
  • 20.ROS2 recording and playback tool
  • 21.ROS2 URDF model
  • 22.ROS2 Gazebo simulation platform
  • 23.ROS2 TF2 coordinate transformation
02.ROS2 vision course
  • 01.Camera preview (USB)
  • 02.Camera preview (CSI)
  • 03.Camera calibration (USB)
  • 04.Camera calibration (CSI)
  • 05.AR vision (USB)
  • 06.AR vision (CSI)
10.Large model basic course
01.Offline large model
  • 01.AI large model environment deployment
  • 02.Install large model dialogue platform
  • 03.Meta AI - Llama model
  • 04.Alibaba Cloud - Qwen model
  • 05.Microsoft - Phi-4-mini model
  • 06.DeepSeek - DeepSeek model
  • 07.Alibaba Cloud - Qwen-VL visual multimodal large model
  • 08.Google - Gemma visual multimodal large model
  • 9.Llava visual multimodal large model
  • 10.MiniCPM-V visual multimodal large model
  • 11.High-quality vision-language grounding (LocateAnything)
02.Online large model
  • 01.Tongyi Qianwen large model
  • 02.OpenRouter large model API aggregation platform
11.Large model application practice
01.Voice interaction application
  • 1.Voice interaction hardware connection (Must read)
  • 2.Offline speech to text (ASR)
  • 3.Offline text to speech (TTS)
  • 4.AI large model voice interaction
  • 5.AI large model offline voice assistant
02.Multimodal large model application (Online_Offline large model + Text_Voice interaction)
  • 01.Multimodal visual understand application
  • 02.Multimodal text image application
  • 03.Multimodal video analysis application
  • 04.Multi module visual position application
  • 05.Multimodal table scanning application
  • 06.Multimodal autonomous agent application
12.NVIDIA Isaac ROS course
  • 01.Build Isaac ROS environment
  • 02.Deep segmentation
  • 03.DNN stereoscopic depth
  • 04.Free space segmentation
  • 05.Image distortion processing
  • 06.Image segmentation
  • 07.3D scene reconstruction and mapping
  • 08.Object detection
  • 09.3D attitude estimation
  • 10.Visual SLAM
13.OpenClaw deployment and basic usage
01.OpenClaw deployment and introduction
  • 01.Quick start with the pre-configured environment (Recommended)
  • 02.OpenClaw Deployment
  • 03.OpenClaw WhatsApp Plugin Application
  • 04.OpenClaw WebChat Interaction
  • 05.OpenClaw TUI Interaction
  • 06.OpenClaw Tools Introduction
  • 07.OpenClawGate Gateway User Manual
  • 08.OpenClaw Features Overview
  • 09.OpenClawHub Introduction (Skill Installation)
02.OpenClaw basic application
  • 01.OpenClaw Application - File Management
  • 02.OpenClaw Application - Camera
  • 03.OpenClaw Application - Browser Control
  • 04.OpenClaw Application - Script Execution
  • 05.OpenClaw Application - AI Programming (Peripheral & GPIO Control)
  • 06.OpenClaw Application - Dedicated AI Assistant
  • 07.OpenClaw Web Search Capability Configuration
03.NVIDIA official Agent Skills application
  • 01.AI-assisted development with VS Code or Cursor
  • 02.Jetson device skills
  • 03.Jetson BSP custom agent skills
14.OpenClaw advanced development
01.Preparation Before Use
  • 01.Peripheral Hardware Configuration
  • 02.OpenClaw API-KEY Configuration
  • 03.OpenClaw Model Switching
  • 04.OpenClaw Prompts
  • 05.AI Voice Interaction Configuration
  • 06.Three Dialogue Configuration Tests
02.OpenClaw AI Programming Peripheral Control
  • 1. Servo Control
  • 2. RGB Strip
  • 3. OLED Display
  • 4. Temperature and Humidity Sensor
  • 5. Camera Application
  • 6. AI Script Peripheral Control
03.OpenClaw Peripheral Integration Applications
  • 1. Plant Care Assistant
  • 2. AI Calorie Estimation
  • 3. AI Rock Paper Scissors Game
  • 4. AI Pet
  • 5. AI Weather Station
  • 6. Temperature Humidity Dashboard
  • 7. Scheduled Tasks
Download
  • System_File
  • VMFile_BootFile
  • 3D Model File
  • DataSheet
  • Software_Tools
  • Code
  • Manual
Download ZIP

Welcome to Jetson Orin NANO Developer Kit repository

15.ROS2 time related API

15. ROS 2 Time-Related API

1. Introduction to Time-Related APIs

The time-related APIs in ROS 2 include Rate, Time, Duration, and operations between Time and Duration, which are explained separately below.

  • First, create a package to store the relevant program files

ros2 pkg create learning_time --build-type ament_python --dependencies rclpy

2. create_rate

ROS 2 also provides the create_rate function, a tool used for controlling the loop execution frequency. Its core function is to make a piece of code execute periodically at a fixed frequency. Rate guarantees the stability of the loop execution frequency by controlling the "sleep time" of the loop. Remember that Rate generally cannot be used directly in the main thread, otherwise it will permanently block callback events. It is generally only used in programs with multi-threaded callbacks or in child threads.

Specific working principle:

  1. Record the time when each loop starts;

  2. Execute the code inside the loop;

  3. Calculate the difference between the actual elapsed time of the current loop and the "target interval time";

  4. Automatically sleep for the corresponding difference time, ensuring that the interval from the start of one loop to the start of the next loop is strictly equal to the "target interval" (such as 100 milliseconds).

Although both Rate and Timer can implement periodic execution, their applicable scenarios are different:

FeatureRateTimer
Implementation methodBased on active sleep within the loop (blocking the current thread)Based on callback functions (non-blocking, triggered by the ROS 2 event loop)
Applicable scenariosSuitable for loops that need to execute at a fixed frequency within the same thread (such as the main control logic)Suitable for periodic tasks that need asynchronous execution (without blocking the main thread)
FlexibilityThe flow can be controlled directly within the loop (such as exiting with break)Callback execution needs to be controlled through flags or other methods
  • The following is the basic usage of Rate, implementing a loop that executes 2 times per second:

    • Create a new file rate_demo.py in the package

​x
import rclpy
from rclpy.node import Node
import threading

class RateExampleNode(Node):
    def __init__(self):
        super().__init__("rate_example_node")
        self.get_logger().info("Rate example node started")

    def run_loop(self):
        # Use the node's create_rate() to create a 2Hz Rate
        rate = self.create_rate(2)
        
        count = 0
        try:
            while rclpy.ok():
                self.get_logger().info(f"Loop executed {count} times")
                count += 1
                rate.sleep()  # Sleep until the next cycle (0.5 seconds)
        except KeyboardInterrupt:
            self.get_logger().info("Loop interrupted")

def main(args=None):
    rclpy.init(args=args)
    node = RateExampleNode()
    
    # Create a thread to run the loop (avoid blocking the main thread)
    loop_thread = threading.Thread(target=node.run_loop)
    loop_thread.start()
    
    # The main thread executes spin to keep the ROS 2 node running
    try:
        rclpy.spin(node)
    except KeyboardInterrupt:
        pass
    finally:
        loop_thread.join()  # Wait for the thread to end
        node.destroy_node()
        rclpy.shutdown()

if __name__ == "__main__":
    main()
    
  • Configure the corresponding setup.py configuration file, and add the following to console_scripts

xxxxxxxxxx
'rate_demo=learning_time.rate_demo:main'

image-20250905155834618

  • Compile the package

xxxxxxxxxx
colcon build --packages-select learning_time

image-20250905155916058

  • Refresh the workspace environment and run the node

xxxxxxxxxx
 source ./install/setup.bash
xxxxxxxxxx
ros2 run learning_time rate_demo

image-20250905155949678

3. Timer Application

  • Timer is used to create a timer that triggers at a fixed time to execute some periodic tasks

  • Example: Create two timers. One executes once every 1 second and prints the number of executions, and the other executes once every 0.5 seconds and prints the current time

  • Create a new program file Timer_demo.py

xxxxxxxxxx
import rclpy
from rclpy.node import Node

class TimerDemoNode(Node):
    def __init__(self):
        super().__init__('timer_demo_node')
        
        # Counter, used to demonstrate the number of timer executions
        self.counter = 0
        
        # Create a timer: execute the callback function once every 1 second
        self.timer = self.create_timer(1.0, self.timer_callback)
        
        # Create a faster timer: execute once every 0.5 seconds
        self.fast_timer = self.create_timer(0.5, self.fast_timer_callback)
        
        self.get_logger().info("Timer node has started")

    def timer_callback(self):
        """1-second timer callback function"""
        self.counter += 1
        current_time = self.get_clock().now()
        
        # Print the current time and the counter value
        self.get_logger().info(
            f"[1-second timer] Execution {self.counter}, current time: {current_time.seconds_nanoseconds()}"
        )

    def fast_timer_callback(self):
        """0.5-second timer callback function"""
        # Print the current timestamp (nanoseconds)
        self.get_logger().info(
            f"[0.5-second timer] Current timestamp: {self.get_clock().now().nanoseconds}"
        )

def main(args=None):
    # Initialize ROS 2
    rclpy.init(args=args)
    
    # Create the node
    node = TimerDemoNode()
    
    # Run the node
    rclpy.spin(node)
    
    # Shut down ROS 2
    node.destroy_node()
    rclpy.shutdown()

if __name__ == '__main__':
    main()

  • Configure the corresponding setup.py configuration file, and add the following to console_scripts

xxxxxxxxxx
'Timer_demo=learning_time.Timer_demo:main'

image-20250905160115901

  • Compile the package

xxxxxxxxxx
colcon build --packages-select learning_time

image-20250905155916058

  • Refresh the workspace environment and run the node

xxxxxxxxxx
source ./install/setup.bash
xxxxxxxxxx
ros2 run learning_time Timer_demo

image-20250905160239330

  • The timer fires at the configured interval and prints the corresponding log in its callback function

4. Getting the Current Time with get_clock

  • The get_clock function can be used to obtain the clock object, and then the () method is used to obtain the current time

  • Create a new program file get_clock_demo.py and fill in the following example program:

xxxxxxxxxx
import rclpy
from rclpy.node import Node
from rclpy.time import Time

class TimeExampleNode(Node):
    def __init__(self):
        super().__init__("time_example_node")
        
        # Get the clock object of the node (the system clock is used by default)
        self.clock = self.get_clock()
        
        # Get the current time (returns a Time object)
        current_time = self.clock.now()
        self.get_logger().info(f"Current time: {current_time}")

def main(args=None):
    rclpy.init(args=args)
    node = TimeExampleNode()
    rclpy.spin_once(node)  # Run the node once
    node.destroy_node()
    rclpy.shutdown()

if __name__ == "__main__":
    main()
  • Configure the corresponding setup.py configuration file, and add the following to console_scripts

xxxxxxxxxx
'get_clock_demo=learning_time.get_clock_demo:main'

image-20250905160541502

  • Compile the package

xxxxxxxxxx
colcon build --packages-select learning_time

image-20250905155916058

  • Refresh the workspace environment and run the node

xxxxxxxxxx
 source ./install/setup.bash
xxxxxxxxxx
ros2 run learning_time get_clock_demo

image-20250905160631573

5. Time and Duration

  • The Time class is used in ros to represent a specific time point (such as "2023-10-01 12:00:00"), and is usually used to mark the moment when an event occurs.

  • The Duration class represents the interval between two time points (such as "5 seconds"), and is used to calculate the time difference or delay.

  • Example: Time and Duration application

  • Create a new program file TimeDuration_demo.py

xxxxxxxxxx
import rclpy
from rclpy.time import Time
from rclpy.duration import Duration

def main():
    rclpy.init()
    node = rclpy.create_node("time_opt_node")
   
    # Usage of the time class, creating a 'time point, moment'
    time1 = Time(seconds=10)
    time2 = Time(seconds=4)
    # Usage of the Duration class, creating a 'duration, a period of time'
    duration1 = Duration(seconds=3)
    duration2 = Duration(seconds=5)
          
    # Moments can be compared
    node.get_logger().info("time1 >= time2 ? %d" % (time1 >= time2))
    node.get_logger().info("time1 < time2 ? %d" % (time1 < time2))
    
    # Time periods and moments can be operated on mathematically
    t3 = time1 + duration1
    t4 = time1 - time2    
    t5 = time1 - duration1

    node.get_logger().info("t3 = %d" % t3.nanoseconds)
    node.get_logger().info("t4 = %d" % t4.nanoseconds)
    node.get_logger().info("t5 = %d" % t5.nanoseconds)

    # Time periods can be compared
    node.get_logger().info("-" * 80)
    node.get_logger().info("duration1 >= duration2 ? %d" % (duration1 >= duration2))
    node.get_logger().info("duration1 < duration2 ? %d" % (duration1 < duration2))

    rclpy.shutdown()

if __name__ == "__main__":
    main()
  • Configure the corresponding setup.py configuration file, and add the following to console_scripts

xxxxxxxxxx
'TimeDuration_demo=learning_time.TimeDuration_demo:main'

image-20250905160751388

  • Compile the package

xxxxxxxxxx
colcon build --packages-select learning_time

image-20250905155916058

  • Refresh the workspace environment and run the node

xxxxxxxxxx
 source ./install/setup.bash
xxxxxxxxxx
ros2 run learning_time TimeDuration_demo

image-20250905160840013

  • This example proves that mathematical operations can be performed on time points and time periods, allowing us to flexibly query and operate on data of different timestamps

 

 

 

ROS2 DDS
ROS2 common command tools

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文