SpiConnectionSettings クラス

定義

名前空間:

Windows.Devices.Spi

SpiDevice との接続の設定を表します。

public ref class SpiConnectionSettings sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.DevicesLowLevelContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.Spi.ISpiConnectionSettingsFactory, 65536, "Windows.Devices.DevicesLowLevelContract")]
class SpiConnectionSettings final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.DevicesLowLevelContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.Spi.ISpiConnectionSettingsFactory), 65536, "Windows.Devices.DevicesLowLevelContract")]
public sealed class SpiConnectionSettings

function SpiConnectionSettings(chipSelectLine)

Public NotInheritable Class SpiConnectionSettings

継承

Object Platform::Object IInspectable SpiConnectionSettings

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

デバイス ファミリ	Windows IoT Extension SDK (10.0.10240.0 で導入)
API contract	Windows.Devices.DevicesLowLevelContract (v1.0 で導入)

例

次の例では、既定の接続設定を使用してフレンドリ名で SPI バスを開く方法を示すことで、この API とその他の SPI API の基本的な機能を示します。

// 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); 
            } 
        } 
    } 
} 

次の例では、これと他の SPI API を使用して、既定以外の接続設定で SPI デバイスを初期化する方法を示します。 これは、8チャンネル10ビットADC108S102 A/Dコンバータに接続されたアナログフォトセルから光強度を読み取ることによって行われます。

注意

このサンプルには、上記のデバイスに固有のいくつかの設定が含まれています。 特定のデバイスを考慮するために、これらの設定を変更する必要がある場合があります。 たとえば、Raspberry Pi デバイスでは、SPI の最大 8/9 ビット長がサポートされます。

// 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); 
    } 
} 

コンストラクター

SpiConnectionSettings(Int32)

SpiConnectionSettings の新しいインスタンスを初期化します。

プロパティ

ChipSelectLine	SPI デバイスへの接続のチップ選択行を取得または設定します。
ClockFrequency	接続のクロック周波数を取得または設定します。
DataBitLength	この接続上のデータのビット長を取得または設定します。
Mode	この接続の SpiMode を取得または設定します。
SharingMode	SPI 接続の共有モードを取得または設定します。