Getting Started - Quick start
The purpose of Involt is fast and easy prototyping. It's possible to quickly inject hardware interactions into HTML layout while framework take care of communication. Read more about this idea on about page.
If you are familiar with HTML/CSS and Arduino this quick introduction shouldn't take more than 15 minutes.
How to install
The project works on Windows, OS X (On Linux serial should work). For mobile installation on Android go to Mobile page.
- Download Involt
- Download Node-webkit*
- Unpack Involt to Node-webkit main folder
- After opening the app you should see loader with available devices.
- Use app.html for layout (homepage) and involt-basic.ino for arduino code.
*The SDK version of NW is recommended as it contains Chrome Dev Tools and HTML inspector. (Mac version is in NW download section)
What communication methods are supported?
- Serial - desktop
- Bluetooth (2.0/classic) - desktop and mobile
Even if it's HTML based, currently Involt has no IoT online support.
It's as simple as adding HTML element where desired interactions and their parameters are set by CSS classes. Involt will take care of communication with your device but you need to write single line of code inside Arduino sketch for each element.
ard [element] [pin] [parameters]
Read data from Arduino
Send any numeric value to your app with involtSend(pinIndex, value) in your sketch loop.
Always use involt-basic.ino sketch as starting point.
Now add this element to app.html file. After connecting something to pin A0 (knob or anything else) you should see changes in its value. The show element has no other parameters.
Send data to Arduino
With LED connected to pin 5 we use digitalWrite or analogWrite to change its brightness. The numeric values received from App are stored in involtPin[pinIndex].
Sending and receiving can be related to any variable you want - not only pin states. You can use this array to store values for sketch functions.
This button will send PWM value 123 to pin 5 and turn on connected LED.
Similarly you can use HTML inputs (and forms) to work with hardware. The example below uses text strings. Note that pin letter has changed from P to S.
Add the code below to void loop section. When you type "involt" the LED will turn on.
There is more you can do with Involt and it's widely explained in next chapters. Playing with examples is good idea to practice. More things Involt has to offer:
- Triggering functions in app or device.
- Sending strings (with pin S instead of P)
- Use inputs to create form which passes the values to device.
- Add Bluetooth communication for wireless project.
- Pack everything into Phonegap and use same project on Android (with Bluetooth).