Skip to content
A library for real-time robot control.
Branch: master
Clone or download
jlgdcadsk
jlgdcadsk ## BUILD 1430
- Add `wobj` code option for ABB driver.
- Add quick conversion utility which I will totally revert...
Latest commit cd8d8af Jun 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Docs Refactoring Nov 13, 2017
assets README Nov 21, 2018
dist # v0.8.9 Feb 27, 2019
docs Revisions is now the `CHANGELOG Aug 3, 2018
src ## BUILD 1430 Jun 18, 2019
.gitignore
CHANGELOG.md ## BUILD 1430 Jun 18, 2019
LICENSE.md More refactoring and project structuring Aug 4, 2017
README.md README Dec 20, 2018

README.md

Machina.NET

DOI

Machina is a .NET library for action-based real-time control of mechanical actuators.

Or in more human terms, it allows you to talk to a robot and tell it what to do.

Machina simplifies all the hassle of connecting to a mechanical controller, writing programs in platform-specific languages and managing the asynchronous communication between a machine and a connected application, by providing a human-relatable API of Actions, unified for all the different devices.

Machina was formerly known as BRobot.

Disclaimer

Working with robots is dangerous. Robotic actuators are very powerful machines, but for the most part extremely unaware of their environment; if it collides with something, including yourself, it will not detect it and try to keep going, posing a threat to itself and the operators surrounding it. This is particularly relevant when running in 'automatic' mode, where several security measures are bypassed for the sake of performance.

When using robots in a real-time interactive environment, please make sure:

  • You have been adequately trained to use that particular machine,
  • you are in good physical and mental condition,
  • you are operating the robot under the utmost security measures,
  • you are following the facility's and facility staff's security protocols,
  • and the robot has the appropriate guarding in place, including, but not reduced to, e-stops, physical barriers, light curtains, etc.

Machina is in a very early stage of development. You are using this software at your own risk, no warranties are provided herewith, and unexpected results/bugs may arise during its use. Always test and simulate your applications thoroughly before running them on a real device. The author/s shall not be liable for any injuries, damages or losses consequence of using this software in any way whatsoever.

Hello World

Assuming your computer is connected to a real or virtual robotic arm, here is a simple .NET program that traces a vertical 50 x 50 mm square:

// Load assembly
using Machina;

// Instantiate a new Robot object
Robot bot = new Robot();

// Do real-time streaming
bot.Mode("stream");

// Connect to the controller and start running
bot.Connect();
bot.Start();

// Display a message on the handheld pendant
bot.Message("Hello world!");

// Move it to positive XYZ octant, face front and trace the square
bot.SpeedTo(100);
bot.PrecisionTo(2);
bot.MoveTo(300, 300, 300);
bot.Rotate(0, 1, 0, -90);
bot.Move(0, 0, 50);
bot.Move(0, 50, 0);
bot.Move(0, 0, -50);
bot.Move(0, -50, 0);

// ... let the robot complete these actions before shutting down

// kthxbye
bot.Disconnect();

Documentation and Reference

Machina is its infancy, and rapid changes are happening with every commit! Your most reliable and up-to-date source of documentation is probably the code itself, and the comments within.

A full set of tutorials and associated projects can be found here:

MACHINA TUTORIALS

Playlist: https://www.youtube.com/playlist?list=PLvxxYImPCApXj3tHVKmpTS_AuMPngnA47

Instructions on how to setup your machine to work with the Machina framework can be found here: https://www.youtube.com/playlist?list=PLvxxYImPCApUffcv_KtdR-sQydA4O4CPH.

The following documentation is very outdated, and lot of things have changed since then. To learn how to start using Machina, and examples of some of its features, please take a look at the Walkthrough page.

Documentation on Machina's API can be found on the Reference.

Related Projects

Machina comes with a bunch of sample projects that may help you understand its possibilities. Take a look at them, and please don't blame me if they broke during development... 😅

A playlist of projects built by the community with different Machina flavors: https://www.youtube.com/playlist?list=PLvxxYImPCApXZ-yBCUtGzVWb2ZhduaSXR

Here are some videos of things you can do with Machina:

There are other projects that use Machina at their core:

Current Limitations

As of v0.2.5, Machina works for the following robotic arms in different degrees of robustness:

ABB:    [=========  ]  (tested offline, wip online)
KUKA:   [==         ]  (untested offline, wanna try?)
UR:     [=====      ]  (pseudo-tested offline)

Other devices are currently under active development. Much of the development has focused on making the best of what Machina can do, rather than fixing what it can't yet. There are several known limitations:

  • No forward/inverse kinematics solvers. This means that robotic programs coming out of Machina include no arm configurations, and it is up to the controller to decide them. It also means that for motion actions, switching from Joints to any Move action and vice versa requires an absolute action first, which can then be followed by any relative actions of the same kind.
  • Closing Machina applications without properly disposing COM objects causes ABB controllers to silently reject variable subscriptions. Remember to always properly Disconnect, and if failed to do so... you may have to restart the machine.
  • Many, many other things that you will discover along the way ;)

Contribute

Machina is an open-source project, with a lot of room for improvement and collaboration. Furthermore, its internal modular architecture is designed to allow developers to implement their own drivers and compilers in a very straightforward way. If you would like to use Machina to control some obscure Basic-based parallel robot, ping me and I will explain you how. A proper collaboration page should be up sometime soon...

Acknowledgments

The development of Machina was sponsored by Autodesk, Inc, as part of a summer research residency project in Boston, 2016. Please take a look at the detailed list of acknowledgments

Machina was created and is maintained by Jose Luis Garcia del Castillo.

License

MIT License

You can’t perform that action at this time.