SpiDevice Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un dispositivo conectado a través del 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.IDisposablePublic NotInheritable Class SpiDevice
Implements IDisposable- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
| Familia de dispositivos |
Windows IoT Extension SDK (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Devices.DevicesLowLevelContract (se introdujo en la versión v1.0)
|
Ejemplos
En el ejemplo siguiente se muestra la funcionalidad básica de esta y otras API SPI mostrando cómo abrir un bus SPI por nombre descriptivo mediante la configuración de conexión predeterminada.
// 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);
}
}
}
}
En el ejemplo siguiente se muestra cómo usar esta y otras API SPI para inicializar un dispositivo SPI con la configuración de conexión no predeterminada. Lo hace leyendo la intensidad de la luz de una photocell analógica conectada a un convertidor ADC108S102 A/D de 8 canales de 8 canales.
// 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);
}
}
Propiedades
| ConnectionSettings |
Obtiene la configuración de conexión del dispositivo. |
| DeviceId |
Obtiene el identificador único asociado al dispositivo. |
Métodos
| Close() |
Cierra la conexión con el dispositivo. |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. |
| FromIdAsync(String, SpiConnectionSettings) |
Abre un dispositivo con la configuración de conexión proporcionada. |
| GetBusInfo(String) |
Recupera la información sobre un determinado bus. |
| GetDeviceSelector() |
Obtiene todos los buses SPI que se encuentran en el sistema. |
| GetDeviceSelector(String) |
Obtiene todos los buses SPI encontrados en el sistema que coinciden con el parámetro de entrada. |
| Read(Byte[]) |
Lee desde el dispositivo conectado. |
| TransferFullDuplex(Byte[], Byte[]) |
Transferir datos mediante un sistema de comunicación dúplex completo. Dúplex completo permite que el host y el periférico se comuniquen simultáneamente. Para obtener definiciones de host y periféricos, consulte Espacio de nombres Windows.Devices.Spi. |
| TransferSequential(Byte[], Byte[]) |
Transferir datos secuencialmente al dispositivo. |
| Write(Byte[]) |
Escribe en el dispositivo conectado. |