iot

Bibliothèques .NET IoT

.NET peut être utilisé pour créer des applications pour les appareils et les scénarios IoT. Les applications IoT interagissent généralement avec des capteurs, des écrans et des périphériques d'entrée qui nécessitent l'utilisation de broches GPIO, de ports série ou de matériel similaire.

Important

Il s'agit du dépôt GitHub pour les bibliothèques. Vous voudrez peut-être commencer par notre documentation officielle.

Ce référentiel contient la bibliothèque System.Device.Gpio et des implémentations pour diverses cartes comme Raspberry Pi et Hummingboard.

Le référentiel contient également Iot.Device.Bindings, un ensemble croissant de liaisons d'appareils gérées par la communauté pour les composants IoT.

Note

Ce référentiel est encore au stade expérimental et toutes les API sont susceptibles de changer.

Exigences matérielles

Alors que la plupart des liaisons et exemples de ce projet nécessitent et sont conçus pour prendre en charge du matériel spécifique (tels que des écrans LCD, des capteurs de température, des ordinateurs monocarte, des microcontrôleurs, etc.), la bibliothèque elle-même essaie d'être aussi indépendante du matériel que possible. . Certaines liaisons sont même écrites pour montrer l'utilisation d'interfaces IOT avec du matériel déjà présent dans les ordinateurs de bureau normaux (tels que des claviers ou des capteurs de température du processeur). Donc, pour commencer, vous n’avez pas besoin de matériel coûteux. Ou vous pouvez commencer avec des produits bon marché, comme un Arduino Uno.

Versions .NET

Les deux bibliothèques de ce référentiel ciblent de manière croisée .NET Standard 2.0, .NET Core 3.1 et .NET 6.0. Ils peuvent être utilisés à partir de n’importe quel projet ciblant .NET Core 2.0 ou supérieur, ainsi qu’à partir de .NET Framework ou mono. Si vous recherchez la prise en charge d'une unité de microcontrôleur (MCU), consultez .NET nanoFramework.

Les exemples de projets ciblent la dernière version stable de .NET. Cela s'applique aux exemples de projets avec chaque appareil ainsi qu'aux exemples de projets sur le répertoire /samples .

Comment installer

À partir de Visual Studio, vous pouvez simplement ajouter un nuget en recherchant System.Device.Gpio et Iot.Device.Bindings .

Si vous en avez besoin, vous pouvez également installer la dernière version préliminaire quotidienne des packages NuGet .NET System.Device.Gpio et Iot.Device.Bindings à partir du flux d'artefacts Azure.

NuGet.exe

nuget install System.Device.Gpio -PreRelease -Source https://pkgs.dev.azure.com/dotnet/IoT/_packaging/nightly_iot_builds/nuget/v3/index.json
nuget install Iot.Device.Bindings -PreRelease -Source https://pkgs.dev.azure.com/dotnet/IoT/_packaging/nightly_iot_builds/nuget/v3/index.json

Statut de construction officiel

CLI .NET

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

Contribuer

Pour plus d'informations sur la façon de créer ce référentiel et d'ajouter de nouvelles liaisons de périphériques, veuillez vous rendre sur Contribuer.

S'il vous plaît, contribuez. Nous nous intéressons principalement aux éléments suivants :

• Amélioration de la qualité et des capacités des pilotes pour les cartes prises en charge.
• Implémentations pour des cartes supplémentaires.
• Liaisons de périphériques .NET pour une grande variété de capteurs, puces, écrans et autres composants.
• Demandez une liaison de périphérique ou un protocole dont vous avez besoin pour votre projet (signalez un problème).
• Liens vers des articles de blog ou des tweets présentant l'utilisation de .NET Core pour d'excellents scénarios IoT (soumettre un problème).

Commencer

Après l'installation, veuillez consulter les zones suivantes pour en savoir plus :

• Documentation officielle - Concepts, démarrages rapides, didacticiels et documentation de référence API.
• Documentation API - Lien direct vers la documentation de référence API pour toutes les interfaces publiques. Assurez-vous de choisir la version de la bibliothèque que vous utilisez.
• Module d'apprentissage interactif Microsoft Learn
• Apprenons .NET : diffusion en direct de l'IoT (septembre 2021)
• .NET IoT 101 (janvier 2020) - Une série d'introduction sur la façon de créer des applications .NET IoT avec un Raspberry Pi.
• Documentation matérielle - Ressources liées à l'électronique, aux appareils, aux fournisseurs, aux logiciels et à d'autres sujets IoT.
• Exemples : instructions étape par étape pour créer votre première application.
• Feuille de route - Zones prévues ou en cours de réalisation.

Toutes les liaisons (src/devices) contiennent un dossier samples dans lequel vous trouverez des exemples sur la façon d'utiliser chacun des appareils, capteurs, écrans et autres composants.

Important : Assurez-vous d'utiliser une balise qui correspond à la version de votre package pour parcourir et réutiliser le code des exemples.

Une fois que vous avez sélectionné la bonne branche, vous pouvez parcourir le référentiel. La branche principale contient du code qui est toujours le plus récent et qui n'a peut-être pas encore été publié dans un package. Donc, si vous utilisez le package 1.2, veuillez sélectionner la balise 1.2 avant de parcourir le code source.

Tutoriels

• Service Web utilisant SenseHat par Dawid Borycki (août 2019)

Communauté

Ce projet a adopté le code de conduite défini par le Contributor Covenant pour clarifier le comportement attendu dans notre communauté. Pour plus d’informations, consultez le Code de conduite de la .NET Foundation.

Licence

.NET (y compris le dépôt iot) est sous licence MIT.