SpiDevice Clase

Definición

Espacio de nombres:

Windows.Devices.Spi

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.IDisposable

Public NotInheritable Class SpiDevice
Implements IDisposable

Herencia

Object Platform::Object IInspectable SpiDevice

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IClosable IDisposable

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.

Consulte también

• IClosable