Jacdac .NET library
Перейти к файлу
Tom Ball 7ef09c235d
Update README.md
2024-10-01 13:27:07 -07:00
.github/workflows upgrade workflows 2024-02-11 20:35:38 +00:00
Jacdac Update PCControllerClient and PCMonitorClient documentation links 2024-01-09 16:17:52 +00:00
Jacdac.DevTools add retry for proxy source 2022-01-28 10:57:56 -08:00
Jacdac.Explorer Tinyclr (#3) 2021-12-09 15:34:43 -08:00
Jacdac.Meadow adding empty meadow project 2023-05-18 13:14:34 -07:00
Jacdac.NET retarget .net framework 2.0 for unity 2022-01-27 18:41:58 -08:00
Jacdac.NET.Clients retarget .net framework 2.0 for unity 2022-01-27 18:41:58 -08:00
Jacdac.NET.Logging feature: enabling logging infrastruce (#11) 2022-01-18 07:07:37 -08:00
Jacdac.NET.Playground adding empty meadow project 2023-05-18 13:14:34 -07:00
Jacdac.NET.Servers.AzureIotHub status code support, towards jacscript cloud suport 2022-01-19 12:38:20 -08:00
Jacdac.NET.Servers.SoundPlayer retarget .net framework 2.0 for unity 2022-01-27 18:41:58 -08:00
Jacdac.NET.Transports.Hf2 retarget .net framework 2.0 for unity 2022-01-27 18:41:58 -08:00
Jacdac.NET.Transports.LibUsb retarget .net framework 2.0 for unity 2022-01-27 18:41:58 -08:00
Jacdac.NET.Transports.Spi fix build 2022-02-01 16:40:42 -08:00
Jacdac.NET.Transports.WebSockets retarget .net framework 2.0 for unity 2022-01-27 18:41:58 -08:00
Jacdac.Nano clean up project 2022-01-24 08:25:51 -08:00
Jacdac.Nano.Clients patch: nuget nano (#15) 2022-01-21 09:13:58 -08:00
Jacdac.Nano.Transports.Spi patch: nuget nano (#15) 2022-01-21 09:13:58 -08:00
Jacdac.Tests more work on twins 2022-01-04 13:32:11 -08:00
Jacdac.TinyCLR patch: nuget nano (#15) 2022-01-21 09:13:58 -08:00
Jacdac.TinyCLR.Clients attempt at fixing 2022-01-19 09:27:11 -08:00
Jacdac.TinyCLR.Playground Revert "single assembly version file for tinyclr" 2022-01-18 17:39:58 -08:00
Jacdac.TinyCLR.Storage attempt at fixing 2022-01-19 09:27:11 -08:00
Jacdac.Uploader mroe spec integration 2022-01-04 14:13:26 -08:00
SnippetExtractor generating snippets in jacdac-docs directy 2022-01-12 05:31:02 -08:00
.gitattributes Initial commit 2021-07-29 11:16:26 +02:00
.gitignore ignore newpackages folder 2022-01-20 12:06:55 -08:00
CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md committed 2021-07-29 01:55:00 -07:00
Directory.Build.props fix: generating Jacdac.TinyCLR nuget packages (#10) 2022-01-18 15:58:51 -08:00
Jacdac.Dev.sln adding empty meadow project 2023-05-18 13:14:34 -07:00
Jacdac.sln fix: adding nano project to jacdac.sln (#12) 2022-01-20 20:50:55 -08:00
LICENSE LICENSE committed 2021-07-29 01:55:00 -07:00
README.md Update README.md 2024-10-01 13:27:07 -07:00
SECURITY.md SECURITY.md committed 2021-07-29 01:55:02 -07:00
SUPPORT.md SUPPORT.md committed 2021-07-29 01:55:02 -07:00
TinyCLR.Build.props trying to builf assemblyinfo 2022-01-19 09:16:46 -08:00
jacdac.png enable nuget package generation 2022-01-04 09:33:40 -08:00
pack.sh Merge branch 'main' of https://github.com/microsoft/jacdac-dotnet 2022-01-21 09:27:18 -08:00
publish.sh patch: nuget nano (#15) 2022-01-21 09:13:58 -08:00
release.config.js patch: nuget nano (#15) 2022-01-21 09:13:58 -08:00
snippet.bat updated samples 2022-01-12 11:21:08 -08:00

README.md

NOTE: Jacdac has moved to the organization https://github.com/jacdac

Jacdac for .NET

Jacdac is a plug-and-play hardware/software stack for microcontrollers and their peripherals (sensors/actuators), with applications to rapid prototyping, making, and physical computing.

This repository contains .NET Framework 2.0, .NET nanoframework and TinyCLR client libraries for the Jacdac protocol, as well as transports over USB, SPI, WebSockets.

Assemblies

The Jacdac project contains C# sources of the Jacdac protocol for various .NET runtime, including desktop or TinyClR. To avoid mscorlib issues, each platform recompiles these sources into its own assembly where C# files are simply shared as links. As a result, the C# used in the Jacdac project is .NET Framework 2.0/.NET nanoframework/TinyCLR compatible (and also inherits limitations thereof).

.NET Framework 2.0 and .NET IoT Core

  • Jacdac.NET, core runtime
  • Jacdac.NET.Clients, service clients
  • Jacdac.NET.Logging, a logging provider that allows to send log messages over the Jacdac bus
  • Jacdac.NET.Transports.Spi, SPI transport layer for SPI Jacdapter using .NET IoT
  • Jacdac.NET.Transports.WebSockets, WebSocket transport
  • Jacdac.NET.Transports.Hf2, HF2 protocol layer, .NET Framework 2.0
  • Jacdac.NET.Transports.LibUsb, Usb transport based on libusb, .NET Framework 2.0
  • Jacdac.NET.Servers.SoundPlayer, .NET Framework 2.0 sound player server implementation

TinyCLR

  • Jacdac.TinyCLR, mirror of Jacdac library and UART transport
  • Jacdac.TinyCLR.Clients, service clients
  • Jacdac.TinyCLR.Storage, SD card storage support

.NET nanoframework

Under development: we need help to either write a native single wire serial transport... or build a SPI HAT for Feather S2.

  • Jacdac.Nano, mirror of Jacdac library and UART transport
  • Jacdac.Nano.Transports.Spi, SPI transport layer for SPI Jacdapter using .NET nanoframework
  • Jacdac.Nano.Clients, service clients

Sample sources

The samples are mostly foud in ./Jacdac/Samples and cross-compiled into these projects:

  • Jacdac.NET.Playground, change the command line argument to match the sample type name
  • Jacdac.TinyCLR.Playground, change the sample type name in Program.cs

Misc:

  • Jacdac.DevTools, a .NET Core web site/proxy to help with developing Jacdac applications
  • Jacdac.Tests, unit tests, .NET6
  • Jacdac, C# Jacdac sources. This package serves as a placeholder for C# files and and is not referenced anywhere. For development purposes only.

DevTools

Launch Jacdac.DevTools and use the WebSocket transport to connect your Jacdac bus to a local dashboard. This allows you to test your code against simulators and physical devices, and leverage the tooling available in the Jacdac network.

To installm,

dotnet tool install jacdac.devtools

To run,

jacdac.devtools

Add spi on Raspberry Pi to also connect to the JacHAT

Developer setup

The rest of this page is for developers of the jacdac-dotnet library. For user documentation, go to https://microsoft.github.io/jacdac-docs/clients/dotnet.

  • clone this repository and pull all submodules
git clone https://github.com/microsoft/jacdac-dotnet
git submodule update --init --recursive
git pull
  • Restore Nuget packages. (Either in your preferred IDE/Editor or using dotnet restore).
  • Execute the desired tool or build the core library using your IDE or dotnet build/dotnet run

Testing with .NET and Jacdac development server

  • install NodeJS 14+
  • install Jacdac cli
npm install -g jacdac-cli
  • launch Jacdac dev tools
jacdac devtools
  • start running or debugging Jacdac.NET.Playground. The webdashboard will serve as a connector to the hardware.

.NET IoT Raspberry Pi

  • Open bash
sh ./publish.sh
  • From a SSH session
cd dotnet
dotnet Jacdac.NET.Playground spi

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.