SpiDevice Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili perangkat yang terhubung melalui bus SPI.
public ref class SpiDevice sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.DevicesLowLevelContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SpiDevice final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.DevicesLowLevelContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SpiDevice : System.IDisposable
Public NotInheritable Class SpiDevice
Implements IDisposable
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows IoT Extension SDK (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Devices.DevicesLowLevelContract (diperkenalkan dalam v1.0)
|
Contoh
Contoh berikut mengilustrasikan fungsionalitas dasar API SPI ini dan lainnya dengan memperlihatkan cara membuka bus SPI dengan nama yang mudah diingat menggunakan pengaturan koneksi default.
// Arduino SPIDigialPot example: http://arduino.cc/en/Tutorial/SPIDigitalPot
// using digital potentiometer AD5206 the 50kohm variance
async void Digipot_AD5206()
{
// Get a device selector query that will select buses with SP10
// property set on them (we expect only 1 SP10 bus at the end)
var spi0Aqs = SpiDevice.GetDeviceSelector("SPI0");
// Find all buses using the AQS query formed above
var devicesInfo = await DeviceInformation.FindAllAsync(spi0Aqs);
// Construct time settings beforehand which can't be changed
// once a SPI device is created
const Int32 DigipotChipSelectLine = 0;
var settings = new SpiConnectionSettings(DigipotChipSelectLine);
// Ask the SPI bus to open a device with the connection settings
// provided. Once we go out of scope, the device will be released
using (var spiDev = await SpiDevice.FromIdAsync(devicesInfo[0].Id, settings))
{
// data[0] is the channel address
// data[1] is the resistance step (0 - 255)
// 0 is max digipot resistance, and 255 is no resistance
byte[] data = { 0x0, 0x0 };
// Go over the 6 channels of the digipot
for (byte channel = 0; channel < 6; ++channel)
{
data[0] = channel;
// Step the resistance on this channel from max to min
for (byte r = 0; r <= 255; ++r)
{
data[1] = r;
spiDev.Write(data);
await Task.Delay(100);
}
// Step the resistance on this channel from min to max
for (byte r = 255; r >= 0; --r)
{
data[1] = r;
spiDev.Write(data);
await Task.Delay(100);
}
}
}
}
Contoh berikut menunjukkan cara menggunakan API SPI ini dan lainnya untuk menginisialisasi perangkat SPI dengan pengaturan koneksi non-default. Ini melakukannya dengan membaca intensitas cahaya dari Photocell analog yang terhubung ke Konverter ADC108S102 A/D 8-channel.
// Knowing that an SPI bus with 'spiBusId' exist, and has the ADC connected
// on 'chipSelectLine', read a digital sample from some sensor wired to 'channel'
async Task<int> AnalogRead_ADC108S102(string spiBusId, Int32 chipSelectLine, byte channel)
{
var settings = new SpiConnectionSettings(chipSelectLine);
// The defaults (4MHz, 8-bit, Mode0) will not work here according
// to the datasheet.
// e.g The datasheet specifies a clock freq range (8MHz - 16MHz)
settings.ClockFrequency = 8000000;
// CPOL=1, CPHA=1
settings.Mode = SpiMode.Mode3;
// Conversion happens on a 16-bit frame
settings.DataBitLength = 16;
// The ADC108S102 has 8 input analog channels, where each can be
// connected to a specific analog sensor and each sensor is
// used by a different application independently
// The IO requests to the SPI bus are implicitly synchronized
// by the driver model, plus that the ADC configuration is per
// 1 sampling read
settings.SharingMode = SpiSharingMode.Shared;
// Ask the SPI bus to open a shared device with the connection settings
// provided.
using (var spiDev = await SpiDevice.FromIdAsync(spiBusId, settings))
{
if (spiDev == null)
return -1;
// Set up control register to get a conversion on a specific
// channel address
byte[] write16bitData = { (byte)(channel << 3), 0 };
byte[] read16bitData = new byte[2];
// The transfer is guaranteed to be atomic according to SpbCx model
spiDev.TransferFullDuplex(write16bitData, read16bitData);
ushort result = BitConverter.ToUInt16(read16bitData, 0);
// Get rid of the 2 LSB zeros and mask the 10-bit sampled value
return (int)((result >> 2) & 0x3ff);
}
}
Properti
ConnectionSettings |
Mendapatkan pengaturan koneksi untuk perangkat. |
DeviceId |
Mendapatkan ID unik yang terkait dengan perangkat. |
Metode
Close() |
Menutup sambungan ke perangkat. |
Dispose() |
Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. |
FromIdAsync(String, SpiConnectionSettings) |
Membuka perangkat dengan pengaturan koneksi yang disediakan. |
GetBusInfo(String) |
Mengambil info tentang bus tertentu. |
GetDeviceSelector() |
Mendapatkan semua bus SPI yang ditemukan di sistem. |
GetDeviceSelector(String) |
Mendapatkan semua bus SPI yang ditemukan pada sistem yang cocok dengan parameter input. |
Read(Byte[]) |
Membaca dari perangkat yang terhubung. |
TransferFullDuplex(Byte[], Byte[]) |
Mentransfer data menggunakan sistem komunikasi dupleks penuh. Dupleks penuh memungkinkan host dan periferal untuk berkomunikasi secara bersamaan. Untuk definisi host dan periferal, lihat namespace Windows.Devices.Spi. |
TransferSequential(Byte[], Byte[]) |
Transfer data secara berurutan ke perangkat. |
Write(Byte[]) |
Menulis ke perangkat yang terhubung. |