Using electronic devices (such as Arduino™)
Even if it is your first time with electronics, you could easily follow this tutorial.
Just buy an Arduino™ Uno kit, and connect a potentiometer like in this tutorial. Note that you do not need to program your Arduino™, just build this simple circuit.
1 / Connect your Electronic Device
Millumin support the following devices :
- Arduino™ Uno
- Arduino™ Uno R4 Wifi
- Arduino™ Mega ADK
- Arduino™ Mega 1280
- Arduino™ Mega 2560
- Teensy 3.1 / 3.2
First of all connect your device to your computer via USB. Then open the device manager (CMD+K)
, go to Electronic
tab and click the +
button to setup an electronic device :
If the device is correctly setup, a green dot will appear.
If is already programmed, you can directly use your device with an Interactions
or a Data-track
in Millumin.
2 / Auto-program your Electronic Device
Millumin offers an interface to program your electronic device with ease.
Click the Auto-program
button to do so, then add the pins you need to use (you can create up to 63 ones) :
The key
is the name of the pin you want to configure. It matches what is written on the electronic card. The type
means the pin has to handle :
- IN : sensor (such as infrared sensor or potentiometer)
- PULLUP : sensor that needs a pull-up resistor (typical use for a push-button)
- OUT : to send a value to your pin (to switch on a LED for example)
- SERVO : for a servo-motor
- OFF : no behaviour (please note that all pin are off by default)
If your device can use Wifi (such as the Arduino™ Uno R4 Wifi), you can receive and send data via Wifi instead of USB. In this case, change the data interface
property at the top, and enter the SSID/password of your Wifi network.
This way, once the device is programmed, you can unplug it from your computer and use it wirelessly. Of course, you still need a power supply for your device.
Please understand that only communication can be done via Wifi, programming your device must be done via USB.
Once you finished the pin configuration, click the upload
button. Millumin will automatically program your electronic device.
When uploading for the first time, Millumin will need to install some dependencies. To do so, it will ask you for administration privileges.
Note that if you are running an old computer, you might need to install Python 2.7.10. If so, Millumin will ask you to download the last version of Python here.
Once the process is finished, your electronic device is ready to work with Millumin.
3 / Debug your Electronic Device
To test it, look at the signal column. Input pins display a dot : if green, the pin is working correctly, if red it is obviously not.
Output pins, like OUT or SERVO, have a test
button that sends data to the pin. If you have connected a LED, it will turn it on then off. For a servo-motor, it will make it rotate.
You could also open the Monitor
/ Logs
to display all values coming from and to the electronic device.
4 / Manually Program your Electronic Device
If you want to manually program your device, we invite you to explore our developer-kit .
Please use those libraries for better work between your device and Millumin.
We encourage you to use the PlatformIO IDE to program your electronic device.
Look at those sample codes to understand how to program your device with the MilluminStream library.
For a better understanding of the library, read : MilluminStream.h