CM-T3530: WinCE: GPIOs Programming - Revision history

Freidman at 11:39, 21 June 2010

2010-06-21T11:39:53Z

Nadav at 11:57, 23 December 2009

2009-12-23T11:57:04Z

New page

The WinCE demo image includes a GPIO driver that allows direct GPIO control.
The GPIO driver is a stream driver that can be accessed using the "GIO" prefix.

{{Note| The GPIO driver controls only the OMAP35x General-Purpose I/O Interface. It does not include pin multiplexing control. Pin multiplexing configuration should be set to GPIO mode. For pin multiplexing details refer to section 5.5 of the
[http://www.compulab.co.il/t3530/download/t3530-cm-man.pdf CMT3530 Reference Guide]}}
== GPIO Sample Application ==
This GPIO_Sample application illustrates basic functionality of CM-T3530 GPIOs in Windows CE:
* How to configure a GPIO pin as output and manipulate it.
* How to configure a GPIO pin as input and respond to changes in signal level.
* How to setup an edge triggered event.

The GPIO_Sample application manipulates the following GPIOs:
* GPIO140 - set as output (Pin 14 of connector P9 on SB-T35).
* GPIO141 - set as input (Pin 12 of connector P9 on SB-T35).

GPIO140 voltage level can be monitored with a DVM or an oscilloscope. GPIO141 can be controlled by an external switch or button.

The GPIO_Sample performs the following actions:
* 1Hz clock simulation on GPIO140 for 10 seconds.
* Input voltage level monitoring on GPIO141.
* Edge detection on GPIO141. Event handler is registered with [[#DWORD GPIOInterruptInitialize(HANDLE hContext,DWORD id,DWORD intrID,HANDLE hEvent)|GPIOInterruptInitialize]]. The handler calls [[#DWORD GPIOInterruptDone(HANDLE hContext, DWORD id,DWORD intrID)|GPIOInterruptDone]] to indicate interrupt completion.

== GPIO Driver API ==
{{API | Signature = HANDLE GPIOOpen() |
Description = Opens an instance of the GPIO Driver. Returns a handle that should be used to access the driver |
Return = Nonzero indicates success. |
Param1 = |
Param2 = |
Param3 = |
Param4 = |
Remarks = }}
{{API | Signature = void GPIOClose(HANDLE hContext) |
Description = Closes the driver handle |
Return = |
Param1 = *hContext - Handle to an open driver instance|
Param2 = |
Param3 = |
Param4 = |
Remarks = }}
{{API | Signature = void GPIOSetBit(HANDLE hContext,DWORD id) |
Description = Sets the GPIO output high (logical 1). |
Return = |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = |
Param4 = |
Remarks = Make sure the GPIO direction is setup as output.}}
{{API | Signature = void GPIOClrBit(HANDLE hContext,DWORD id) |
Description = Sets the GPIO output low (logical 0). |
Return = |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = |
Param4 = |
Remarks = Make sure the GPIO's direction is setup as output.}}
{{API | Signature = DWORD GPIOGetBit(HANDLE hContext,DWORD id) |
Description = Measures the GPIO voltage level.|
Return = 1 - Indicates high (logical 1).
:0 - Indicates low (logical 0). |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = |
Param4 = |
Remarks = Make sure the GPIO direction is setup as input.}}
{{API | Signature = void GPIOSetMode(HANDLE hContext, DWORD id, DWORD mode) |
Description = Sets the GPIO operation mode.|
Return = |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = *DWORD mode - GPIO operation mode. Possible modes:
<pre>
#define GPIO_DIR_OUTPUT (0 << 0) //GPIO is set to output mode
#define GPIO_DIR_INPUT (1 << 0) //GPIO is set to input mode
#define GPIO_INT_LOW_HIGH (1 << 1) //Enable IRQ/Wakeup on rising edge detect
#define GPIO_INT_HIGH_LOW (1 << 2) //Enable IRQ/Wakeup on falling edge detect
#define GPIO_INT_LOW (1 << 3) //Enable the IRQ assertion on low level detect
#define GPIO_INT_HIGH (1 << 4) //Enable the IRQ assertion on high level detect
#define GPIO_DEBOUNCE_ENABLE (1 << 5) //Enable debouncing feature on the corresponding input port
</pre>|
Param4 = |
Remarks =
* After GPIO operation mode is set as output, use [[#void_GPIOSetBit.28HANDLE_hContext.2CDWORD_id.29 | GPIOSetBit]] and [[#void_GPIOClrBit.28HANDLE_hContext.2CDWORD_id.29| GPIOClrBit]] to set the GPIO output level.
:* If a GPIO is setup as output, it will not generate interrupts, regardless of GPIO_INT_xxx flags.}}
{{API | Signature = DWORD GPIOGetMode(HANDLE hContext,DWORD id) |
Description = Returns the GPIO operating mode.|
Return = GPIO operating mode as described in [[#void_GPIOSetMode.28HANDLE_hContext.2C_DWORD_id.2C_DWORD_mode.29 | GPIOSetMode]]. |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = |
Param4 = |
Remarks = }}
{{API | Signature = DWORD GPIOInterruptInitialize(HANDLE hContext,DWORD id,DWORD intrID,HANDLE hEvent) |
Description = Sets an interrupt on a GPIO.|
Return = Nonzero indicates success. |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = *intrID - Interrupt ID returned by [[#DWORD_GPIOGetSystemIrq.28HANDLE_hContext.2C_DWORD_id.29 | GPIOGetSystemIrq ]]|
Param4 = *hEvent - Event to be signaled when the interrupt is triggered |
Remarks = * This function must be called before using the hEvent parameter.
:* The hEvent parameter can only be used in a WaitForSingleObject call. A WaitForMultipleObjects call with hEvent will fail.
:* If you use hEvent in a call to WaitForSingleObject before you call GPIOInterruptInitialize, GPIOInterruptInitialize will fail.
}}
{{API | Signature = DWORD GPIOGetSystemIrq(HANDLE hContext, DWORD id) |
Description = Returns the system IRQ associated with the GPIO.|
Return = IRQ number. |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = |
Param4 = |
Remarks = }}
{{API | Signature = DWORD GPIOInterruptDone(HANDLE hContext, DWORD id,DWORD intrID) |
Description = Signals to the kernel that GPIO interrupt processing is complete.|
Return = Nonzero indicates success. |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = *intrID - Interrupt ID returned by [[#DWORD_GPIOGetSystemIrq.28HANDLE_hContext.2C_DWORD_id.29 | GPIOGetSystemIrq ]]|
Param4 = |
Remarks = A program calls GPIOInterruptDone when it has completed the interrupt processing and is ready for another interrupt. GPIOInterruptDone must be called to unmask the interrupt before the registered event can be signaled again.}}
{{API | Signature = DWORD GPIOInterruptDisable(HANDLE hContext, DWORD id,DWORD intrID) |
Description = Disables the GPIO hardware interrupt specified by interrupt identifier.|
Return = Nonzero indicates success. |
Param1 = *hContext - Handle to an open driver instance.|
Param2 = *id - GPIO number.|
Param3 = *intrID - Interrupt ID returned by [[#DWORD_GPIOGetSystemIrq.28HANDLE_hContext.2C_DWORD_id.29 | GPIOGetSystemIrq ]]|
Param4 = |
Remarks = A program calls GPIOInterruptDisable to disable the hardware interrupt and to unregister the event registered by GPIOInterruptInitialize. The program must call GPIOInterruptDisable before closing the event handle.}}

[[Category:Windows CE|GPIOs Programming]]
[[Category:CM-T3530|WinCE: GPIOs]]

@@ Line 12: / Line 12: @@
 The GPIO_Sample application manipulates the following GPIOs:
 * GPIO140 - set as output (Pin 14 of connector P9 on SB-T35).
-* GPIO141 - set as input (Pin 12 of connector P9 on SB-T35).
+* GPIO170 - set as input (Pin 1 of connector P11 on SB-T35).
-GPIO140 voltage level can be monitored with a DVM or an oscilloscope. GPIO141 can be controlled by an external switch or button.
+GPIO140 voltage level can be monitored with a DVM or an oscilloscope. GPIO170 can be controlled by an external switch or button.
 The GPIO_Sample performs the following actions:
 * 1Hz clock simulation on GPIO140 for 10 seconds.
-* Input voltage level monitoring on GPIO141.
+* Input voltage level monitoring on GPIO170.
-* Edge detection on GPIO141. Event handler is registered with [[#DWORD GPIOInterruptInitialize(HANDLE hContext,DWORD id,DWORD intrID,HANDLE hEvent)|GPIOInterruptInitialize]]. The handler calls [[#DWORD GPIOInterruptDone(HANDLE hContext, DWORD id,DWORD intrID)|GPIOInterruptDone]] to indicate interrupt completion.
+* Edge detection on GPIO170. Event handler is registered with [[#DWORD GPIOInterruptInitialize(HANDLE hContext,DWORD id,HANDLE hEvent)|GPIOInterruptInitialize]]. The handler calls [[#DWORD GPIOInterruptDone(HANDLE hContext, DWORD id,DWORD intrID)|GPIOInterruptDone]] to indicate interrupt completion.
@@ Line 91: / Line 91: @@
 Param4 = |
 Remarks = }}
-{{API | Signature = DWORD GPIOInterruptInitialize(HANDLE hContext,DWORD id,DWORD intrID,HANDLE hEvent) |
+{{API | Signature = DWORD GPIOInterruptInitialize(HANDLE hContext,DWORD id,HANDLE hEvent) |
 Description =  Sets an interrupt on a GPIO.|
 Return = Nonzero indicates success. |
 Param1 = *hContext - Handle to an open driver instance.|
 Param2 = *id - GPIO number.|
-Param3 = *intrID - Interrupt ID returned by [[#DWORD_GPIOGetSystemIrq.28HANDLE_hContext.2C_DWORD_id.29 | GPIOGetSystemIrq ]]|
+Param3 = *hEvent - Event to be signaled when the interrupt is triggered  |
-Param4 = *hEvent - Event to be signaled when the interrupt is triggered  |
+Param4 = |
 Remarks = * This function must be called before using the hEvent parameter.
 :* The hEvent parameter can only be used in a WaitForSingleObject call. A WaitForMultipleObjects call with hEvent will fail.
 :* If you use hEvent in a call to WaitForSingleObject before you call GPIOInterruptInitialize, GPIOInterruptInitialize will fail.
 }}
-{{API | Signature = DWORD GPIOGetSystemIrq(HANDLE hContext, DWORD id) |
+{{API | Signature = DWORD GPIOInterruptDone(HANDLE hContext, DWORD id) |
 Description =  Signals to the kernel that GPIO interrupt processing is complete.|
 Return = Nonzero indicates success. |
 Param1 = *hContext - Handle to an open driver instance.|
 Param2 = *id - GPIO number.|
-Param3 = *intrID - Interrupt ID returned by [[#DWORD_GPIOGetSystemIrq.28HANDLE_hContext.2C_DWORD_id.29 | GPIOGetSystemIrq ]]|
+Param3 = |
 Param4 = |
 Remarks = A program calls GPIOInterruptDone when it has completed the interrupt processing and is ready for another interrupt. GPIOInterruptDone must be called to unmask the interrupt before the registered event can be signaled again.}}
-{{API | Signature = DWORD GPIOInterruptDisable(HANDLE hContext, DWORD id,DWORD intrID) |
+{{API | Signature = DWORD GPIOInterruptDisable(HANDLE hContext, DWORD id) |
 Description =  Disables the GPIO hardware interrupt specified by interrupt identifier.|
 Return = Nonzero indicates success. |
 Param1 = *hContext - Handle to an open driver instance.|
 Param2 = *id - GPIO number.|
-Param3 = *intrID - Interrupt ID returned by [[#DWORD_GPIOGetSystemIrq.28HANDLE_hContext.2C_DWORD_id.29 | GPIOGetSystemIrq ]]|
+Param3 = |
 Param4 = |
 Remarks = A program calls GPIOInterruptDisable to disable the hardware interrupt and to unregister the event registered by GPIOInterruptInitialize. The program must call GPIOInterruptDisable before closing the event handle.}}