一个基于事件驱动、异步的行为状态机库,用于用 C++ 编写的 ROS2 (机器人操作系统) 应用程序
SMACC2 is an event-driven, asynchronous, behavioral state machine library for real-time ROS 2 (Robotic Operating System) applications written in C++, designed to allow programmers to build robot control applications for multicomponent robots, in an intuitive and systematic manner.
| ROS 2 Distro | Branch | Build status | Documentation | Released packages |
|---|---|---|---|---|
| Foxy | foxy |
|||
| Generated Doc | ||||
| SMACC2 | ||||
| Humble | humble |
|||
| Generated Doc | ||||
| SMACC2 | ||||
| Jazzy | jazzy |
|||
| Generated Doc | ||||
| SMACC2 |
NOTE: There are three build stages checking current and future compatibility of the package.
Binary builds - against released packages (main and testing) in ROS distributions. Shows that direct local build is possible.
Uses repos file: src/SMACC2/.github/SMACC2-not-released..repos
Semi-binary builds - against released core ROS packages (main and testing), but the immediate dependencies are pulled from source. Shows that local build with dependencies is possible and if fails there we can expect that after the next package sync we will not be able to build.
Uses repos file: src/SMACC2/.github/SMACC2.repos
Source build - also core ROS packages are build from source. It shows potential issues in the mid future.
Make sure that colcon, its extensions, vcs, and development tools are installed:
sudo apt install python3-colcon-common-extensions python3-vcstool clang-format pre-commitCreate a new ROS 2 workspace if necessary:
export COLCON_WS=~/workspace/jazzy_ws
mkdir -p $COLCON_WS/srcOr just navigate to your workspace source folder:
cd ~/workspace/jazzy_ws/srcClone the repo:
git clone https://github.com/robosoft-ai/SMACC2.gitCheckout the Jazzy branch:
cd ~/workspace/jazzy_ws/src/SMACC2
git checkout jazzyNavigate to the workspace:
cd ~/workspace/jazzy_wsUpdate System:
sudo apt update
sudo apt upgradeSource the workspace:
source /opt/ros/jazzy/setup.bashUpdate dependencies:
rosdep updatevcs import src --skip-existing --input src/SMACC2/.github/SMACC2.jazzy.repos
rosdep install --ignore-src --from-paths src -y -rcolcon build --cmake-args -DCMAKE_BUILD_TYPE=Releasesmacc2 - core library of SMACC2.smacc2_client_library - client libraries for SMACC2, e.g., Navigation2 (nav2z_client), MoveIt2 (moveit2z_client).smacc2_event_generators - ...smacc2_msgs - ROS 2 messages for SMACC2 framework.smacc2_sm_reference_library - libraries with reference implementations of state-machines used for demonstration and testing of functionalities.↓smacc2_state_reactor_library - ...smacc2_performance_tools - ...From it's inception, SMACC2 was written to support the programming of multi-component, complex robots. If your project involves small, solar-powered insect robots, that simply navigate towards a light source, then SMACC2 might not be the right choice for you. But if you are trying to program a robot with a mobile base, a robotic arm, a gripper, two lidar sensors, a gps transceiver and an imu, then you've come to the right place.
The easiest way to get started is by selecting one of the state machines in our reference library, and then hacking it to meet your needs.
Each state machine in the reference library comes with it's own README.md file, which contains the appropriate operating instructions, so that all you have to do is simply copy & paste some commands into your terminal.
If you are looking for a minimal example, we recommend sm_atomic.
If you are looking for a minimal example but with a looping superstate, try sm_three_some.
If you want to get started with the ROS Navigation stack right away, try sm_nav2_test_7.
Operating instructions can be found in each reference state machines readme file.
Happy Coding!
If you are interested in getting involved or need a little support, feel free to contact us by emailing [email protected]
暂无开放 Issues,或尚未同步最近议题。