How akarshsnair/automatic-floor-cleaning-robot works
This repository is a ROS-based floor-cleaning robot project. Its implemented ROS workflow measures ultrasonic distance, publishes it on the distance topic, and uses received readings to make obstacle-response decisions and drive wheel GPIO. The root-level scripts duplicate the package nodes, while raspberrypi.py combines sensing and movement in a standalone loop. The README also describes path planning, vacuum/mop actuation, and a user interface, but no implementation for those capabilities appears in the provided source tree; those branches are shown as documented but unverified.
Main entry points: raspberrypi.py Standalone loop · src/publisher.py Package publisher · publisher.py Root publisher · subscriber.py Package controller
Components 13
Distance sensing
- Ultrasonic sensor
- Package publisher
catkin_ws/src/ultrasonic_publisher_pkg/src/publisher.py - Root publisher
publisher.py
ROS messaging
- Distance topic
Motion control
- Standalone loop
raspberrypi.py - Package controller
catkin_ws/src/ultrasonic_subscriber_pkg/src/subscriber.py - Root controller
subscriber.py - Motor GPIO
Cleaning capabilities
- Cleaning path
- Vacuum and mop
- User interface
Other components
- Operator
- Raspberry Pi
Connections 14
- Ultrasonic sensor → Package publisher: measures via GPIO
catkin_ws/src/ultrasonic_publisher_pkg/src/publisher.py - Package publisher → Distance topic: publishes distance
catkin_ws/src/ultrasonic_publisher_pkg/src/publisher.py - Ultrasonic sensor → Root publisher: measures via GPIO
publisher.py - Root publisher → Distance topic: publishes distance
publisher.py - Distance topic → Package controller: delivers readings
catkin_ws/src/ultrasonic_subscriber_pkg/src/subscriber.py - Distance topic → Root controller: delivers readings
subscriber.py - Package controller → Motor GPIO: sets wheel GPIO
catkin_ws/src/ultrasonic_subscriber_pkg/src/subscriber.py - Root controller → Motor GPIO: sets wheel GPIO
subscriber.py - Standalone loop → Ultrasonic sensor: reads sensor GPIO
raspberrypi.py - Standalone loop → Motor GPIO: sets wheel GPIO
raspberrypi.py - Operator → User interface: uses controls
README.md - Raspberry Pi → Cleaning path: processes sensor data
README.md - Cleaning path → Motor GPIO: sends movement commands
README.md - Cleaning path → Vacuum and mop: activates cleaning
README.md