Forked from duino but with Arduino's Ethernet power!
This basically transforms your Arduino into a simple (not that robust) REST server. You can interact with Arduino via instantly if you simply connect it to the network. The basic idea behind this simple code is to control Arduino sending simple HTTP post requests with JSON as content.
Right now I've only implemented 4 things (if you have time and are a awesome person fell free to contribute with whatever you can):
- Analog Digital
- Analog Read
- Digital Read
- Digital Digital
In a basic JSON object (as described in here
you'll need to put 3 basic stuff for this to work: command, pin and value.
As explained here since they are integers, you dont need to put
"" arround the value, so don't put them.
To send API calls to your Arduino server you need to use the following URL http://arduino.ip.or.hostame/api
| Command | Type | Behavior |
| 1 | Digital write | Digital write, change the value of the pin depending on the value that you send it |
| 2 | Digital Read | Will read either 1 or 0 on the desired pin and return the result |
| 3 | Analog Write | Will only work on PWM pins, change the value of the output in that pin it can go from 0 to 255 |
| 4 | Analog Read | Reads the value from the A1, A2.. pins (whenever you want to read this don't write pin as A1, write it as 1, 2, 3 ... etc) |
Note: 1, 2, 3 commands only work for digital pins, command 4 will read analog input from the pins labeled A1, A2 ...
A simple example of turning on a LED could be written as (it could be like that or with new lines in between):
{
"command" : 1,
"pin" : 13,
"value" : 1
}
Response
There will be always a resoponse from the server as (JSON encoded) that will have the result that could be either true or false, the pin number that was modified, and the value that was read read or if it wrote something on a pin it will return that value
A response to a request such as the one shown above will look like:
{
"result" : "true",
"pin" : 13,
"value" : 1
}
Copyright (c)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.