You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Firmata is a protocol for communicating with microcontrollers from software on a host computer. The [protocol](https://github.com/firmata/protocol) can be implemented in firmware on any microcontroller architecture as well as software on any host computer software package. The arduino repository described here is a Firmata library for Arduino and Arduino-compatible devices. If you would like to contribute to Firmata, please see the [Contributing](#contributing) section below.
5
+
Firmata is a protocol for communicating with microcontrollers from software on a host computer. The [protocol](https://github.com/firmata/protocol) can be implemented in firmware on any microcontroller architecture as well as software on any host computer software package. The Arduino repository described here is a Firmata library for Arduino and Arduino-compatible devices. If you would like to contribute to Firmata, please see the [Contributing](#contributing) section below.
6
6
7
7
##Usage
8
8
@@ -11,7 +11,7 @@ There are two main models of usage of Firmata. In one model, the author of the A
11
11
The second and more common model is to load a general purpose sketch called StandardFirmata on the Arduino board and then use the host computer exclusively to interact with the Arduino board. StandardFirmata is located in the Arduino IDE in File -> Examples -> Firmata.
12
12
13
13
##Firmata Client Libraries
14
-
Most of the time you will be interacting with arduino with a client library on the host computers. Several Firmata client libraries have been implemented in a variety of popular programming languages:
14
+
Most of the time you will be interacting with Arduino with a client library on the host computers. Several Firmata client libraries have been implemented in a variety of popular programming languages:
15
15
16
16
* procesing
17
17
*[https://github.com/firmata/processing]
@@ -57,16 +57,18 @@ Most of the time you will be interacting with arduino with a client library on t
57
57
* Max/MSP
58
58
*[http://www.maxuino.org/]
59
59
60
-
Note: The above libraries may support various versions of the Firmata protocol and therefore may not support all features of the latest Firmata spec nor all arduino and arduino-compatible boards. Refer to the respective projects for details.
60
+
Note: The above libraries may support various versions of the Firmata protocol and therefore may not support all features of the latest Firmata spec nor all Arduino and Arduino-compatible boards. Refer to the respective projects for details.
61
61
62
62
##Updating Firmata in the Arduino IDE - Arduino 1.6.4 and higher
63
63
64
64
If you want to update to the latest stable version:
65
65
66
66
1. Open the Arduino IDE and navigate to: `Sketch > Include Library > Manage Libraries`
67
67
2. Filter by "Firmata" and click on the "Firmata by Firmata Developers" item in the list of results.
68
-
3. Click the Select version dropdown and select the most recent version (not you can also install previous versions)
69
-
4. Click Install.
68
+
3. Click the `Select version` dropdown and select the most recent version (note you can also install previous versions)
69
+
4. Click `Install`.
70
+
71
+
###Cloning Firmata
70
72
71
73
If you are contributing to Firmata or otherwise need a version newer than the latest tagged release, you can clone Firmata directly to your Arduino/libraries/ directory (where 3rd party libraries are installed). This only works for Arduino 1.6.4 and higher, for older versions you need to clone into the Arduino application directory (see section below titled "Using the Source code rather than release archive"). Be sure to change the name to Firmata as follows:
72
74
@@ -104,7 +106,7 @@ will differ slightly: `Contents/Java/libraries/Firmata` (no Resources directory)
104
106
for Arduino 1.0.x vs 1.6.x).
105
107
2. Restart the Arduino application and the latest version of Firmata will be available.
106
108
107
-
*Update the path and arduino version as necessary*
109
+
*Update the path and Arduino version as necessary*
108
110
109
111
###Linux:
110
112
@@ -113,12 +115,16 @@ for Arduino 1.0.x vs 1.6.x).
113
115
for Arduino 1.0.x vs 1.6.x).
114
116
2. Restart the Arduino application and the latest version of Firmata will be available.
115
117
116
-
*Update the path and arduino version as necessary*
118
+
*Update the path and Arduino version as necessary*
117
119
118
120
###Using the Source code rather than release archive (only for versions older than Arduino 1.6.3)
119
121
120
-
Clone this repo directly into the core Arduino libraries directory. If you are using
121
-
Arduino 1.5.x or 1.6.x, the repo directory structure will not match the Arduino
122
+
*It is recommended you update to Arduino 1.6.4 or higher if possible, that way you can clone directly into the external Arduino/libraries/ directory which persists between Arduino application updates. Otherwise you will need to move your clone each time you update to a newer version of the Arduino IDE.*
123
+
124
+
If you're stuck with an older version of the IDE, then follow these keep reading otherwise jump up to the "Cloning Firmata section above".
125
+
126
+
Clone this repo directly into the core Arduino application libraries directory. If you are using
127
+
Arduino 1.5.x or <= 1.6.3, the repo directory structure will not match the Arduino
122
128
library format, however it should still compile as long as you are using Arduino 1.5.7
0 commit comments