Share via

GpioController.OpenPin Metode

  • Referensi

Definisi

Ruang nama:
Windows.Devices.Gpio

Overload

OpenPin(Int32)

Membuka koneksi ke pin I/O tujuan umum (GPIO) yang ditentukan dalam mode eksklusif.
OpenPin(Int32, GpioSharingMode)

Membuka pin I/O tujuan umum (GPIO) yang ditentukan dalam mode yang ditentukan.

OpenPin(Int32)

Edit

Membuka koneksi ke pin I/O tujuan umum (GPIO) yang ditentukan dalam mode eksklusif.

public:
 virtual GpioPin ^ OpenPin(int pinNumber) = OpenPin;
/// [Windows.Foundation.Metadata.Overload("OpenPin")]
GpioPin OpenPin(int const& pinNumber);
[Windows.Foundation.Metadata.Overload("OpenPin")]
public GpioPin OpenPin(int pinNumber);
function openPin(pinNumber)
Public Function OpenPin (pinNumber As Integer) As GpioPin

Parameter

pinNumber
Int32

int

Nomor pin pin pin GPIO yang ingin Anda buka. Nomor pin harus

  • dalam rentang
  • tersedia untuk aplikasi usermode

Sematkan angka mulai dari 0, dan tingkatkan ke angka pin maksimum, yang kurang dari nilai yang dikembalikan oleh GpioController.PinCount.

Pin mana yang tersedia untuk usermode tergantung pada papan sirkuit tempat kode berjalan. Untuk informasi tentang bagaimana nomor pin sesuai dengan pin fisik, lihat dokumentasi untuk papan sirkuit Anda. Pemetaan pin untuk papan seperti Raspberry Pi tersedia di pusat pengembang IoT.

Mengembalikan

GpioPin

Pin GPIO yang dibuka.

Atribut
OverloadAttribute

Keterangan

Kode kesalahan:

E_INVALIDARG (0x80070057)

Parameter yang tidak valid ditentukan. Kesalahan ini akan dikembalikan jika nomor pin di luar rentang. Sematkan angka mulai dari 0 dan tingkatkan ke angka pin maksimum, yaitu satu kurang dari nilai yang dikembalikan oleh GpioController.PinCount.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)

Pin tidak tersedia untuk aplikasi usermode; dicadangkan oleh sistem. Lihat dokumentasi untuk papan sirkuit Anda untuk mengetahui pin mana yang tersedia untuk aplikasi usermode.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)

Pin saat ini terbuka dalam mode berbagi yang tidak kompatibel. Contohnya:

  • Pin sudah terbuka dalam mode GpioSharingMode.Exclusive .
  • Pin sudah terbuka dalam mode GpioSharingMode.SharedReadOnly saat Anda meminta untuk membukanya dalam mode GpioSharingMode.Exclusive .

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

Pin saat ini dimuks ke fungsi yang berbeda; misalnya I2C, SPI, atau UART. Pastikan pin tidak digunakan oleh fungsi lain.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)

Driver GPIO mengembalikan kesalahan. Pastikan driver GPIO berjalan dan dikonfigurasi dengan benar.

Lihat juga

Berlaku untuk

OpenPin(Int32, GpioSharingMode)

Edit

Membuka pin I/O tujuan umum (GPIO) yang ditentukan dalam mode yang ditentukan.

public:
 virtual GpioPin ^ OpenPin(int pinNumber, GpioSharingMode sharingMode) = OpenPin;
/// [Windows.Foundation.Metadata.Overload("OpenPinWithSharingMode")]
GpioPin OpenPin(int const& pinNumber, GpioSharingMode const& sharingMode);
[Windows.Foundation.Metadata.Overload("OpenPinWithSharingMode")]
public GpioPin OpenPin(int pinNumber, GpioSharingMode sharingMode);
function openPin(pinNumber, sharingMode)
Public Function OpenPin (pinNumber As Integer, sharingMode As GpioSharingMode) As GpioPin

Parameter

pinNumber
Int32

int

Nomor pin pin pin GPIO yang ingin Anda buka. Nomor pin harus

  • dalam rentang
  • tersedia untuk aplikasi usermode

Sematkan angka mulai dari 0, dan tingkatkan ke angka pin maksimum, yang kurang dari nilai yang dikembalikan oleh GpioController.PinCount.

Pin mana yang tersedia untuk usermode tergantung pada papan sirkuit tempat kode berjalan. Untuk informasi tentang bagaimana nomor pin sesuai dengan pin fisik, lihat dokumentasi untuk papan sirkuit Anda. Pemetaan pin untuk papan seperti Raspberry Pi tersedia di pusat pengembang IoT.

sharingMode
GpioSharingMode

Mode di mana Anda ingin membuka pin GPIO, yang menentukan apakah koneksi lain ke pin dapat dibuka saat Anda membuka pin.

Mengembalikan

GpioPin

Pin GPIO yang dibuka.

Atribut
OverloadAttribute

Keterangan

Kode Kesalahan:

E_INVALIDARG (0x80070057)

Parameter yang tidak valid ditentukan. Kesalahan ini akan dikembalikan jika nomor pin di luar rentang. Sematkan angka mulai dari 0 dan tingkatkan ke angka pin maksimum, yaitu satu kurang dari nilai yang dikembalikan oleh GpioController.PinCount.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND) (0x80070490)

Pin tidak tersedia untuk aplikasi usermode; dicadangkan oleh sistem. Lihat dokumentasi untuk papan sirkuit Anda untuk mengetahui pin mana yang tersedia untuk aplikasi usermode.

HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) (0x80070020)

Pin saat ini terbuka dalam mode berbagi yang tidak kompatibel. Contohnya:

  • Pin sudah terbuka dalam mode GpioSharingMode.Exclusive .
  • Pin sudah terbuka dalam mode GpioSharingMode.SharedReadOnly saat Anda meminta untuk membukanya dalam mode GpioSharingMode.Exclusive .

HRESULT_FROM_WIN32(ERROR_GPIO_INCOMPATIBLE_CONNECT_MODE) (0x80073bde)

Pin saat ini dimuks ke fungsi yang berbeda; misalnya I2C, SPI, atau UART. Pastikan pin tidak digunakan oleh fungsi lain.

HRESULT_FROM_WIN32(ERROR_GEN_FAILURE) (0x8007001f)

Driver GPIO mengembalikan kesalahan. Pastikan driver GPIO berjalan dan dikonfigurasi dengan benar.

Lihat juga

Berlaku untuk