Skip to content

Latest commit

 

History

History
executable file
·
248 lines (166 loc) · 9.3 KB

README.md

File metadata and controls

executable file
·
248 lines (166 loc) · 9.3 KB
Raw

Device Bindings

This directory is intended for device bindings, sensors, displays, human interface devices and anything else that requires software to control. We want to establish a rich set of quality .NET bindings to make it straightforward to use .NET to connect devices together to produce weird and wonderful IoT applications.

Our vision: the majority of .NET bindings are written completely in .NET languages to enable portability, use of a single tool chain and complete debugability from application to binding to driver.

Bindings by category

Alphabetical device index can be found here

Analog/Digital converters

Accelerometers

Gas sensors

Light sensor

Barometers

Altimeters

Thermometers

Gyroscopes

Compasses

Lego related devices

Motor controllers/drivers

Inertial Measurement Units

Magnetometers

Liquid Crystal Displays

Hygrometers

Clocks

Sonars

Distance sensors

Passive InfraRed (motion) sensors

Motion sensors

Displays

GPIO Expanders

CAN BUS libraries/modules

Proximity sensors

Touch sensors

Wireless communication modules

PWM libraries/modules

Joysticks

Color sensors

LED drivers

SPI libraries/modules

RFID/NFC modules

Media libraries

Binding Distribution

These bindings are distributed via the Iot.Device.Bindings NuGet package. Daily builds with the latest bindings are available on MyGet. You can also consume the bindings as source.

Contributing a binding

Anyone can contribute a binding. Please do! Bindings should follow the model that is used for the Mcp23xxx or Mcp3xxx implementations. There is a Device Binding Template that can help you get started, as well.

Bindings must:

  • include a .NET Core project file for the main library.
  • include a descriptive README, with a fritzing diagram.
  • include a buildable sample (layout will be described below).
  • use the System.Device API.
  • (Optional) Include a unit test project that DOES NOT require hardware for testing. We will be running these tests as part of our CI and we won't have sensors plugged in to the microcontrollers, which is why test projects should only contain unit tests for small components in your binding.

Here is an example of a layout of a new Binding Foo from the top level of the repo:

iot/
  src/
    devices/
      Foo/
        Foo.csproj
        Foo.cs
        README.md
        samples/
          Foo.Sample.csproj
          Foo.Sample.cs
        tests/   <--  Tests are optional, but if present they should be layed out like this.
          Foo.Tests.csproj
          Foo.Tests.cs

We are currently not accepting samples that rely on native libraries for hardware interaction. This is for two reasons: we want feedback on the System.Device API and we want to encourage the use of 100% portable .NET solutions. If a native library is used to enable precise timing, please file an issue so that we can discuss your proposed contribution further.

We will only accept samples that use the MIT or compatible licenses (BSD, Apache 2, ...). We will not accept samples that use GPL code or were based on an existing GPL implementation. It is critical that these samples can be used for commercial applications without any concern for licensing.