nanoFramework.System.Device.Spi 1.3.52

欢迎使用 .NET nanoFramework System.Device.Spi 库仓库

构建状态

组件	构建状态	NuGet 包
System.Device.Spi

用法

要创建 SpiDevice，需要遵循这个模式

SpiDevice spiDevice;
SpiConnectionSettings connectionSettings;
// Note: the ChipSelect pin should be adjusted to your device, here 12
// You can adjust as well the bus, here 1 for SPI1
connectionSettings = new SpiConnectionSettings(1, 12);
spiDevice = SpiDevice.Create(connectionSettings);

如果您将控制芯片选择线的状态，需要在 SpiConnectionSettings(...) 的第二个参数中传递 -1。指定 GPIO 编号时，驱动程序会为您设置适当的信号状态，以在 SPI 事务期间处理。

SpiConnectionSettings 和 SpiBusInfo

SpiConnectionSettings 包含设置硬件 SPI 设备所需的键元素。创建后，这些元素不能调整。

connectionSettings.ChipSelectLineActiveState = PinValue.High; // Default is active Low
connectionSettings.ClockFrequency = 1_000_000;
connectionSettings.DataFlow = DataFlow.LsbFirst; // Default is MSB

要获取默认的总线值，特别是总线最小和最大频率，以及最大芯片选择数，可以使用 SpiBusInfo。

SpiBusInfo spiBusInfo = SpiDevice.GetBusInfo(1);
Debug.WriteLine($"{nameof(spiBusInfo.MaxClockFrequency)}: {spiBusInfo.MaxClockFrequency}");
Debug.WriteLine($"{nameof(spiBusInfo.MinClockFrequency)}: {spiBusInfo.MinClockFrequency}");

读取和写入

您可以读取、写入和执行完整传输。您可以选择使用 SpanByte 或 ushort 数组。

重要：在两种情况下，数据位长度都将自动调整。因此，您可以使用 SpanByte 和 ushort 数组的同时。

您可以这样写入一个 SpanByte

SpanByte writeBuffer = new byte[2] { 42, 84 };
spiDevice.Write(writeBuffer);

您可以这样写入一个 ushort 数组

ushort[] writeBuffer = new ushort[2] { 4200, 8432 };
spiDevice.Write(writeBuffer);

您还可以写入一个单独的字节

spiDevice.WriteByte(42);

读取操作类似

SpanByte readBuffer = new byte[2];
// This will read 2 bytes
spiDevice.Read(readBuffer);
ushort[] readUshort = new ushort[4];
// This will read 4 ushort
spiDevice.Read(readUshort);
// read 1 byte
byte readMe = spiDevice.ReadByte();

对于完整传输，您需要有两个大小相同的数组，并执行全双工传输

SpanByte writeBuffer = new byte[4] { 0xAA, 0xBB, 0xCC, 0x42 };
SpanByte readBuffer = new byte[4];
spiDevice.TransferFullDuplex(writeBuffer, readBuffer);
// Same for ushirt arrays:
ushort[] writeBuffer = new ushort[4] { 0xAABC, 0x00BB, 0xCC00, 0x4242 };
ushort[] readBuffer = new ushort[4];
spiDevice.TransferFullDuplex(writeBuffer, readBuffer);

反馈和文档

有关文档、提供反馈、报告问题和了解如何贡献力量，请参阅 主仓库。

加入我们的 Discord 社区 这里。

致谢

该项目的贡献者名单可在 CONTRIBUTORS 中找到。

许可证

nanoFramework 类库受 MIT 许可证 授权。

行为准则

本项目已采用贡献者公约中定义的行为准则，以明确我们社区中的期望行为。更多信息请参阅 .NET 基金会行为准则。

.NET Foundation

本项目得到 .NET 基金会 的支持。