This is an unofficial specification that defines a unified interface for language wrappers to expose the ev3dev device APIs.
General Notes
Because this specification is meant to be implemented in multiple languages, the specific naming conventions of properties, methods and classes are not defined here. Depending on the language, names will be slightly different (ex. “touchSensor” or “TouchSensor” or “touch-sensor”) so that they fit the language’s naming conventions.
Some concepts that apply to multiple classes are described as “abstracts”. These abstract sections explain how the class should handle specific situations, and do not necessarily translate in to their own class in the wrapper.
Implementation Notes (important)
int
and string
attributes are read-write files
containing a single value that is representable either as an integer or as a
single word. A string array
attribute is a readonly file that contains
space-separated list of words, where each word is a possible value of some
other string
atribute. And a string selector
attribute is a
read-write file that contains space-separated list of possible values, where
the currently selected value is enclosed in square brackets. Another value
may be selected by writing a single word to the file.Contents
Compatibility table
Spec Version | Fully Supported Kernel Version |
---|---|
v0.9.1 |
v3.16.1-7-ev3dev |
v0.9.2 |
v3.16.7-ckt10-4-ev3dev |
v1.0.0 |
v3.16.7-ckt21-9-ev3dev |