4.0 KiB
IMPORTANT: this needs to be adjusted as well with all the generated bindings
Welcome to the nanoFramework IoT.Device Library repository!
This repository contains bindings which can be sensors, small screen and anything else that you can connect to your nanoFramework chip!
Most of the bindings have been migrated from .NET IoT repository. Not all the bindings make sense to migrate to .NET nanoFramework, so the effort of migration has been placed into devices that can work with .NET nanoFramework. Please note as well that some devices have been migrated without been tested, so they main contain problems.
Folder Structure
/src/devices/ contains devices that were cleaned up and should be working out of the box.
/src/devices_generated/ contains devices that were automatically ported from the NET Core IoT Libraries devices. They might not work or compile at this point, but are a good starting point if you need support for one of the devices contained here but missing from the /src/devices/ folder.
/src/nanoFramework.IoT.Device.CodeConverter contains the tool used to generate the devices from the NET Core IoT Libraries devices.
Other folders in /src contain nanoFramework projects that you can reference when creating/updating devices with provide functionality such as a StopWatach, a DelayHelper, BinaryPrimitives or various System.Device.Model Attributes.
Contributing
Important: If you plan to clean up the code in /src/devices_generated/, please copy your work to the /src/devices/ folder as the content of /src/devices_generated/ will be overwritten by the generator tool.
Please check the detail list of tips and tricks to facilitate the migration. The generator takes care of some heavy lifting but there is always some manual adjustments needed.
We are using the following structure for the bindings:
/devices
/Binding1
/samples
Binding1.Samples.nfproj
AssicateFile.cs
Program.cs
/test
BindingA.Test.nfproj
AssociatedTestFile.cs
Binding1.nfproj
Binding1.nuspec
version.json
OtherFiles.cs
OtherFiles.anythingelse
Readme.md
Using the Code Converter
The Code Converter allows to facilitate migration of .NET Core/.NET 5.0 code into .NET nanoFramework. More information and how to customize and run it here.
Feedback and documentation
For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.
Join our Discord community here.
Credits
The list of contributors to this project can be found at CONTRIBUTORS.
License
The nanoFramework Class Libraries are licensed under the MIT license.
Code of Conduct
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.
.NET Foundation
This project is supported by the .NET Foundation.