The following is a short description of each folder & file you'll find at the top folder of this repository:
/Arduino Code
- contains Arduino "Sketches" that encapsulate code.Encoder_Read_Test
: Reads Encoder DataMotor_Control_Test
: Tests Individual Motor ControlsMoving_All_Motors
: Comprehensive attempt to control all 4 motors w/ encoders.Joystick_Controlled_Acceleration
: Skeleton file, relating to joystick (controller) inputs.
/config
- an RViz config file, RViz is a 3D visualization tool for ROS (Robot Operating System) that allows us to visualize the components of the robot and its environment. To be used with RViz likerviz2 -d /path/to/view_bot.rviz
/description
- contains XACRO (like XML) files that describe properties of the robot, environment, structured around the mainrobot.urdf.xacro
file.
/encoderExample
- an example of how to use an encoder with an Arduino to measure the rotation and distance traveled by a wheel.
/launch
- contains python files for setup & launch of the ROS2 robot simulation environment.launch_sim
andrsp
(Robot State Publisher).
/worlds
- contains world description files for Gazebo simulations, assisting in the developer's robot simulation setup.
CMakeLists.txt
- this is the project's main CMake file for generating C++ builds, it generates large makefiles which are necessary for running compiled C++ code.
LICENSE.md
- contains a free Apache license.package.xml
- defines the package metadata for ROS.packages.txt
- lists the names of packages that need to be installed viaapt
(Ubuntu/Other OS).README.md
- this file you're reading!SETUP.md
- a quick start guide & message to new devs/users.