Skip to content

Grasshopper interface for Funken Serial Protocol Toolkit

License

Notifications You must be signed in to change notification settings

ar0551/GhFunken

Repository files navigation

Funken logo

GhFunken

Grasshopper interface (GPL) to the Funken Serial Protocol Toolkit.

GhFunken is a Grasshopper plug-in that interfaces to the Funken Serial Protocol Toolkit. It offers classes to initiate communication with Funken-Enabled Arduino devices, send commands and handle responses. On a more general level, it allows to fully remote control an Arduino-based device running Funken from Grasshopper, without need to access directly the Arduino code.

Funken is a Arduino library that enables callbacks on an arduino. It is part of a workflow that simplifies communication between your Arduino and any host, that is able to speak to it via serial messages. For more info on Funken, see the Funken Repository.

GhFunken is build on top of PyFunken and PySerial.

How to use GhFunken

GhFunken acts as an interface to send commands to an Arduino devices running a Funken implementation. Hence, to work properly, GhFunken assumes you kwow what protocol is defined in the Funken implementation running on the Arduino. For more details on how to define your own protocol using Funken, see here. For basic Arduino protocols which are shipped with Funken, see here.

How to install GhFunken

See the Setup and Quickstart instructions in the release files. Installation video COMING SOON!

Examples

Go to the examples folder in this repository and see a more detailed explanation of what is going on inside these examples.

License

GhFunken: Grasshopper interface (GPL) to the Funken Serial Protocol Toolkit.

Copyright (c) 2019, Andrea Rossi

GhFunken is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 3.0 as published by the Free Software Foundation.

GhFunken is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with GhFunken; If not, see http://www.gnu.org/licenses/.

@license GPL-3.0 https://www.gnu.org/licenses/gpl.html

DDU logo

Significant parts of GhFunken have been developed by Andrea Rossi and Alexander Stefas at DDU Digital Design Unit - Prof. Oliver Tessmann - Technische Universität Darmstadt.

References

Stefas, A, Rossi, A and Tessmann, O. 2018. Funken: Serial Protocol Toolkit for Interactive Prototyping, In Proceedings of ECAADE 2018, Lodz. Poland

About

Grasshopper interface for Funken Serial Protocol Toolkit

Resources

License

Stars

Watchers

Forks

Packages

No packages published