Skip to content
/ iot Public
forked from dotnet/iot

This repo includes .NET Core implementations for various IoT boards, chips, displays and PCBs.

License

Notifications You must be signed in to change notification settings

pedson/iot

 
 

Repository files navigation

Gitter Discord

.NET Core IoT Libraries

.NET Core can be used to build applications for IoT devices and scenarios. IoT applications typically interact with sensors, displays and input devices that require the use of GPIO pins, serial ports or similar hardware.

This repository contains the System.Device.Gpio library and implementations for various boards like Raspberry Pi and Hummingboard.

The repository also contains Iot.Device.Bindings, a growing set of community-maintained device bindings for IoT components.

NOTE: This repository is still in experimental stage and all APIs are subject to changes.

Hardware requirements

While most of the bindings and examples in this project require and are designed to support specific hardware (such as LCD displays, temperature sensors, single-board computers, microcontrollers, etc.), the library itself tries to be as hardware-independent as possible. Some bindings are even written to showcase the use of IOT interfaces with hardware that is already present in normal desktop computers (such as keyboards or CPU temperature sensors). So to get started, you do not need expensive hardware. Or you can start out with cheap stuff, such as an Arduino Uno.

.NET Core Versions

Both libraries in this repository are cross-targetting .NET Standard 2.0, .NET Core 2.1 and .NET 5.0. They can be used from any project targeting .NET Core 2.1 or higher, and also from .NET Framework or Mono.

The sample projects target the latest stable .NET Version. This applies to the sample projects with each device as well as the example projects on the /samples directory.

How to Install

You can install the latest daily pre-release build of the .NET Core System.Device.Gpio and Iot.Device.Bindings NuGet packages from the blob feed.

NuGet.exe

nuget install System.Device.Gpio -PreRelease -Source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json
nuget install Iot.Device.Bindings -PreRelease -Source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json

Official Build Status

Build Status

.NET CLI

dotnet add package System.Device.Gpio --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json
dotnet add package Iot.Device.Bindings --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json

Contributing

For information on how to build this repository and to add new device bindings, please head out to Contributing.

Please contribute. We are primarily interested in the following:

  • Improving quality and capability of the drivers for supported boards.
  • Implementations for additional boards.
  • .NET device bindings for a wide variety of sensors, chips, displays and other components.
  • Request a device binding or protocol that you need for your project (file an issue).
  • Links to blog posts or tweets that showcase .NET Core being used for great IoT scenarios (file an issue).

Getting Started

After installing, please see the following areas to learn more:

  • .NET IoT 101 (Jan 2020) - An introduction series on how to create .NET IoT applications with a Raspberry Pi.
  • Introduction - Quickstart Guides with a few examples
  • API Documentation - API documentation for all public interfaces. Be sure to choose the library version you are using.
  • Hardware Documentation - Resources related to electronics, devices, vendors, software and other IoT topics.
  • Samples - Step-by-step instructions on building your first app.
  • Roadmap - Areas planned or currently being worked on.

All bindings (src/devices) contains a samples folder where you will find examples on how to use each of the devices, sensor, displays and other components.

Important: Please make sure you are using tag that correspond to your package version to browse and reuse the samples' code.

select branch

Once you have selected the right branch, you can browse the repository. The main branch contains code that is always the latest and may not been yet released to a package. So if you are using the 1.2 package, please select 1.2 tag before browsing the source code.

Tutorials

Community

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

License

.NET Core (including the iot repo) is licensed under the MIT license.

About

This repo includes .NET Core implementations for various IoT boards, chips, displays and PCBs.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 94.6%
  • PowerShell 3.1%
  • Shell 1.9%
  • Other 0.4%