Acmattson3: Added software stack diagram.

2025-07-07T22:09:04Z

Added software stack diagram.

Acmattson3: Created page with "== LUNATIC Software Stack == Visit the [https://github.com/auroraRoboticsLab/MiningRobot MiningRobot GitHub repository] for more detailed information. The '''"Logically UNcoupled Architecture Technology for Intra-robot Communication" or LUNATIC''' (pronounced lun-AT-ic, like automatic) is our robot control system, built as a loosely coupled set of microservices. LUNATIC is currently the software responsible for controlling the Excahauler robot. The autonomy/ 2025-07-07T22:01:39Z Created page with "== LUNATIC Software Stack == Visit the [https://github.com/auroraRoboticsLab/MiningRobot MiningRobot GitHub repository] for more detailed information. The '''"Logically UNcoupled Architecture Technology for Intra-robot Communication" or LUNATIC''' (pronounced lun-AT-ic, like automatic) is our robot control system, built as a loosely coupled set of microservices. LUNATIC is currently the software responsible for controlling the Excahauler robot. The <code>autonomy/</..." New page == LUNATIC Software Stack == Visit the [https://github.com/auroraRoboticsLab/MiningRobot MiningRobot GitHub repository] for more detailed information. The '''"Logically UNcoupled Architecture Technology for Intra-robot Communication" or LUNATIC''' (pronounced lun-AT-ic, like automatic) is our robot control system, built as a loosely coupled set of microservices. LUNATIC is currently the software responsible for controlling the [[Excahauler]] robot. The <code>autonomy/</code> directory (in the project [https://github.com/auroraRoboticsLab/MiningRobot Github repository]) contains our robot control stack, written in '''C++''' for Linux and running happily on x86 and ARM based robots including the Raspberry Pi or NVIDIA Jetson. See [https://github.com/AuroraRoboticsLab/MiningRobot/blob/master/autonomy/README.txt the README in that directory] for build directions. Using microservices means you can compile, run, and test a single service independently, unlike our previous single monolithic executable the [https://github.com/AuroraRoboticsLab/MiningRobot/blob/master/autonomy/backend/main.cpp backend]. Due to the nature of a robotics control stack, being able to efficiently exchange quickly changing data between modules is crucial. We do this using the new MMAP-based shared file data exchange system, the details of which can be found in the [https://github.com/AuroraRoboticsLab/MiningRobot/blob/master/autonomy/include/aurora/data_exchange.h data_exchange.h] header. The data being exchanged is listed in the [https://github.com/AuroraRoboticsLab/MiningRobot/blob/master/autonomy/include/aurora/lunatic.h lunatic.h] header for the microservices, and [https://github.com/AuroraRoboticsLab/MiningRobot/blob/master/autonomy/nanoslot/include/nanoslot/nanoslot_exchange.h nanoslot_exchange.h] for the Arduino data. == Control Software Stack == A basic manual control setup has autonomy/frontend running on the "pilot" machine, and sending commands to the autonomy/backend running onboard the robot. These commands are sent via UDP broadcast, so they should work anywhere on the same subnet. The backend talks to the Arduinos directly via USB--each Arduino has a "nanoslot ID" that lets nanoboot connect the appropriate slot program to communicate with it. To control the robot, all you need is a backend and the slot programs: put the backend into "backend driver" state, and use WASD to drive the robot. For autonomous robot operations, we rely on a huge variety of microservices, such as the localizer (where is the robot?), path planner (how do we get to the target?), andretti (how do we drive along the path?), vision (what obstacles can we see?), and several other debug tools. This architecture has been incrementally built up since 2013 by a variety of UAF students for the [[Project Archives|NASA Robotic Mining Contest]]. Unless otherwise noted, everything here is public domain. == Get Involved == For details on how build and run this software, see [https://github.com/AuroraRoboticsLab/MiningRobot/blob/master/autonomy/README.txt autonomy/README]. Send a pull request or [[User:Lawlor|contact me (Dr. Orion Lawlor)]] if you have comments or suggestions!

LUNATIC - Revision history

Acmattson3: Added software stack diagram.