LGDXRobot Documentation
website·Indexed 32 days ago
https://lgdxrobot.ukComprehensive documentation for LGDXRobot, including LGDXRobot Cloud for robotics solution management and LGDXRobot2, a mecanum wheel mobile robot. Covers ROS 2 integration, Nav2 simulation (Gazebo and Webots), chassis assembly, MCU reference, and cloud-based automation, navigation, and administration.
What's inside LGDXRobot
- The LGDXRobot2 controller board is an STM32-based MCU designed to support a four-wheel Mecanum chassis, though it can be adapted for other configurations. The board's firmware source code and hardware circuit designs are open source.
Overview of the Map Editor
The Map Editor is a graphical interface used to configure waypoints and traffic rules for a Realm. It allows users to reposition the map via dragging, zoom using the mouse wheel or +/- buttons, and view real-time coordinates at the top center of the screen. Waypoints are represented as blue circles on the map.Overview of LGDXRobot2 ChassisTuner
LGDXRobot2 ChassisTuner is a GUI tool developed with Qt used for testing, validating setup, and fine-tuning the performance of LGDXRobot2 hardware. Due to its dependency on Qt Graphs, this specific component is released under the GPLv3 license.Overview of LGDXRobot2 ROS 2 integration
LGDXRobot2 ROS 2 serves as an integration layer for the ROS 2 ecosystem. It provides support and examples for both physical robot deployments and simulation environments. The source code is hosted on GitLab and GitHub.Overview of LGDXRobot Cloud features
LGDXRobot Cloud is a free orchestration platform for robotics solutions. Key capabilities include:
- Web Management: A browser-based portal for monitoring and managing the cloud instance, supporting mobile devices.
- Third-Party Integration: Provides RESTful APIs to control services from external platforms.
- Notifications: Email alerts for designated users when action is required.
- Multi-Tenancy: Ability to manage robots across multiple rooms or floors from a single instance.
Overview of LGDXRobot2 ROS 2 packages
The LGDXRobot2 ecosystem provides several ROS 2 packages for different functional areas: hardware integration, simulation, visualization, and navigation.lgdxrobot2_agent: LGDXRobot2 hardware integration for ROS 2 lgdxrobot2_bringup: LGDXRobot2 launch files lgdxrobot2_description: LGDXRobot2 visualisation package lgdxrobot2_msgs: LGDXRobot2 ROS 2 interfaces lgdxrobot2_navigation: LGDXRobot2 Nav2 stack integration lgdxrobot2sim_webots: LGDXRobot2 simulation configuration and driver for Webots lgdxrobot2sim_gz: LGDXRobot2 simulation configuration and driver for GazeboOverview of the LGDXRobot2 Agent Node
Thelgdxrobot2_agent_nodeis responsible for integrating LGDXRobot2 hardware into the ROS 2 ecosystem. It serves as the primary interface between the physical robot and the ROS 2 software stack, providing essential data topics required for the Nav2 stack.Overview of LGDXRobot2 hardware and sensors
LGDXRobot2 is a mecanum wheel mobile robot designed for low-cost performance. It features a three-layer laser-cut acrylic chassis (240 mm × 240 mm) and a custom controller board based on the BlackPill MCU and TB6612FNG motor driver, which supports PID control for four motors. For navigation and sensing, it is equipped with an RPLIDAR C1, an ICM20948 9-DOF IMU, and wheel odometry.Overview of LGDXRobot Cloud Management System
LGDXRobot is a free cloud management system for robots, usable for both personal and commercial purposes. It provides a web-based interface accessible via browsers and mobile devices to monitor and manage robots. Key capabilities include:
- Multi-tenant Architecture: Centralized management of robots distributed across different floors or spaces.
- External Integration: Integration with existing automation platforms via RESTful APIs.
- Real-time Notifications: Email alerts to reduce manual monitoring and notify specific users when human intervention is required.
Overview of LGDXRobot Cloud functional modules
LGDXRobot Cloud is divided into three primary functional areas:
- Navigation: Used for fleet management, including the configuration and management of maps, waypoints, and robots.
- Automation: Used for managing automation tasks, workflows, progress, steps, and triggers to third-party systems.
- Administration: Used for system-level settings, including user management, role assignment, access control, and auditing.
Understand LGDXRobot Cloud architecture and message relay
LGDXRobot Cloud functions as a web service that relays messages between a user and a robot running ROS 2. The system relies on the LGDXRobot Cloud Adaptor to act as the intermediary, collecting data from the robot and sending commands back to it. The Robot ROS Node handles the direct integration with the robot hardware.Understand Automation Flows in LGDXRobot
A Flow is a sequence of steps that defines the automation workflow executed by a robot. Flows enable the addition of specific operational steps, such as loading or unloading objects, and can integrate third-party APIs via Triggers.