XLON

2022-10-27T08:24:06Z

Capfel: /* Windows Drivers */

__NOTOC__
{| style="width: 100%; color: #000000; border-spacing: 2px; border: 1px solid darkgray;" valign="top" |
| style="width: 25%; text-align: center;" |
| style="width: 50%; text-align: center;" |
| style="width: 25%; text-align: center;" |
|-
|
| style="text-align: center;" | [[Image:XLON Logo in Schwarz von SD Kopie.jpg|400px|XLON]]
| style="text-align: center;" | [[Image:LOGO_DH_electronics.jpg|180px|DH electronics]]
|}

{| style="width: 100%; color: #000000;" valign="top" |
| style="width: 50%;" |
| style="width: 50%;" |
|-
|valign="top"|

== XLON products ==
{|
|
|
|-
|[[Image:XLON U10.png|100px|XLON U10|link=]]
|
*'''[[XLON U10]]'''
|}
|valign="top"|
|
|}

== Hardware Development ==

== Software Development ==
=== XLON Configuration ===
The XLON Uxx LonWorks interfaces come with two different flavours of configuration:
# Vendor mode - does not appear as a serial port in the system.
# CDC/ACM mode - appears as a (virtual) serial port in the system.
This configuration can be replaced by using the xlon-util tool.

 
 

=== XLON Tools ===
With the following links you can download the xlon-util for different architectures:
* [[media:AAAu48iSX_j4TVGTrvtwGuqja|xlon-util packages]]
: The xlon-util packages containes the xlon-util to configure the xlon-u10. It also contains the xlon-api libs to integrate the xlon-util functionality into a custom application.
* [[media:AAA8eq-wtunWfVFSOihXnh57a|dependency packages]]
: The dependency packages contains libraries which are not in the debian repositories.
* [[media:AADI1WNNbNVhxeswBt43cWKMa|development packages]]
: The development packages contains the api header files to compile a custom application with the xlon-api libs.
 
 

=== Windows Drivers ===
Drivers for various 32- and 64-Bit versions of Windows operating system:
{| class="wikitable"
|+Vendor mode Drivers
|-
!
!CPU x86
!CPU x64:
|-
!Windows 7,8,8.1,10
|[[media:XLON-U10-Vendor_x86.zip|XLON-U10-Vendor_x86.zip]]
|[[media:XLON-U10-Vendor_x64.zip|XLON-U10-Vendor_x64.zip]]
|}

{| class="wikitable"
|+CDC/ACM mode Drivers
|-
!
!CPU x86
!CPU x64:
|-
!Windows 7,8,8.1,10
|[[media:XLON-U10-CDC_x86.zip|XLON-U10-CDC_x86.zip]]
|[[media:XLON-U10-CDC_x64.zip|XLON-U10-CDC_x64.zip]]
|}

'''Important''': If you experience an error about missing 'Microsoft Visual C 2010 redistributable' when starting xlon_util.exe,
please download it from the [https://www.microsoft.com/de-de/download/details.aspx?id=5555 Microsoft site].

== [[FAQ_General |FAQ]] ==

== Series Manufacturing ==

File:XLON-U10-CDC x86.zip

2022-10-27T08:22:49Z

Capfel:

2022-03-18T11:47:21Z

Capfel: /* WEC7 / WEC2013 DHHalLib (function library) */

== FAQ ==

== WEC7 Tools ==
=== CE Remote Display Application ===
: The Remote Display allows to operate the target device's Win CE desktop from a Windows PC. It requires a USB ActiveSync connection.
: [[media:ASRDisp.zip|Download X86 remote display application (over ActiveSync connection)]]
: Usage
: 1. Extract the zip file on your PC.
: 2. Wait for the ActiveSync connection to be ready.
: 3. Start ASRDisp.exe.

== Binary BSP user guide ==
: 1. Download binary BSP (Please have a look at the [[COM_iMX6-D2#Downloads | iMX6 Downloads]] section.).
: 2. Unzip the files to any folder on your PC.
: 3. Call <code>link-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\, to generate symbolic links in the \WINCE700\ folder.
: 4. Start Visual Studio 2008 with WEC7 platform builder.
: 5. Open platform builder project <code>DHCOM_iMX6.pbxml</code> at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\.
: 6. Select retail build.
:: [[Image:WEC7_retail_build.JPG|500px]]
: 7. Call build --> rebuild solution to build the WEC7 image.
: 8. After the image build has completed successfully, the <code>nk.nb0</code> image is stored at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\RelDir\_1_Retail_DHCOM_iMX6_ARMV7\.
: 9. Copy the new nk.nb0 to your mircoSD card and restart the system.
: '''Note:''' To delete the symbolic links (see 3.) please call <code>unlink-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\

== WEC7 / WEC2013 DHHalLib (function library) ==
The DHHalLib provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.
=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> unsigned long DHHalLibGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> unsigned long BSPGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> unsigned long WinCEImageGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

typedef enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_INT_PRIO,
DHCOM_GPIO_166,
DHCOM_GPIO_165,
DHCOM_GPIO_NOT_DEFINED
}*pDHCOM_GPIOEnum;

typedef enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
}*pDHCOM_GPIOISRType;

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, HANDLE *hEvent, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>HANDLE *hEvent</code> = external EventHandle Pointer
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
}*pDHCOM_I2CEnum;

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
}*pDHCOM_I2CFREQMode;

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pInBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' The following SPI Devices can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
}*pDHCOM_SPIEnum;

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
}*pDHCOM_SPIModeEnum;

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, unsigned int iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>unsigned int iSPIFreq</code> = DHCOM SPI clock (e.g. 1MHz = 1000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, unsigned long *pOutBuffer, unsigned long *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Data length (bit(s) count) to send/receive
::<code>unsigned long *pOutBuffer</code> = Pointer to the output buffer
::<code>unsigned long *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
}*pDHCOM_UARTEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
}*pDHCOM_UARTModeEnum;

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
}*pDHCOM_UARTParityEnum;

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
}*pDHCOM_UARTStopBitEnum;

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
}*pDHCOM_UARTByteSizeEnum;

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
}*pDHCOM_UARTWEvent;

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, unsigned long lReadIntervalTimeout, unsigned long lReadTotalTimeoutConstant, unsigned long lReadTotalTimeoutMultiplier, unsigned long ulWriteTotalTimeoutConstant, unsigned long ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned long lReadIntervalTimeout</code> = Read interval timeout
::<code>unsigned long lReadTotalTimeoutConstant</code> = Read total timeout
::<code>unsigned long lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>unsigned long ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code> unsigned long ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, unsigned char *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
}*pDHCOM_CANEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
}*pDHCOM_CANModeEnum;

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
}*pDHCOM_CANFrameEnum;

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, unsigned long lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>unsigned long lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local priority (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, unsigned long lPrescaler, unsigned char cPropSeg, unsigned char cPhase1Seg, unsigned char cPhase2Seg, unsigned char RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned long lPrescaler</code> = Prescaler value
::<code>unsigned char cPropSeg</code> = Property segmentation time value
::<code>unsigned char cPhase1Seg</code> = Phase 1 segmentation time value
::<code>unsigned char cPhase2Seg</code> = Phase 2 segmentation time value
::<code>unsigned char RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, unsigned char cCANMsgPrio, unsigned long lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for can write
::<code>unsigned char cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for can write
::<code>unsigned long lCANMsgTimeout</code> = CAN Message timeout (e.g. 1000 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, int *iCANMsgID, int *iCANMsgLength, int *iCANFrame, unsigned char *cCANMsgPrio, unsigned long *lCANMsgTimeout, int *iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int *iCANMsgID</code> = Pointer to Message identification value
::<code>int *iCANMsgLength</code> = Pointer to Message length value
::<code>int *iCANFrame</code> = Pointer to Message frame value
::<code>unsigned char *cCANMsgPrio</code> = Pointer to Message priority value
::<code>unsigned long *lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>int *iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, unsigned char *pInBuffer, int iDataLength, int *iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, unsigned char *pOutBuffer, int iDataLength, int *iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
}*pDHCOM_PHYEnum;

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Save calibration data'''
:{| class="wikitable"
|''<code> bool SaveTouchCalibrationData() </code>''
|}
:Description:
:: This function save the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

=== Audio ===
:'''Set WAVE Out Volume Level'''
:{| class="wikitable"
|''<code> void SetWAVEOutVolumeLevel(int volumeLevel) </code>''
|}
:Description:
:: This function set wave audio volume to specified given value. The range of 0 to 100 are only allowed.

== (WEC7) / WEC2013 DHHalLib C# Wrapper (function wrapper) ==
The DHHalLib C# wrapper provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.

=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> UInt32 DHHalLibGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> UInt32 BSPGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> UInt32 WinCEImageGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

public enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_NOT_DEFINED
};

public enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
};

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, ulong ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>ulong ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
};

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
};

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>ref byte pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pInBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pOutBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pOutBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' These SPI Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
};

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

public enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
};

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq, bool useDMA) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, ulong[] pOutBuffer, ulong[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Count of bit(s) length to send/receive
::<code>ulong[] pOutBuffer</code> = Array to the output buffer
::<code>ulong[] pInBuffer</code> = Array to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(only available for C/C++ applications)
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
};

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
};

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
};

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
};

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
};

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, ulong lReadIntervalTimeout, ulong lReadTotalTimeoutConstant, ulong lReadTotalTimeoutMultiplier, ulong ulWriteTotalTimeoutConstant, ulong ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>ulong lReadIntervalTimeout</code> = Read interval timeout
::<code>ulong lReadTotalTimeoutConstant</code> = Read total timeout
::<code>ulong lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>ulong ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code>ulong ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, byte[] pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
};

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
};

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, UInt32 lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>UInt32 lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local prio (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, UInt32 lPrescaler, byte cPropSeg, byte cPhase1Seg, byte cPhase2Seg, byte RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>UInt32 lPrescaler</code> = Prescaler value
::<code>byte cPropSeg</code> = Property segmentation time value
::<code>byte cPhase1Seg</code> = Phase 1 segmentation time value
::<code>byte cPhase2Seg</code> = Phase 2 segmentation time value
::<code>byte RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, byte cCANMsgPrio, UInt32 lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for write
::<code>byte cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for write
::<code>UInt32 lCANMsgTimeout</code> = CAN Message timeout (e.g. hex value: fa0 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, ref int iCANMsgID, ref int iCANMsgLength, ref int iCANFrame, ref byte cCANMsgPrio, ref UInt32 lCANMsgTimeout, ref int iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>ref int iCANMsgID</code> = Pointer to Message identification value
::<code>ref int iCANMsgLength</code> = Pointer to Message length value
::<code>ref int iCANFrame</code> = Pointer to Message frame value
::<code>ref byte cCANMsgPrio</code> = Pointer to Message priority value
::<code>ref UInt32 lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>ref int iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, byte[] pInBuffer, int iDataLength, ref int iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, byte[] pOutBuffer, int iDataLength, ref int iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
};

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Save calibration data'''
:{| class="wikitable"
|''<code> bool SaveTouchCalibrationData() </code>''
|}
:Description:
:: This function save the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

=== Audio ===
:'''Set WAVE Out Volume Level'''
:{| class="wikitable"
|''<code> void SetWAVEOutVolumeLevel(int volumeLevel) </code>''
|}
:Description:
:: This function set wave audio volume to specified given value. The range of 0 to 100 are only allowed.
:Return value: <code>bool</code> --> true = success; false = failed

== WEC2013 Debugging ==
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now the debug session can be started from visual studio.
:: [[Image:WEC2013_debug.JPG|500px]]

== WEC2013 eMMC Memory ==
If the Image is stored on the microSD card (default case), the eMMC flash memory is mounted to folder '''MMCMemory''' during running WEC2013 system.
The flash memory can be used to store any user data.

== WEC2013 FTP Connection==
WinSCP can be used to establish FTP connection to the system.
: 1. Download [https://winscp.net/eng/index.php WinSCP]
:: NOTES:
::* protocol: '''FTP'''
::* user name: '''user'''
::* default password: '''dhcom_imx6'''
::* port number: '''21'''
::* IP address: Use IP scanner (e.g. [http://angryip.org/ Angry IP scanner] to get device address. Hostname: '''DHCOM_IMX6'''

== WEC2013 VNC Connection==
With WEC2013 efonVNC is used for remote desktop connection. For more information and license click [https://sourceforge.net/projects/efonvnc/?source=directory here].
: 1. vncconfig.exe can be used to configure password and connection details (stored in folder \apps\wec2013\ at testimage).
:: NOTES:
::* default password: '''dhcom_imx6'''
::* default port number: 5900
::* Configuration is stored in registry at path [HKEY_CURRENT_USER\Software\RealVNC\WinVNC4]
:: [[Image:VNC server 1.jpg|350px]]
:: [[Image:VNC server 2.jpg|350px]]
: 2. winvnc.exe (stored in folder \apps\wec2013\ at testimage) must be started. This is done atomatically at startup with the testimage. Otherwise the application can be started via telnet.
: 3. Download VNC viewer provided by RealVNC for PC/Laptop from [https://www.realvnc.com/download/viewer/ here]. For more information and license click [https://manage.realvnc.com/purchase/vnc here].
: 4. Run VNC viewer application and connect the device by using IP address and port number.
:: NOTES:
::* default IP address: 192.168.1.110
::* default port number: 5900
:: [[Image:VNC Viewer.JPG|700px]]

== WEC2013 Remote Tools==
Before remote tools can be used, it is necessary to sstart some applications on WEC2013 Device.
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now it is possible to use remote tools from Visual Studio
:: [[Image:Remote_Tools.JPG|700px]]

== WEC2013 Test Tools==
=== TEST_APP_CANTEST ===
: The app can be used to test DHCOM CAN Port. The application is stored at folder \apps\wec2013\.
: [[media:test_app_cantest.zip|Download CAN Demo source code ]]
: '''CAN WRITE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --write --len 8 --id 0x12 --idlen 11 --val 0x55 --remote 0 </code>''
|}
:: Description of the example:
::* --len: Send 8 Bytes
::* --id: Message ID is 0x12
::* --idlen: 11 = Standard ID; 29 can be used fpr extended ID
::* --val: Data starts with 0x55, then 0x56, ...
::* --remote: 0 = no remote frame
: '''CAN READ:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --read --timeout 10000 </code>''
|}
:: Description of the example:
::* The application waits for 10 seconds to receive data.
: '''CAN GET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --getbitrate </code>''
|}
:: Description of the example:
::* The application shows the current used bitrate.
: '''CAN SET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --setbitrate --bitrate 250000 </code>''
|}
:: Description of the example:
::* The application sets bitrate to 250kbps.

=== UART_Test===
: The app can be used to test DHCOM UART 2 Port. The application is stored at folder \apps\wec2013\.
: [[media:UART_Test.zip|Download UART Demo source code ]]
:{| class="wikitable"
|''<code> UART_Test </code>''
|}
:: Description of the example:
::* The application cyclic sends <code> "Hello World" </code> and receives data.
::* The baudrate 115200 is used for the demo.
::* <code> q </code> must be send to exit the demo.

COM iMX6 WinCE

2022-03-18T11:37:08Z

Capfel: /* (WEC7) / WEC2013 DHHalLib C# Wrapper (function wrapper) */

== FAQ ==

== WEC7 Tools ==
=== CE Remote Display Application ===
: The Remote Display allows to operate the target device's Win CE desktop from a Windows PC. It requires a USB ActiveSync connection.
: [[media:ASRDisp.zip|Download X86 remote display application (over ActiveSync connection)]]
: Usage
: 1. Extract the zip file on your PC.
: 2. Wait for the ActiveSync connection to be ready.
: 3. Start ASRDisp.exe.

== Binary BSP user guide ==
: 1. Download binary BSP (Please have a look at the [[COM_iMX6-D2#Downloads | iMX6 Downloads]] section.).
: 2. Unzip the files to any folder on your PC.
: 3. Call <code>link-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\, to generate symbolic links in the \WINCE700\ folder.
: 4. Start Visual Studio 2008 with WEC7 platform builder.
: 5. Open platform builder project <code>DHCOM_iMX6.pbxml</code> at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\.
: 6. Select retail build.
:: [[Image:WEC7_retail_build.JPG|500px]]
: 7. Call build --> rebuild solution to build the WEC7 image.
: 8. After the image build has completed successfully, the <code>nk.nb0</code> image is stored at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\RelDir\_1_Retail_DHCOM_iMX6_ARMV7\.
: 9. Copy the new nk.nb0 to your mircoSD card and restart the system.
: '''Note:''' To delete the symbolic links (see 3.) please call <code>unlink-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\

== WEC7 / WEC2013 DHHalLib (function library) ==
The DHHalLib provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.
=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> unsigned long DHHalLibGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> unsigned long BSPGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> unsigned long WinCEImageGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

typedef enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_INT_PRIO,
DHCOM_GPIO_166,
DHCOM_GPIO_165,
DHCOM_GPIO_NOT_DEFINED
}*pDHCOM_GPIOEnum;

typedef enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
}*pDHCOM_GPIOISRType;

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, HANDLE *hEvent, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>HANDLE *hEvent</code> = external EventHandle Pointer
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
}*pDHCOM_I2CEnum;

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
}*pDHCOM_I2CFREQMode;

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pInBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' The following SPI Devices can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
}*pDHCOM_SPIEnum;

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
}*pDHCOM_SPIModeEnum;

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, unsigned int iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>unsigned int iSPIFreq</code> = DHCOM SPI clock (e.g. 1MHz = 1000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, unsigned long *pOutBuffer, unsigned long *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Data length (bit(s) count) to send/receive
::<code>unsigned long *pOutBuffer</code> = Pointer to the output buffer
::<code>unsigned long *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
}*pDHCOM_UARTEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
}*pDHCOM_UARTModeEnum;

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
}*pDHCOM_UARTParityEnum;

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
}*pDHCOM_UARTStopBitEnum;

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
}*pDHCOM_UARTByteSizeEnum;

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
}*pDHCOM_UARTWEvent;

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, unsigned long lReadIntervalTimeout, unsigned long lReadTotalTimeoutConstant, unsigned long lReadTotalTimeoutMultiplier, unsigned long ulWriteTotalTimeoutConstant, unsigned long ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned long lReadIntervalTimeout</code> = Read interval timeout
::<code>unsigned long lReadTotalTimeoutConstant</code> = Read total timeout
::<code>unsigned long lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>unsigned long ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code> unsigned long ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, unsigned char *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
}*pDHCOM_CANEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
}*pDHCOM_CANModeEnum;

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
}*pDHCOM_CANFrameEnum;

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, unsigned long lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>unsigned long lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local priority (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, unsigned long lPrescaler, unsigned char cPropSeg, unsigned char cPhase1Seg, unsigned char cPhase2Seg, unsigned char RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned long lPrescaler</code> = Prescaler value
::<code>unsigned char cPropSeg</code> = Property segmentation time value
::<code>unsigned char cPhase1Seg</code> = Phase 1 segmentation time value
::<code>unsigned char cPhase2Seg</code> = Phase 2 segmentation time value
::<code>unsigned char RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, unsigned char cCANMsgPrio, unsigned long lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for can write
::<code>unsigned char cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for can write
::<code>unsigned long lCANMsgTimeout</code> = CAN Message timeout (e.g. 1000 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, int *iCANMsgID, int *iCANMsgLength, int *iCANFrame, unsigned char *cCANMsgPrio, unsigned long *lCANMsgTimeout, int *iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int *iCANMsgID</code> = Pointer to Message identification value
::<code>int *iCANMsgLength</code> = Pointer to Message length value
::<code>int *iCANFrame</code> = Pointer to Message frame value
::<code>unsigned char *cCANMsgPrio</code> = Pointer to Message priority value
::<code>unsigned long *lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>int *iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, unsigned char *pInBuffer, int iDataLength, int *iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, unsigned char *pOutBuffer, int iDataLength, int *iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
}*pDHCOM_PHYEnum;

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Save calibration data'''
:{| class="wikitable"
|''<code> bool SaveTouchCalibrationData() </code>''
|}
:Description:
:: This function save the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

=== Audio ===
:'''Set WAVE Out Volume Level'''
:{| class="wikitable"
|''<code> void SetWAVEOutVolumeLevel(int volumeLevel) </code>''
|}
:Description:
:: This function set wave audio volume to specified given value. The range of 0 to 100 are only allowed.
:Return value: <code>bool</code> --> true = success; false = failed

== (WEC7) / WEC2013 DHHalLib C# Wrapper (function wrapper) ==
The DHHalLib C# wrapper provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.

=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> UInt32 DHHalLibGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> UInt32 BSPGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> UInt32 WinCEImageGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

public enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_NOT_DEFINED
};

public enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
};

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, ulong ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>ulong ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
};

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
};

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>ref byte pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pInBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pOutBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pOutBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' These SPI Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
};

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

public enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
};

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq, bool useDMA) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, ulong[] pOutBuffer, ulong[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Count of bit(s) length to send/receive
::<code>ulong[] pOutBuffer</code> = Array to the output buffer
::<code>ulong[] pInBuffer</code> = Array to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(only available for C/C++ applications)
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
};

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
};

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
};

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
};

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
};

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, ulong lReadIntervalTimeout, ulong lReadTotalTimeoutConstant, ulong lReadTotalTimeoutMultiplier, ulong ulWriteTotalTimeoutConstant, ulong ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>ulong lReadIntervalTimeout</code> = Read interval timeout
::<code>ulong lReadTotalTimeoutConstant</code> = Read total timeout
::<code>ulong lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>ulong ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code>ulong ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, byte[] pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
};

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
};

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, UInt32 lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>UInt32 lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local prio (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, UInt32 lPrescaler, byte cPropSeg, byte cPhase1Seg, byte cPhase2Seg, byte RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>UInt32 lPrescaler</code> = Prescaler value
::<code>byte cPropSeg</code> = Property segmentation time value
::<code>byte cPhase1Seg</code> = Phase 1 segmentation time value
::<code>byte cPhase2Seg</code> = Phase 2 segmentation time value
::<code>byte RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, byte cCANMsgPrio, UInt32 lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for write
::<code>byte cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for write
::<code>UInt32 lCANMsgTimeout</code> = CAN Message timeout (e.g. hex value: fa0 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, ref int iCANMsgID, ref int iCANMsgLength, ref int iCANFrame, ref byte cCANMsgPrio, ref UInt32 lCANMsgTimeout, ref int iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>ref int iCANMsgID</code> = Pointer to Message identification value
::<code>ref int iCANMsgLength</code> = Pointer to Message length value
::<code>ref int iCANFrame</code> = Pointer to Message frame value
::<code>ref byte cCANMsgPrio</code> = Pointer to Message priority value
::<code>ref UInt32 lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>ref int iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, byte[] pInBuffer, int iDataLength, ref int iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, byte[] pOutBuffer, int iDataLength, ref int iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
};

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Save calibration data'''
:{| class="wikitable"
|''<code> bool SaveTouchCalibrationData() </code>''
|}
:Description:
:: This function save the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

=== Audio ===
:'''Set WAVE Out Volume Level'''
:{| class="wikitable"
|''<code> void SetWAVEOutVolumeLevel(int volumeLevel) </code>''
|}
:Description:
:: This function set wave audio volume to specified given value. The range of 0 to 100 are only allowed.
:Return value: <code>bool</code> --> true = success; false = failed

== WEC2013 Debugging ==
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now the debug session can be started from visual studio.
:: [[Image:WEC2013_debug.JPG|500px]]

== WEC2013 eMMC Memory ==
If the Image is stored on the microSD card (default case), the eMMC flash memory is mounted to folder '''MMCMemory''' during running WEC2013 system.
The flash memory can be used to store any user data.

== WEC2013 FTP Connection==
WinSCP can be used to establish FTP connection to the system.
: 1. Download [https://winscp.net/eng/index.php WinSCP]
:: NOTES:
::* protocol: '''FTP'''
::* user name: '''user'''
::* default password: '''dhcom_imx6'''
::* port number: '''21'''
::* IP address: Use IP scanner (e.g. [http://angryip.org/ Angry IP scanner] to get device address. Hostname: '''DHCOM_IMX6'''

== WEC2013 VNC Connection==
With WEC2013 efonVNC is used for remote desktop connection. For more information and license click [https://sourceforge.net/projects/efonvnc/?source=directory here].
: 1. vncconfig.exe can be used to configure password and connection details (stored in folder \apps\wec2013\ at testimage).
:: NOTES:
::* default password: '''dhcom_imx6'''
::* default port number: 5900
::* Configuration is stored in registry at path [HKEY_CURRENT_USER\Software\RealVNC\WinVNC4]
:: [[Image:VNC server 1.jpg|350px]]
:: [[Image:VNC server 2.jpg|350px]]
: 2. winvnc.exe (stored in folder \apps\wec2013\ at testimage) must be started. This is done atomatically at startup with the testimage. Otherwise the application can be started via telnet.
: 3. Download VNC viewer provided by RealVNC for PC/Laptop from [https://www.realvnc.com/download/viewer/ here]. For more information and license click [https://manage.realvnc.com/purchase/vnc here].
: 4. Run VNC viewer application and connect the device by using IP address and port number.
:: NOTES:
::* default IP address: 192.168.1.110
::* default port number: 5900
:: [[Image:VNC Viewer.JPG|700px]]

== WEC2013 Remote Tools==
Before remote tools can be used, it is necessary to sstart some applications on WEC2013 Device.
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now it is possible to use remote tools from Visual Studio
:: [[Image:Remote_Tools.JPG|700px]]

== WEC2013 Test Tools==
=== TEST_APP_CANTEST ===
: The app can be used to test DHCOM CAN Port. The application is stored at folder \apps\wec2013\.
: [[media:test_app_cantest.zip|Download CAN Demo source code ]]
: '''CAN WRITE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --write --len 8 --id 0x12 --idlen 11 --val 0x55 --remote 0 </code>''
|}
:: Description of the example:
::* --len: Send 8 Bytes
::* --id: Message ID is 0x12
::* --idlen: 11 = Standard ID; 29 can be used fpr extended ID
::* --val: Data starts with 0x55, then 0x56, ...
::* --remote: 0 = no remote frame
: '''CAN READ:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --read --timeout 10000 </code>''
|}
:: Description of the example:
::* The application waits for 10 seconds to receive data.
: '''CAN GET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --getbitrate </code>''
|}
:: Description of the example:
::* The application shows the current used bitrate.
: '''CAN SET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --setbitrate --bitrate 250000 </code>''
|}
:: Description of the example:
::* The application sets bitrate to 250kbps.

=== UART_Test===
: The app can be used to test DHCOM UART 2 Port. The application is stored at folder \apps\wec2013\.
: [[media:UART_Test.zip|Download UART Demo source code ]]
:{| class="wikitable"
|''<code> UART_Test </code>''
|}
:: Description of the example:
::* The application cyclic sends <code> "Hello World" </code> and receives data.
::* The baudrate 115200 is used for the demo.
::* <code> q </code> must be send to exit the demo.

COM iMX6 WinCE

2022-03-18T11:36:27Z

Capfel: /* (WEC7) / WEC2013 DHHalLib C# Wrapper (function wrapper) */

== FAQ ==

== WEC7 Tools ==
=== CE Remote Display Application ===
: The Remote Display allows to operate the target device's Win CE desktop from a Windows PC. It requires a USB ActiveSync connection.
: [[media:ASRDisp.zip|Download X86 remote display application (over ActiveSync connection)]]
: Usage
: 1. Extract the zip file on your PC.
: 2. Wait for the ActiveSync connection to be ready.
: 3. Start ASRDisp.exe.

== Binary BSP user guide ==
: 1. Download binary BSP (Please have a look at the [[COM_iMX6-D2#Downloads | iMX6 Downloads]] section.).
: 2. Unzip the files to any folder on your PC.
: 3. Call <code>link-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\, to generate symbolic links in the \WINCE700\ folder.
: 4. Start Visual Studio 2008 with WEC7 platform builder.
: 5. Open platform builder project <code>DHCOM_iMX6.pbxml</code> at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\.
: 6. Select retail build.
:: [[Image:WEC7_retail_build.JPG|500px]]
: 7. Call build --> rebuild solution to build the WEC7 image.
: 8. After the image build has completed successfully, the <code>nk.nb0</code> image is stored at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\RelDir\_1_Retail_DHCOM_iMX6_ARMV7\.
: 9. Copy the new nk.nb0 to your mircoSD card and restart the system.
: '''Note:''' To delete the symbolic links (see 3.) please call <code>unlink-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\

== WEC7 / WEC2013 DHHalLib (function library) ==
The DHHalLib provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.
=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> unsigned long DHHalLibGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> unsigned long BSPGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> unsigned long WinCEImageGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

typedef enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_INT_PRIO,
DHCOM_GPIO_166,
DHCOM_GPIO_165,
DHCOM_GPIO_NOT_DEFINED
}*pDHCOM_GPIOEnum;

typedef enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
}*pDHCOM_GPIOISRType;

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, HANDLE *hEvent, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>HANDLE *hEvent</code> = external EventHandle Pointer
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
}*pDHCOM_I2CEnum;

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
}*pDHCOM_I2CFREQMode;

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pInBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' The following SPI Devices can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
}*pDHCOM_SPIEnum;

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
}*pDHCOM_SPIModeEnum;

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, unsigned int iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>unsigned int iSPIFreq</code> = DHCOM SPI clock (e.g. 1MHz = 1000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, unsigned long *pOutBuffer, unsigned long *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Data length (bit(s) count) to send/receive
::<code>unsigned long *pOutBuffer</code> = Pointer to the output buffer
::<code>unsigned long *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
}*pDHCOM_UARTEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
}*pDHCOM_UARTModeEnum;

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
}*pDHCOM_UARTParityEnum;

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
}*pDHCOM_UARTStopBitEnum;

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
}*pDHCOM_UARTByteSizeEnum;

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
}*pDHCOM_UARTWEvent;

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, unsigned long lReadIntervalTimeout, unsigned long lReadTotalTimeoutConstant, unsigned long lReadTotalTimeoutMultiplier, unsigned long ulWriteTotalTimeoutConstant, unsigned long ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned long lReadIntervalTimeout</code> = Read interval timeout
::<code>unsigned long lReadTotalTimeoutConstant</code> = Read total timeout
::<code>unsigned long lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>unsigned long ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code> unsigned long ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, unsigned char *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
}*pDHCOM_CANEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
}*pDHCOM_CANModeEnum;

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
}*pDHCOM_CANFrameEnum;

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, unsigned long lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>unsigned long lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local priority (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, unsigned long lPrescaler, unsigned char cPropSeg, unsigned char cPhase1Seg, unsigned char cPhase2Seg, unsigned char RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned long lPrescaler</code> = Prescaler value
::<code>unsigned char cPropSeg</code> = Property segmentation time value
::<code>unsigned char cPhase1Seg</code> = Phase 1 segmentation time value
::<code>unsigned char cPhase2Seg</code> = Phase 2 segmentation time value
::<code>unsigned char RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, unsigned char cCANMsgPrio, unsigned long lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for can write
::<code>unsigned char cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for can write
::<code>unsigned long lCANMsgTimeout</code> = CAN Message timeout (e.g. 1000 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, int *iCANMsgID, int *iCANMsgLength, int *iCANFrame, unsigned char *cCANMsgPrio, unsigned long *lCANMsgTimeout, int *iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int *iCANMsgID</code> = Pointer to Message identification value
::<code>int *iCANMsgLength</code> = Pointer to Message length value
::<code>int *iCANFrame</code> = Pointer to Message frame value
::<code>unsigned char *cCANMsgPrio</code> = Pointer to Message priority value
::<code>unsigned long *lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>int *iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, unsigned char *pInBuffer, int iDataLength, int *iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, unsigned char *pOutBuffer, int iDataLength, int *iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
}*pDHCOM_PHYEnum;

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Save calibration data'''
:{| class="wikitable"
|''<code> bool SaveTouchCalibrationData() </code>''
|}
:Description:
:: This function save the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

=== Audio ===
:'''Set WAVE Out Volume Level'''
:{| class="wikitable"
|''<code> void SetWAVEOutVolumeLevel(int volumeLevel) </code>''
|}
:Description:
:: This function set wave audio volume to specified given value. The range of 0 to 100 are only allowed.
:Return value: <code>bool</code> --> true = success; false = failed

== (WEC7) / WEC2013 DHHalLib C# Wrapper (function wrapper) ==
The DHHalLib C# wrapper provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.

=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> UInt32 DHHalLibGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> UInt32 BSPGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> UInt32 WinCEImageGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

public enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_NOT_DEFINED
};

public enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
};

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, ulong ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>ulong ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
};

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
};

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>ref byte pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pInBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pOutBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pOutBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' These SPI Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
};

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

public enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
};

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq, bool useDMA) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, ulong[] pOutBuffer, ulong[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Count of bit(s) length to send/receive
::<code>ulong[] pOutBuffer</code> = Array to the output buffer
::<code>ulong[] pInBuffer</code> = Array to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(only available for C/C++ applications)
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
};

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
};

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
};

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
};

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
};

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, ulong lReadIntervalTimeout, ulong lReadTotalTimeoutConstant, ulong lReadTotalTimeoutMultiplier, ulong ulWriteTotalTimeoutConstant, ulong ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>ulong lReadIntervalTimeout</code> = Read interval timeout
::<code>ulong lReadTotalTimeoutConstant</code> = Read total timeout
::<code>ulong lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>ulong ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code>ulong ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, byte[] pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
};

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
};

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, UInt32 lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>UInt32 lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local prio (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, UInt32 lPrescaler, byte cPropSeg, byte cPhase1Seg, byte cPhase2Seg, byte RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>UInt32 lPrescaler</code> = Prescaler value
::<code>byte cPropSeg</code> = Property segmentation time value
::<code>byte cPhase1Seg</code> = Phase 1 segmentation time value
::<code>byte cPhase2Seg</code> = Phase 2 segmentation time value
::<code>byte RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, byte cCANMsgPrio, UInt32 lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for write
::<code>byte cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for write
::<code>UInt32 lCANMsgTimeout</code> = CAN Message timeout (e.g. hex value: fa0 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, ref int iCANMsgID, ref int iCANMsgLength, ref int iCANFrame, ref byte cCANMsgPrio, ref UInt32 lCANMsgTimeout, ref int iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>ref int iCANMsgID</code> = Pointer to Message identification value
::<code>ref int iCANMsgLength</code> = Pointer to Message length value
::<code>ref int iCANFrame</code> = Pointer to Message frame value
::<code>ref byte cCANMsgPrio</code> = Pointer to Message priority value
::<code>ref UInt32 lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>ref int iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, byte[] pInBuffer, int iDataLength, ref int iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, byte[] pOutBuffer, int iDataLength, ref int iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
};

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Save calibration data'''
:{| class="wikitable"
|''<code> bool SaveTouchCalibrationData() </code>''
|}
:Description:
:: This function save the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

== WEC2013 Debugging ==
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now the debug session can be started from visual studio.
:: [[Image:WEC2013_debug.JPG|500px]]

== WEC2013 eMMC Memory ==
If the Image is stored on the microSD card (default case), the eMMC flash memory is mounted to folder '''MMCMemory''' during running WEC2013 system.
The flash memory can be used to store any user data.

== WEC2013 FTP Connection==
WinSCP can be used to establish FTP connection to the system.
: 1. Download [https://winscp.net/eng/index.php WinSCP]
:: NOTES:
::* protocol: '''FTP'''
::* user name: '''user'''
::* default password: '''dhcom_imx6'''
::* port number: '''21'''
::* IP address: Use IP scanner (e.g. [http://angryip.org/ Angry IP scanner] to get device address. Hostname: '''DHCOM_IMX6'''

== WEC2013 VNC Connection==
With WEC2013 efonVNC is used for remote desktop connection. For more information and license click [https://sourceforge.net/projects/efonvnc/?source=directory here].
: 1. vncconfig.exe can be used to configure password and connection details (stored in folder \apps\wec2013\ at testimage).
:: NOTES:
::* default password: '''dhcom_imx6'''
::* default port number: 5900
::* Configuration is stored in registry at path [HKEY_CURRENT_USER\Software\RealVNC\WinVNC4]
:: [[Image:VNC server 1.jpg|350px]]
:: [[Image:VNC server 2.jpg|350px]]
: 2. winvnc.exe (stored in folder \apps\wec2013\ at testimage) must be started. This is done atomatically at startup with the testimage. Otherwise the application can be started via telnet.
: 3. Download VNC viewer provided by RealVNC for PC/Laptop from [https://www.realvnc.com/download/viewer/ here]. For more information and license click [https://manage.realvnc.com/purchase/vnc here].
: 4. Run VNC viewer application and connect the device by using IP address and port number.
:: NOTES:
::* default IP address: 192.168.1.110
::* default port number: 5900
:: [[Image:VNC Viewer.JPG|700px]]

== WEC2013 Remote Tools==
Before remote tools can be used, it is necessary to sstart some applications on WEC2013 Device.
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now it is possible to use remote tools from Visual Studio
:: [[Image:Remote_Tools.JPG|700px]]

== WEC2013 Test Tools==
=== TEST_APP_CANTEST ===
: The app can be used to test DHCOM CAN Port. The application is stored at folder \apps\wec2013\.
: [[media:test_app_cantest.zip|Download CAN Demo source code ]]
: '''CAN WRITE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --write --len 8 --id 0x12 --idlen 11 --val 0x55 --remote 0 </code>''
|}
:: Description of the example:
::* --len: Send 8 Bytes
::* --id: Message ID is 0x12
::* --idlen: 11 = Standard ID; 29 can be used fpr extended ID
::* --val: Data starts with 0x55, then 0x56, ...
::* --remote: 0 = no remote frame
: '''CAN READ:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --read --timeout 10000 </code>''
|}
:: Description of the example:
::* The application waits for 10 seconds to receive data.
: '''CAN GET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --getbitrate </code>''
|}
:: Description of the example:
::* The application shows the current used bitrate.
: '''CAN SET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --setbitrate --bitrate 250000 </code>''
|}
:: Description of the example:
::* The application sets bitrate to 250kbps.

=== UART_Test===
: The app can be used to test DHCOM UART 2 Port. The application is stored at folder \apps\wec2013\.
: [[media:UART_Test.zip|Download UART Demo source code ]]
:{| class="wikitable"
|''<code> UART_Test </code>''
|}
:: Description of the example:
::* The application cyclic sends <code> "Hello World" </code> and receives data.
::* The baudrate 115200 is used for the demo.
::* <code> q </code> must be send to exit the demo.

COM iMX6 WinCE

2022-03-18T11:34:14Z

2022-02-08T16:48:58Z

Capfel: /* GPIO */

== FAQ ==

== WEC7 Tools ==
=== CE Remote Display Application ===
: The Remote Display allows to operate the target device's Win CE desktop from a Windows PC. It requires a USB ActiveSync connection.
: [[media:ASRDisp.zip|Download X86 remote display application (over ActiveSync connection)]]
: Usage
: 1. Extract the zip file on your PC.
: 2. Wait for the ActiveSync connection to be ready.
: 3. Start ASRDisp.exe.

== Binary BSP user guide ==
: 1. Download binary BSP (Please have a look at the [[COM_iMX6-D2#Downloads | iMX6 Downloads]] section.).
: 2. Unzip the files to any folder on your PC.
: 3. Call <code>link-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\, to generate symbolic links in the \WINCE700\ folder.
: 4. Start Visual Studio 2008 with WEC7 platform builder.
: 5. Open platform builder project <code>DHCOM_iMX6.pbxml</code> at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\.
: 6. Select retail build.
:: [[Image:WEC7_retail_build.JPG|500px]]
: 7. Call build --> rebuild solution to build the WEC7 image.
: 8. After the image build has completed successfully, the <code>nk.nb0</code> image is stored at location C:\WINCE700\OSDesigns\DHCOM_iMX6_WEC7\RelDir\_1_Retail_DHCOM_iMX6_ARMV7\.
: 9. Copy the new nk.nb0 to your mircoSD card and restart the system.
: '''Note:''' To delete the symbolic links (see 3.) please call <code>unlink-DHCOM_iMX6_BIN_GEN.bat</code> file in the folder ...\DHCOM_iMX6_BSP_BIN\

== WEC7 / WEC2013 DHHalLib (function library) ==
The DHHalLib provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.
=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> unsigned long DHHalLibGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> unsigned long BSPGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> unsigned long WinCEImageGetVersion() </code>''
|}
:Return value: <code>unsigned long</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

typedef enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_INT_PRIO,
DHCOM_GPIO_165,
DHCOM_GPIO_164,
DHCOM_GPIO_NOT_DEFINED
}*pDHCOM_GPIOEnum;

typedef enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
}*pDHCOM_GPIOISRType;

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, HANDLE *hEvent, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>HANDLE *hEvent</code> = external EventHandle Pointer
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, unsigned long ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>unsigned long ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
}*pDHCOM_I2CEnum;

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
}*pDHCOM_I2CFREQMode;

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pOutBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, unsigned char *pInBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>unsigned char cDevId</code> = I2C device address (0..127)
::<code>unsigned char cI2CReg</code> = I2C device register address (0..255)
::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' The following SPI Devices can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
}*pDHCOM_SPIEnum;

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
}*pDHCOM_SPIModeEnum;

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, unsigned int iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>unsigned int iSPIFreq</code> = DHCOM SPI clock (e.g. 1MHz = 1000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, unsigned long *pOutBuffer, unsigned long *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Data length (bit(s) count) to send/receive
::<code>unsigned long *pOutBuffer</code> = Pointer to the output buffer
::<code>unsigned long *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
}*pDHCOM_UARTEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
}*pDHCOM_UARTModeEnum;

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
}*pDHCOM_UARTParityEnum;

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
}*pDHCOM_UARTStopBitEnum;

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
}*pDHCOM_UARTByteSizeEnum;

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
}*pDHCOM_UARTWEvent;

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, unsigned long lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code> unsigned long lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, unsigned long lReadIntervalTimeout, unsigned long lReadTotalTimeoutConstant, unsigned long lReadTotalTimeoutMultiplier, unsigned long ulWriteTotalTimeoutConstant, unsigned long ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned long lReadIntervalTimeout</code> = Read interval timeout
::<code>unsigned long lReadTotalTimeoutConstant</code> = Read total timeout
::<code>unsigned long lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>unsigned long ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code> unsigned long ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, unsigned char *pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, unsigned char *pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

typedef enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
}*pDHCOM_CANEnum;

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
}*pDHCOM_CANModeEnum;

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

typedef enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
}*pDHCOM_CANFrameEnum;

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, unsigned long lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>unsigned long lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local priority (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, unsigned long lPrescaler, unsigned char cPropSeg, unsigned char cPhase1Seg, unsigned char cPhase2Seg, unsigned char RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned long lPrescaler</code> = Prescaler value
::<code>unsigned char cPropSeg</code> = Property segmentation time value
::<code>unsigned char cPhase1Seg</code> = Phase 1 segmentation time value
::<code>unsigned char cPhase2Seg</code> = Phase 2 segmentation time value
::<code>unsigned char RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, unsigned char cCANMsgPrio, unsigned long lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for can write
::<code>unsigned char cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for can write
::<code>unsigned long lCANMsgTimeout</code> = CAN Message timeout (e.g. 1000 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, int *iCANMsgID, int *iCANMsgLength, int *iCANFrame, unsigned char *cCANMsgPrio, unsigned long *lCANMsgTimeout, int *iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>int *iCANMsgID</code> = Pointer to Message identification value
::<code>int *iCANMsgLength</code> = Pointer to Message length value
::<code>int *iCANFrame</code> = Pointer to Message frame value
::<code>unsigned char *cCANMsgPrio</code> = Pointer to Message priority value
::<code>unsigned long *lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>int *iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, unsigned char *pInBuffer, int iDataLength, int *iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, unsigned char *pOutBuffer, int iDataLength, int *iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>unsigned char *pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>int *iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

typedef enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
}*pDHCOM_PHYEnum;

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, unsigned long ulPhyAddr, unsigned char cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>unsigned long ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>unsigned char cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

== (WEC7) / WEC2013 DHHalLib C# Wrapper (function wrapper) ==
The DHHalLib C# wrapper provides hardware related functions for Windows Embedded CE 6, Windows Embedded Compact 7 and Windows Embedded Compact 2013. All the functionality is available from the user mode.

=== Version numbers ===
:'''Read DHHalLib version'''
:{| class="wikitable"
|''<code> UInt32 DHHalLibGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

:'''BSP version'''
:{| class="wikitable"
|''<code> UInt32 BSPGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)
:Note: The version number information is stored in the following registry key: <code>[HKEY_LOCAL_MACHINE\Ident] dword:"BSPVersionNumber"</code>

:'''Read image version'''
:{| class="wikitable"
|''<code> UInt32 WinCEImageGetVersion() </code>''
|}
:Return value: <code>UInt32</code> --> version number (e.g. 0x01040001 for version 1.4.0.1)

=== GPIO ===
:'''Note:''' These functions can only access the DHCOM standard GPIOs. The mapping is done with the following enum.

public enum DHCOM_GPIOEnum
{
DHCOM_GPIO_A,
DHCOM_GPIO_B,
DHCOM_GPIO_C,
DHCOM_GPIO_D,
DHCOM_GPIO_E,
DHCOM_GPIO_F,
DHCOM_GPIO_G,
DHCOM_GPIO_H,
DHCOM_GPIO_I,
DHCOM_GPIO_J,
DHCOM_GPIO_K,
DHCOM_GPIO_L,
DHCOM_GPIO_M,
DHCOM_GPIO_N,
DHCOM_GPIO_O,
DHCOM_GPIO_P,
DHCOM_GPIO_Q,
DHCOM_GPIO_R,
DHCOM_GPIO_S,
DHCOM_GPIO_T,
DHCOM_GPIO_U,
DHCOM_GPIO_V,
DHCOM_GPIO_W,
DHCOM_GPIO_PWM,
DHCOM_GPIO_NOT_DEFINED
};

public enum DHCOM_GPIOISRType
{
DHCOM_GPIO_INTR_LOW_LEV=0,
DHCOM_GPIO_INTR_HIGH_LEV,
DHCOM_GPIO_INTR_RISE_EDGE,
DHCOM_GPIO_INTR_FALL_EDGE,
DHCOM_GPIO_INTR_BOTH_EDGE,
DHCOM_GPIO_INTR_NONE
};

:'''Direction'''
:{| class="wikitable"
|''<code> bool GPIOSetDirection( DHCOM_GPIOEnum eGpio, bool bInOut, bool bDefaultState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio </code>= DHCOM GPIO pin name
::<code>bool bInOut</code> = GPIO direction (1 = input / 0 = output)
::<code>bool bDefaultState </code>= Default state (0 = low / 1 = high)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Set state'''
:{| class="wikitable"
|''<code> void GPIOSetPin(DHCOM_GPIOEnum eGpio, bool bState) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>bool bState</code> = pin state ( 0 = low / 1 = high)

:'''Read state'''
:{| class="wikitable"
|''<code> bool GPIOGetPin(DHCOM_GPIOEnum eGpio) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> 0 = low; 1 = high

:'''Set Single Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOSetSingleInterrupt(DHCOM_GPIOEnum eGpio, DHCOM_GPIOISRType eISRType, ulong ulTimeout) </code>''
|}
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
::<code>DHCOM_GPIOISRType eISRType</code> = DHCOM GPIO interrupt trigger level
::<code>ulong ulTimeout</code> = Interrupt timeout (0 = infinite)
::<code>bool bState</code> = GPIO Interrupt State
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear Interrupt'''
:{| class="wikitable"
|''<code> bool GPIOClearInterrupt(DHCOM_GPIOEnum eGpio) </code>''
|}
:''Note: Gpio Interrupt cannot disable by Hardware.''
:Input values:
::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
:Return value: <code>bool</code> --> true = success; false = failed

=== I2C ===
:'''Note:''' These I2C Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CEnum
{
DHCOM_I2C0=0,
DHCOM_I2C1,
DHCOM_I2C2,
DHCOM_I2C3,
DHCOM_I2C_NOT_DEFINED
};

:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_I2CFREQMode
{
I2C_100K=0,
I2C_400K,
I2C_800K,I2C_1600K,
I2C_2400K,
I2C_3200K
};

:'''Open'''
:{| class="wikitable"
|''<code> bool I2COpen(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void I2CClose(DHCOM_I2CEnum eI2CPort) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)

:'''Read'''
:{| class="wikitable"
|''<code> bool I2CRead(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>ref byte pOutBuffer</code> = Pointer to the read byte
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool I2CWrite(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cValue) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cValue</code> = Value to be written
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CReadMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pInBuffer</code> = Pointer to the read buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write multiple bytes'''
:{| class="wikitable"
|''<code> bool I2CWriteMultipleBytes(DHCOM_I2CEnum eI2CPort, DHCOM_I2CFREQMode eI2CFreq, byte cDevId, byte cI2CReg, byte cBytes, byte[] pOutBuffer)</code>''
|}
:Input values:
::<code>DHCOM_I2CEnum eI2CPort</code> = DHCOM I2C port name (e.g. DHCOM_I2C0)
::<code>DHCOM_I2CFREQMode eI2CFreq</code> = DHCOM I2C port freqency name(e.g. I2C_100K)
::<code>byte cDevId</code> = I2C device address (0..127)
::<code>byte cI2CReg</code> = I2C device register address (0..255)
::<code>byte cBytes</code> = Number of bytes to be read (max. 255)
::<code>byte[] pOutBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== SPI ===
:'''Note:''' These SPI Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_SPIEnum
{
DHCOM_SPI1=0,
DHCOM_SPI2,
DHCOM_SPI_NOT_DEFINED
};

:'''Note:''' These chip selects can be set. The mapping is done with the following enum.

public enum DHCOM_SPIModeEnum
{
SPI_MODE0=0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3
};

:'''Buffer fill instructions'''
:'''Note 1:''' Bits in first array-element are aligned to right.
:'''Note 2:''' First bit transferred is at highest valid bit-position of array-element "0".
:'''Note 3:''' The remainder of the modulo operation "total number of SPI-transfer bits" mod 32 is equal to the number of valid bits located in array-element "0".
:'''Note 4:''' If data length > 32 bits, all bit positions of required array-elements "n" (n>0) are always utilized.
:'''Note 5:''' First bit transferred in array-elements "n" (n>0) is at bit-position "31"
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
| ---- If remainder of above modulo is > 0 then bit(s) shift to right ----->>>> | ---- All bit positions of required array-elements "n" (n>0) are always utilized |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

'''Examples less or equal than 32 bit(s):'''
|-------------------------------------------------------------------------------------|
| Array-Element[0] |
|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|
| 0x00 | 0x02 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|
| | <--8 bit(s)-->| Example: 8 bit(s)
| | <---- 17 bit(s) to send/receive ---> | Example: 17 bit(s)
| | <------ 24 bit(s) to send/receive -----> | Example: 24 bit(s)
| <------ 32 bit(s) to send/receive -----> | Example: 32 bit(s)
|-------------------------------------------------------------------------------------|

'''Examples greater 32 bit(s):'''
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Array-Element[0] | Array-Element[n] |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10|9|8|7|6|5|4|3|2|1|0|
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
|0 | 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|0|1|0|0|0|0|0|0|1|0|0 | 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 1| 0| 0| 0| 0| 0| 0| 0| 1| 1|1|1|1|0|1|0|1|0|1|0| Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 0x00 | 0x00 | 0x01 | 0x02 | 0x04 | 0x08 | 0x0f | 0xaa | Example Data
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Example: 33 bit(s) to send/receive | <---- first bit located at bit-position "0" of array-element "0" ---> |
| Example: 34 bit(s) to send/receive | <---- first bit located at bit-position "1" of array-element "0" ---> |
| Example: 41 bit(s) to send/receive | <---- first bit located at bit-position "9" of array-element "0" ---> |
| Example: 64 bit(s) to send/receive <---- first bit located at position "31" of array-element "0" (data length multiple of 32) ---> |
|-------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|

:'''Example: Send 34bits (see example data (0x02 0x04 0x08 0x0F 0xAA) above) '''
:[[Image:WEC_SPI_example.png|800px]]

:'''Open'''
:{| class="wikitable"
|''<code> bool SPIOpen(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void SPIClose(DHCOM_SPIEnum eSPIPort) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool SPIConfigure(DHCOM_SPIEnum eSPIPort, DHCOM_SPIModeEnum eSPIMode, uint iSPIFreq, bool useDMA) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>DHCOM_SPIModeEnum eSPIMode</code> = DHCOM SPI mode name(e.g. DHCOM_CS0)
::<code>uint iSPIFreq</code> = DHCOM SPI frequency (e.g. 16MHz = 16000000)
::<code>bool useDMA</code> = Enable DHCOM SPI DMA function
:Return value: <code>bool</code> --> true = success; false = failed

:'''Exchange'''
:{| class="wikitable"
|''<code> bool SPIExchange(DHCOM_SPIEnum eSPIPort, int iBitCount, ulong[] pOutBuffer, ulong[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_SPIEnum eSPIPort</code> = DHCOM SPI port name (e.g. DHCOM_SPI1)
::<code>int iBitCount</code> = Count of bit(s) length to send/receive
::<code>ulong[] pOutBuffer</code> = Array to the output buffer
::<code>ulong[] pInBuffer</code> = Array to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== UART ===
(only available for C/C++ applications)
(Note: Currently available for WEC 2013)
:'''Note:''' These UART Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_UARTEnum
{
DHCOM_UART1=1,
DHCOM_UART2,
DHCOM_UART3
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTModeEnum
{
DHCOM_HSHAKE_OFF=1,
DHCOM_HSHAKE_SOFTWARE,
DHCOM_HSHAKE_HARDWARE
};

:'''Note:''' These parity selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTParityEnum
{
DHCOM_NOPARITY=0,
DHCOM_ODDPARITY,
DHCOM_EVENPARITY,
DHCOM_MARKPARITY,
DHCOM_SPACEPARITY
};

:'''Note:''' These stopbit selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTStopBitEnum
{
DHCOM_ONESTOPBIT=0,
DHCOM_ONE5STOPBITS,
DHCOM_TWOSTOPBITS
};

:'''Note:''' These byte size selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTByteSizeEnum
{
DHCOM_5BIT=5,
DHCOM_6BIT,
DHCOM_7BIT,
DHCOM_8BIT
};

:'''Note:''' These event selects can be set. The mapping is done with the following enum.

public enum DHCOM_UARTWEvent
{
SIG_RX_CHAR_DETECT_Flag=1,
SIG_RX_EVENT_DETECT_Flag=2,
SIG_TX_BUFFER_EMPTY_Flag=4,
SIG_CTS_CHANGED_Flag=8,
SIG_DSR_CHANGED_Flag=16,
SIG_RLSD_CHANGED_Flag=32,
SIG_BREAK_DETECT_Error=64,
SIG_LINE_STATUS_Error=128,
SIG_RING_DETECT_Error=512
};

:'''Open'''
:{| class="wikitable"
|''<code> bool UARTOpen(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void UARTClose(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool UARTConfigure(DHCOM_UARTEnum eUARTPort, DHCOM_UARTModeEnum eUARTMode, DHCOM_UARTParityEnum eUARTParity, DHCOM_UARTStopBitEnum eUARTStopBit, DHCOM_UARTByteSizeEnum eUARTByteSize, ulong lUARTFreq) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>DHCOM_UARTModeEnum eUARTMode</code> = DHCOM UART mode name(e.g. DHCOM_HSHAKE_OFF)
::<code>DHCOM_UARTParityEnum eUARTParity</code> = DHCOM UART parity name (e.g. DHCOM_NOPARITY)
::<code>DHCOM_UARTStopBitEnum eUARTStopBit</code> = DHCOM UART stop bit name (e.g. DHCOM_ONESTOPBIT)
::<code>DHCOM_UARTByteSizeEnum eUARTByteSize</code> = DHCOM UART byte size name (e.g. DHCOM_8BIT)
::<code>ulong lUARTFreq</code> = DHCOM UART frequency (e.g. 115200 bit/s = 115200)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timeout'''
:{| class="wikitable"
|''<code> bool UARTConfigureTimeout(DHCOM_UARTEnum eUARTPort, ulong lReadIntervalTimeout, ulong lReadTotalTimeoutConstant, ulong lReadTotalTimeoutMultiplier, ulong ulWriteTotalTimeoutConstant, ulong ulWriteTotalTimeoutMultiplier) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>ulong lReadIntervalTimeout</code> = Read interval timeout
::<code>ulong lReadTotalTimeoutConstant</code> = Read total timeout
::<code>ulong lReadTotalTimeoutMultiplier</code> = Read total timeout multiplier
::<code>ulong ulWriteTotalTimeoutConstant</code> = Write total timeout
::<code>ulong ulWriteTotalTimeoutMultiplier</code> = Write total timeout multiplier
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear buffer'''
:{| class="wikitable"
|''<code> bool UARTClearBuffer(DHCOM_UARTEnum eUARTPort) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)

:'''Read'''
:{| class="wikitable"
|''<code> bool UARTRead(DHCOM_UARTEnum eUARTPort, int iDataLength, byte[] pInBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>int iDataLength</code> = Read data length
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool UARTWrite(DHCOM_UARTEnum eUARTPort, byte[] pOutBuffer) </code>''
|}
:Input values:
::<code>DHCOM_UARTEnum eUARTPort</code> = DHCOM UART port name (e.g. DHCOM_UART1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
:Return value: <code>bool</code> --> true = success; false = failed

=== CAN ===
(Note: Currently available for WEC 2013)
:'''Note:''' These CAN Devices can only be set. The mapping is done with the following enum.

public enum DHCOM_CANEnum
{
DHCOM_CAN1=1,
DHCOM_CAN_NOT_DEFINED
};

:'''Note:''' These mode selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANModeEnum
{
DHCOM_CAN_STANDARD=0,
DHCOM_CAN_EXTENDED
};

:'''Note:''' These frame selects can be set. The mapping is done with the following enum.

public enum DHCOM_CANFrameEnum
{
DHCOM_CAN_DATA=0,
DHCOM_CAN_REMOTE
};

:'''Open'''
:{| class="wikitable"
|''<code> bool CANOpen(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN mode name(e.g. DHCOM_CAN_STANDARD)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Close'''
:{| class="wikitable"
|''<code> void CANClose(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)

:'''Configure'''
:{| class="wikitable"
|''<code> bool CANConfigureMode(DHCOM_CANEnum eCANPort, DHCOM_CANModeEnum eCANMode, UInt32 lCANBitrate = 0, bool bCANTLPrio = false, bool bCANLoopback = false) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANModeEnum eCANMode</code> = DHCOM CAN id type (e.g. DHCOM_CAN_STANDARD | DHCOM_CAN_EXTENDED)
::<code>UInt32 lCANBitrate</code> = DHCOM UART bitrate (e.g. 500000 bit/s = 500kbit)
::<code>bool bCANTLPrio</code> = DHCOM CAN transmit local prio (e.g. false = disabled)
::<code>bool bCANLoopback</code> = DHCOM CAN loopback mode (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Timing'''
:{| class="wikitable"
|''<code> bool CANConfigureTiming(DHCOM_CANEnum eCANPort, UInt32 lPrescaler, byte cPropSeg, byte cPhase1Seg, byte cPhase2Seg, byte RJW) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>UInt32 lPrescaler</code> = Prescaler value
::<code>byte cPropSeg</code> = Property segmentation time value
::<code>byte cPhase1Seg</code> = Phase 1 segmentation time value
::<code>byte cPhase2Seg</code> = Phase 2 segmentation time value
::<code>byte RJW</code> = Request jump time value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Filter'''
:{| class="wikitable"
|''<code> bool CANConfigureFilter(DHCOM_CANEnum eCANPort, int iFilterID, int iFilterIDMask, bool bFilterFormat, bool bFilterRemote) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN port name (e.g. DHCOM_CAN1)
::<code>int iFilterID</code> = Filter ID value
::<code>int iFilterIDMask</code> = Filter ID Mask value
::<code>bool bFilterFormat</code> = Filter format (e.g. false = disabled)
::<code>bool bFilterRemote</code> = Filter remote frame (e.g. false = disabled)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Remove Filter'''
:{| class="wikitable"
|''<code> bool CANResetFilter(DHCOM_CANEnum eCANPort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Configure Message'''
:{| class="wikitable"
|''<code> bool CANConfigureMessage(DHCOM_CANEnum eCANPort, DHCOM_CANFrameEnum eCANFrame, int iCANMsgID, byte cCANMsgPrio, UInt32 lCANMsgTimeout, bool bReadWrite) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>DHCOM_CANFrameEnum eCANFrame</code> = DHCOM CAN frame type (e.g. DHCOM_CAN_DATA | DHCOM_CAN_REMOTE)
::<code>int iCANMsgID</code> = CAN Message identification number (e.g. 0x2) - only for write
::<code>byte cCANMsgPrio</code> = CAN Message priority (e.g. 1) - only for write
::<code>UInt32 lCANMsgTimeout</code> = CAN Message timeout (e.g. hex value: fa0 = 1 sec)
::<code>bool bReadWrite</code> = (Read = false, Write = true)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Get Message Header'''
:{| class="wikitable"
|''<code> bool CANGetMessageParameter(DHCOM_CANEnum eCANPort, ref int iCANMsgID, ref int iCANMsgLength, ref int iCANFrame, ref byte cCANMsgPrio, ref UInt32 lCANMsgTimeout, ref int iTXAbort) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>ref int iCANMsgID</code> = Pointer to Message identification value
::<code>ref int iCANMsgLength</code> = Pointer to Message length value
::<code>ref int iCANFrame</code> = Pointer to Message frame value
::<code>ref byte cCANMsgPrio</code> = Pointer to Message priority value
::<code>ref UInt32 lCANMsgTimeout</code> = Pointer to Message timeout value
::<code>ref int iTXAbort</code> = Pointer to Message TX abort value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Read'''
:{| class="wikitable"
|''<code> bool CANRead(DHCOM_CANEnum eCANPort, byte[] pInBuffer, int iDataLength, ref int iResult) </code>''
|'''Attention:''' CANConfigureFilter() might be call before you can read data.
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pInBuffer</code> = Pointer to the input buffer
::<code>int iDataLength</code> = Read data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

:'''Write'''
:{| class="wikitable"
|''<code> bool CANWrite(DHCOM_CANEnum eCANPort, byte[] pOutBuffer, int iDataLength, ref int iResult) </code>''
|}
:Input values:
::<code>DHCOM_CANEnum eCANPort</code> = DHCOM CAN interface (e.g. DHCOM_CAN1)
::<code>byte[] pOutBuffer</code> = Pointer to the output buffer
::<code>int iDataLength</code> = Write data length
::<code>ref int iResult</code> = Pointer to the Result Value
:Return value: <code>bool</code> --> true = success; false = failed

=== Physical Memory ===
:'''Note:''' These freqencies can only be set. The mapping is done with the following enum.

public enum DHCOM_PHYEnum
{
DHCOM_PHY1=1,
DHCOM_PHY2,
DHCOM_PHY3,
DHCOM_PHY4,
DHCOM_PHY5,
DHCOM_PHY6,
DHCOM_PHY7,
DHCOM_PHY8,
DHCOM_PHY9
};

:'''Write Physical Address'''
:{| class="wikitable"
|''<code> int WritePhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize, int iValue, bool bReadBack) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
::<code>int iValue</code> = Value for Physical Address to write
::<code>bool bReadBack</code> = Enable/Disable Readback function (enable = true -> disable = false)
:Return value: <code>int</code> --> returns the written value from the specified Physical Address
: if bReadBack == TRUE, else 0x0 will be returned

:'''Read Physical Address'''
:{| class="wikitable"
|''<code> int ReadPhysicalAddress(DHCOM_PHYEnum PHYDev, UInt32 ulPhyAddr, byte cRegSize) </code>''
|}
:Input values:
::<code>DHCOM_PHYEnum PHYDev</code> = DHCOM PHY Device name (e.g. DHCOM_PHY1)
::<code>UInt32 ulPhyAddr</code> = Physical Address to write (e.g. GPIO1_MASK_REG = 0x209c014)
::<code>byte cRegSize</code> = Register Size (8 = 8bit, 16 = 16bit, 32 = 32bit)
:Return value: <code>int</code> --> returns the value from the specified Physical Address

=== KITL ===
:'''Restart'''
:{| class="wikitable"
|''<code> bool RestartPowerKITL() </code>''
|}
:Input values:
:Return value: <code>bool</code> --> true = success; false = failed

:'''Control'''
:{| class="wikitable"
|''<code> bool ControlPowerKITL(bool bEnable) </code>''
|}
:Input values:
::<code>bool bEnable</code> = Enable/Disable KITL Connection
:Return value: <code>bool</code> --> true = success; false = failed

=== Backlight ===
:'''Backlight Level'''
:{| class="wikitable"
|''<code> bool SetBacklightLevel(int Level) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 only Backlight Enable/Disable available. (Value 0 = Disable, Value 1 to 255 = Enable)''
:Input values:
::<code>int Level</code> = Backlight Level (0 ... 255)
:Return value: <code>bool</code> --> true = success; false = failed

:'''Backlight Timeout'''
:{| class="wikitable"
|''<code> bool SetBacklightSuspend(int Timeout, bool bEnable) </code>''
|}
:''Note: In DHHalLib Version 1.0.0.0 not available.''
:Input values:
::<code>int Timeout</code> = Timeout for Backlight (seconds)
::<code>bool bEnable</code> = Enable/Disable Timeout Backlight --> true = On; false = Off
:Return value: <code>bool</code> --> true = success; false = failed

=== Touch screen===
:'''Calibrate touch'''
:{| class="wikitable"
|''<code> bool CalibrateTouch() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Clear calibration data'''
:{| class="wikitable"
|''<code> bool ClearTouchCalibrationData() </code>''
|}
:Description:
:: This function delete the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
:Return value: <code>bool</code> --> true = success; false = failed

=== Registry ===
:'''Save HIVE registry'''
:{| class="wikitable"
|''<code> bool SaveRegistry() </code>''
|}
:Return value: <code>bool</code> --> true = success; false = failed

:'''Create backup'''
:{| class="wikitable"
|''<code> bool CreateRegistryBackup() </code>''
|}
:Description:
:: This function generates the files ave_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. These files can be used at a later time to restore the registry.
:Return value: <code>bool</code> --> true = success; false = failed

:'''Restore backup'''
:{| class="wikitable"
|''<code> bool RestoreRegistryBackup() </code>''
|}
:Description:
:: This function restores the registry from the files Save_HKLM_Reg.srg and Save_HKLCU_Reg.srg in the folder \Storage Card\. Afterwards a restart is carried out automatically. If the backup files are not present, then the function returns the return value flase.
:Return value: <code>bool</code> --> true = this never happens because a soft reset is performed; false = failed

=== Watchdog & Reset ===
:'''Soft reset'''
:{| class="wikitable"
|''<code> void SoftReset() </code>''
|}

== WEC2013 Debugging ==
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now the debug session can be started from visual studio.
:: [[Image:WEC2013_debug.JPG|500px]]

== WEC2013 eMMC Memory ==
If the Image is stored on the microSD card (default case), the eMMC flash memory is mounted to folder '''MMCMemory''' during running WEC2013 system.
The flash memory can be used to store any user data.

== WEC2013 FTP Connection==
WinSCP can be used to establish FTP connection to the system.
: 1. Download [https://winscp.net/eng/index.php WinSCP]
:: NOTES:
::* protocol: '''FTP'''
::* user name: '''user'''
::* default password: '''dhcom_imx6'''
::* port number: '''21'''
::* IP address: Use IP scanner (e.g. [http://angryip.org/ Angry IP scanner] to get device address. Hostname: '''DHCOM_IMX6'''

== WEC2013 VNC Connection==
With WEC2013 efonVNC is used for remote desktop connection. For more information and license click [https://sourceforge.net/projects/efonvnc/?source=directory here].
: 1. vncconfig.exe can be used to configure password and connection details (stored in folder \apps\wec2013\ at testimage).
:: NOTES:
::* default password: '''dhcom_imx6'''
::* default port number: 5900
::* Configuration is stored in registry at path [HKEY_CURRENT_USER\Software\RealVNC\WinVNC4]
:: [[Image:VNC server 1.jpg|350px]]
:: [[Image:VNC server 2.jpg|350px]]
: 2. winvnc.exe (stored in folder \apps\wec2013\ at testimage) must be started. This is done atomatically at startup with the testimage. Otherwise the application can be started via telnet.
: 3. Download VNC viewer provided by RealVNC for PC/Laptop from [https://www.realvnc.com/download/viewer/ here]. For more information and license click [https://manage.realvnc.com/purchase/vnc here].
: 4. Run VNC viewer application and connect the device by using IP address and port number.
:: NOTES:
::* default IP address: 192.168.1.110
::* default port number: 5900
:: [[Image:VNC Viewer.JPG|700px]]

== WEC2013 Remote Tools==
Before remote tools can be used, it is necessary to sstart some applications on WEC2013 Device.
: 1. Enable connection to WEC2013 device via Telnet. DH electronics recommends PuTTY for Telnet connection.
:: Notes: PuTTY can be downloaded from [https://www.heise.de www.heise.de]. Default IP address is 192.168.1.110. No Login is used with the testsystem.
:: [[Image:PuTTY.JPG|500px]]
: 2. Before the Remote Debug session can be started it is necessary to start two applications via the telnet connection, by using the following commands:
::* START conmanclient3.exe
::* START cmaccept3.exe
:: NOTE: If you boot up the device, you have to start the service conmanclient3.exe once. The service cmaccept3.exe needs to be start before you will deploy or debug your application. The service cmaccept3.exe is closed automatically after 3 minutes. Be sure to connect your application with the device during this time period. Otherwise you have to start the cmaccept3.exe again. The files are stored in folder \windows\ at testimage.
: 3. Now it is possible to use remote tools from Visual Studio
:: [[Image:Remote_Tools.JPG|700px]]

== WEC2013 Test Tools==
=== TEST_APP_CANTEST ===
: The app can be used to test DHCOM CAN Port. The application is stored at folder \apps\wec2013\.
: [[media:test_app_cantest.zip|Download CAN Demo source code ]]
: '''CAN WRITE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --write --len 8 --id 0x12 --idlen 11 --val 0x55 --remote 0 </code>''
|}
:: Description of the example:
::* --len: Send 8 Bytes
::* --id: Message ID is 0x12
::* --idlen: 11 = Standard ID; 29 can be used fpr extended ID
::* --val: Data starts with 0x55, then 0x56, ...
::* --remote: 0 = no remote frame
: '''CAN READ:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --read --timeout 10000 </code>''
|}
:: Description of the example:
::* The application waits for 10 seconds to receive data.
: '''CAN GET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --getbitrate </code>''
|}
:: Description of the example:
::* The application shows the current used bitrate.
: '''CAN SET BITRATE:'''
:{| class="wikitable"
|''<code> TEST_APP_CANTEST --setbitrate --bitrate 250000 </code>''
|}
:: Description of the example:
::* The application sets bitrate to 250kbps.

=== UART_Test===
: The app can be used to test DHCOM UART 2 Port. The application is stored at folder \apps\wec2013\.
: [[media:UART_Test.zip|Download UART Demo source code ]]
:{| class="wikitable"
|''<code> UART_Test </code>''
|}
:: Description of the example:
::* The application cyclic sends <code> "Hello World" </code> and receives data.
::* The baudrate 115200 is used for the demo.
::* <code> q </code> must be send to exit the demo.

DHCOM iMX6-D2

2021-10-01T15:54:53Z

Capfel: /* WEC7 DHHalLib.dll (function library) */

{|
|
|
|-
|__TOC__
|[[Image:IM6Modul.png|600px|COM iMX6-D2]]
|}

== Hardware ==

{| class="wikitable" align="center" | style="width: 100%; color: #000000; background: #f3f3f3;" valign="top" |
|-
| style="width: 50%; background: #076b8d; border: 0pt;" |
| style="width: 50%; background: #076b8d; border: 0pt;" |
|-
|valign="top" style="border: 0pt;" |
* '''Cortex-A9 Freescale i.MX6 Solo/DualLite/Dual/Quad up to 1.2GHz'''
* 2D (GC320) / 3D (GC880/GC2000) graphics accelerator
* 128 - 1024 MByte NAND flash memory (8 bit bus width) or 4 - 16 GByte eMMC flash (8 bit bus width)
* 2 MB SPI boot flash
* 256 - 2048 MByte DDR3-1066 or DDR3-800
* On module microSD card socket (4 bit SDIO) [1]
* SD/MMC card interface, 4 bit SDIO
* LC display controller, 24 bit colors, 2048x1536 pixels
* LVDS 4-channel, max. 165 Mpixels/s
* On-board touch controller for 4-wire resistive touch screens
* Ethernet controller 10/100 Mbit, IEEE1588 conform
* USB 2.0 OTG high-speed
* USB 2.0 host high speed
* Full function UART [2]
* Standard UART with hardware handshake support
* Standard UART
 [1] On module microSD card socket is only available if second CAN port is not connected.
 [2] CTS and RTS is only available if second CAN port is not connected.
|valign="top" style="border: 0pt;" |
* 2x CAN interface [1][2]
* 2x SPI interface
* 2x I²C interface
* I²S Audio codec (1 x microphone, 1 x Line in, 1x Line out)
* Real-time clock (I²C connection), low power temperature compensated
* 12 bit analog input
* 128 Bytes EEPROM with integrated MAC address
* 16 bit address/databus interface on SODIMM-200 socket
* PWM channel
* 24 GPIOs (A-W + INT_HI_PRIO)
* JTAG debug connection via FFC plug connector
* Industrial temperature range (-40°C to +85°C)
* SODIMM-200 socket with DHCOM pin assignment
|}

*[[COM iMX6 Hardware|Hardware Support]]

== Product Change Notifications (PCN) ==
* [[media:PCN_iMX6_R01_2017-08-17.pdf|PCN_iMX6_R01_2017-08-17.pdf (4GByte eMMC)]]
* [[media:PCN_iMX6_R02_2017-08-17.pdf|PCN_iMX6_R02_2017-08-17.pdf (8GByte eMMC)]]
* [[media:PCN_iMX6_R03_2017-09-20.pdf|PCN_iMX6_R03_2017-09-20.pdf (SW ethernet bug)]]
* [[media:PCN_iMX6_R04_2017-09-25.pdf|PCN_iMX6_R04_2017-09-25.pdf (Molex microSD socket)]]
* [[media:PCN_iMX6_R05_2018-01-10.pdf|PCN_iMX6_R05_2018-01-10.pdf (512MB NAND flash)]]
* [[media:PCN_iMX6_R06_2018-10-09.pdf|PCN_iMX6_R06_2018-10-09.pdf (label change)]]
* [[media:PCN_iMX6_R07_2019-11-13.pdf|PCN_iMX6_R07_2019-11-13.pdf (4GByte eMMC)]]
* [[media:PCN_iMX6_R08_2019-11-13.pdf|PCN_iMX6_R08_2019-11-13.pdf (8GByte eMMC)]]
* [[media:PCN_iMX6-009_R01_2021-07-20.pdf|PCN_iMX6-009_R01_2021-07-20.pdf (SPI flash EOL)]]

== Software Support ==
*[[COM iMX6 Bootloader U-Boot|i.MX6: Bootloader U-Boot]]
*[[COM iMX6 Linux|i.MX6: Linux]]
*[[DHCOM Update Mechanism|DHCOM Update Mechanism]]
*[[Yocto | Yocto on DHCOM]]
*[[COM iMX6 WinCE|i.MX6: WinCE]]

== BSP Sources==
==== [https://www.denx.de/wiki/U-Boot U-Boot] ====
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/legacy/2018.05_dhcom DH U-Boot (based on v2018.05)]
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/2015.10_dhcom DH U-Boot (based on v2015.10)]
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/2013.10_dhcom DH U-Boot (based on v2013.10)]

==== [https://www.kernel.org Linux Kernel] ====
* Mainline
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/dev/4.4.60_dhcom DH 4.4.60 Development]
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/release/4.4.60_dhcom/20190926 DH 4.4.60 Release 2019-09-26 (Yocto reference)]
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/dev/3.14.12_dhcom DH 3.14.12 Development]
* NXP Vendor
:* [https://github.com/dh-electronics/linux-imx6-vendor/tree/release/v4.1.15/20190624 DH 4.1.15 Release 2019-06-24 (Yocto reference)]
:* [https://github.com/dh-electronics/linux-imx6-vendor/tree/release/v3.10.17/20170804 DH 3.10.17 Release 2017-08-04 (Yocto reference)]

== Download binaries/images ==
==== U-Boot (for eMMC DHCOMs) ====
* [[media:U-boot-with-spl_imx6_v2.0.9.0_emmc.imx|DH U-Boot v2.0.9.0 (based on v2018.05)]]
* [[media:V1-1-0-8_u-boot-imx6qdl.tar.xz|DH U-Boot v1.1.0.8 (based on v2015.10)]]
: More on how to program it with the U-Boot command "update bootloader ..." on the page [[DHCOM Update Mechanism#Commandline Mode|"DHCOM Update Mechanism"]]

==== Update Kernel ====
* [[media:2020-07-27_imx6_updatekernel.zip|Update Kernel Release 2020-07-27]]
: More on how to use it on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

==== Debian based images ====
* Debian 8 "Jessie" + Kernel 4.4.60 Release 2020-03-03

:* [[media:HD00035_2020-03-03_imx6_jessie_sdcard_2000MB.img.xz|SD card: 2GB image (xz compressed)]]
:: Open it with Disks by double click on Debian Linux. Use [https://www.balena.io/etcher balenaEtcher] on Windows.

:* [[media:HD00035_2020-03-03_imx6_jessie_USB_stick_update.zip|eMMC: USB stick update image]]
:: Extract the files on a USB stick (MBR / FAT32) and insert it into your board / device. More about the files on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

* Debian 8 "Jessie" with Qt5.9.1 + Vendor Kernel 4.1.15 Release 2019-09-26

:* [[media:HD00039_2019-09-26_imx6_jessie_qt5.9.1_sdcard_2000MB.img.xz|SD card: 2GB image (xz compressed)]]
:: Open it with Disks by double click on Debian Linux. Use [https://www.balena.io/etcher balenaEtcher] on Windows.

:* [[media:HD00039_2019-09-26_imx6_jessie_qt5.9.1_USB_stick_update.zip|eMMC: USB stick update image]]
:: Extract the files on a USB stick (MBR / FAT32) and insert it into your board / device. More about the files on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

Hint: You can also progam the eMMC by using the [[COM iMX6 Bootloader U-Boot#USB Mass Storage|U-Boot command "ums"]] (usable since U-Boot v2018.05)

== Download Linux code examples ==
==== [[Virtual Machine for Application Development#Code Examples for Userspace-Applications to Access SPI, I2C, GPIOs, and more|Code Examples for Userspace-Applications to Access SPI, I2C, GPIOs, and more]] ====

== Download WEC ==
==== WEC7 DHHalLib.dll (function library) ====
* [[media:DHHalLib_WEC7_R06_2021-10-01.zip|Download DHHalLib Library Version 1.3.0.2]]
* [[media:DHHalLib_Test_App_Source_WEC7_R05_2021-10-01.zip|DHHalLib Demo App Source Code ]]
* [[media:DHHalLib_Test_App_Binary_WEC7_R05_2021-10-01.zip|DHHalLib Demo App Binary File]]
* [[media:CSharp_LibWrapper.zip|Download DHHalLib CSharp Demo Wrapper App ]]
* [[media:CSharp_LibWrapper_Binary.zip|Download DHHalLib CSharp Demo Wrapper App Binary File]]

==== WEC7 binary BSP ====
* [[media:2016-05-19_DHCOM_iMX6_BSP_BIN.zip|Download WEC7 binary BSP (date: 2016-05-19)]]

==== WEC2013 DHHalLib.dll (function library) ====
* [[media:DHHalLib_WEC2013_R12_2021-10-01.zip|Download DHHalLib Library Version 1.4.2.2]]
* [[media:DHHalLib_Test_App_Source_WEC2013_R07_2018_06_12.zip|DHHalLib Demo App Source Code ]]
* [[media:DHHalLib_Test_App_Binary_WEC2013_R09_2021-10-01.zip|DHHalLib Demo App Binary File]]
* [[media:CSharp_LibWrapper_Source_WEC2013_R07_2021-10-01.zip|Download DHHalLib CSharp Wrapper]]
* [[media:CSharp_DHHalLib_Wrapper_App_Source_WEC2013_R05_2017_08_08.zip|DHHalLib C# Demo App Source Code]]
* [[media:CSharp_DHHalLib_Wrapper_App_Binary_WEC2013_R05_2017_08_08.zip|DHHalLib C# Demo App Binary File]]

File:DHHalLib Test App Source WEC7 R05 2021-10-01.zip

2021-10-01T15:54:35Z

Capfel:

DHCOM iMX6-D2

2021-10-01T15:54:19Z

Capfel: /* WEC7 DHHalLib.dll (function library) */

{|
|
|
|-
|__TOC__
|[[Image:IM6Modul.png|600px|COM iMX6-D2]]
|}

== Hardware ==

{| class="wikitable" align="center" | style="width: 100%; color: #000000; background: #f3f3f3;" valign="top" |
|-
| style="width: 50%; background: #076b8d; border: 0pt;" |
| style="width: 50%; background: #076b8d; border: 0pt;" |
|-
|valign="top" style="border: 0pt;" |
* '''Cortex-A9 Freescale i.MX6 Solo/DualLite/Dual/Quad up to 1.2GHz'''
* 2D (GC320) / 3D (GC880/GC2000) graphics accelerator
* 128 - 1024 MByte NAND flash memory (8 bit bus width) or 4 - 16 GByte eMMC flash (8 bit bus width)
* 2 MB SPI boot flash
* 256 - 2048 MByte DDR3-1066 or DDR3-800
* On module microSD card socket (4 bit SDIO) [1]
* SD/MMC card interface, 4 bit SDIO
* LC display controller, 24 bit colors, 2048x1536 pixels
* LVDS 4-channel, max. 165 Mpixels/s
* On-board touch controller for 4-wire resistive touch screens
* Ethernet controller 10/100 Mbit, IEEE1588 conform
* USB 2.0 OTG high-speed
* USB 2.0 host high speed
* Full function UART [2]
* Standard UART with hardware handshake support
* Standard UART
 [1] On module microSD card socket is only available if second CAN port is not connected.
 [2] CTS and RTS is only available if second CAN port is not connected.
|valign="top" style="border: 0pt;" |
* 2x CAN interface [1][2]
* 2x SPI interface
* 2x I²C interface
* I²S Audio codec (1 x microphone, 1 x Line in, 1x Line out)
* Real-time clock (I²C connection), low power temperature compensated
* 12 bit analog input
* 128 Bytes EEPROM with integrated MAC address
* 16 bit address/databus interface on SODIMM-200 socket
* PWM channel
* 24 GPIOs (A-W + INT_HI_PRIO)
* JTAG debug connection via FFC plug connector
* Industrial temperature range (-40°C to +85°C)
* SODIMM-200 socket with DHCOM pin assignment
|}

*[[COM iMX6 Hardware|Hardware Support]]

== Product Change Notifications (PCN) ==
* [[media:PCN_iMX6_R01_2017-08-17.pdf|PCN_iMX6_R01_2017-08-17.pdf (4GByte eMMC)]]
* [[media:PCN_iMX6_R02_2017-08-17.pdf|PCN_iMX6_R02_2017-08-17.pdf (8GByte eMMC)]]
* [[media:PCN_iMX6_R03_2017-09-20.pdf|PCN_iMX6_R03_2017-09-20.pdf (SW ethernet bug)]]
* [[media:PCN_iMX6_R04_2017-09-25.pdf|PCN_iMX6_R04_2017-09-25.pdf (Molex microSD socket)]]
* [[media:PCN_iMX6_R05_2018-01-10.pdf|PCN_iMX6_R05_2018-01-10.pdf (512MB NAND flash)]]
* [[media:PCN_iMX6_R06_2018-10-09.pdf|PCN_iMX6_R06_2018-10-09.pdf (label change)]]
* [[media:PCN_iMX6_R07_2019-11-13.pdf|PCN_iMX6_R07_2019-11-13.pdf (4GByte eMMC)]]
* [[media:PCN_iMX6_R08_2019-11-13.pdf|PCN_iMX6_R08_2019-11-13.pdf (8GByte eMMC)]]
* [[media:PCN_iMX6-009_R01_2021-07-20.pdf|PCN_iMX6-009_R01_2021-07-20.pdf (SPI flash EOL)]]

== Software Support ==
*[[COM iMX6 Bootloader U-Boot|i.MX6: Bootloader U-Boot]]
*[[COM iMX6 Linux|i.MX6: Linux]]
*[[DHCOM Update Mechanism|DHCOM Update Mechanism]]
*[[Yocto | Yocto on DHCOM]]
*[[COM iMX6 WinCE|i.MX6: WinCE]]

== BSP Sources==
==== [https://www.denx.de/wiki/U-Boot U-Boot] ====
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/legacy/2018.05_dhcom DH U-Boot (based on v2018.05)]
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/2015.10_dhcom DH U-Boot (based on v2015.10)]
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/2013.10_dhcom DH U-Boot (based on v2013.10)]

==== [https://www.kernel.org Linux Kernel] ====
* Mainline
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/dev/4.4.60_dhcom DH 4.4.60 Development]
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/release/4.4.60_dhcom/20190926 DH 4.4.60 Release 2019-09-26 (Yocto reference)]
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/dev/3.14.12_dhcom DH 3.14.12 Development]
* NXP Vendor
:* [https://github.com/dh-electronics/linux-imx6-vendor/tree/release/v4.1.15/20190624 DH 4.1.15 Release 2019-06-24 (Yocto reference)]
:* [https://github.com/dh-electronics/linux-imx6-vendor/tree/release/v3.10.17/20170804 DH 3.10.17 Release 2017-08-04 (Yocto reference)]

== Download binaries/images ==
==== U-Boot (for eMMC DHCOMs) ====
* [[media:U-boot-with-spl_imx6_v2.0.9.0_emmc.imx|DH U-Boot v2.0.9.0 (based on v2018.05)]]
* [[media:V1-1-0-8_u-boot-imx6qdl.tar.xz|DH U-Boot v1.1.0.8 (based on v2015.10)]]
: More on how to program it with the U-Boot command "update bootloader ..." on the page [[DHCOM Update Mechanism#Commandline Mode|"DHCOM Update Mechanism"]]

==== Update Kernel ====
* [[media:2020-07-27_imx6_updatekernel.zip|Update Kernel Release 2020-07-27]]
: More on how to use it on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

==== Debian based images ====
* Debian 8 "Jessie" + Kernel 4.4.60 Release 2020-03-03

:* [[media:HD00035_2020-03-03_imx6_jessie_sdcard_2000MB.img.xz|SD card: 2GB image (xz compressed)]]
:: Open it with Disks by double click on Debian Linux. Use [https://www.balena.io/etcher balenaEtcher] on Windows.

:* [[media:HD00035_2020-03-03_imx6_jessie_USB_stick_update.zip|eMMC: USB stick update image]]
:: Extract the files on a USB stick (MBR / FAT32) and insert it into your board / device. More about the files on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

* Debian 8 "Jessie" with Qt5.9.1 + Vendor Kernel 4.1.15 Release 2019-09-26

:* [[media:HD00039_2019-09-26_imx6_jessie_qt5.9.1_sdcard_2000MB.img.xz|SD card: 2GB image (xz compressed)]]
:: Open it with Disks by double click on Debian Linux. Use [https://www.balena.io/etcher balenaEtcher] on Windows.

:* [[media:HD00039_2019-09-26_imx6_jessie_qt5.9.1_USB_stick_update.zip|eMMC: USB stick update image]]
:: Extract the files on a USB stick (MBR / FAT32) and insert it into your board / device. More about the files on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

Hint: You can also progam the eMMC by using the [[COM iMX6 Bootloader U-Boot#USB Mass Storage|U-Boot command "ums"]] (usable since U-Boot v2018.05)

== Download Linux code examples ==
==== [[Virtual Machine for Application Development#Code Examples for Userspace-Applications to Access SPI, I2C, GPIOs, and more|Code Examples for Userspace-Applications to Access SPI, I2C, GPIOs, and more]] ====

== Download WEC ==
==== WEC7 DHHalLib.dll (function library) ====
* [[media:DHHalLib_WEC7_R06_2021-10-01.zip|Download DHHalLib Library Version 1.3.0.2]]
* [[media:DHHalLib_Test_App_Source_R04_2021_09_28.zip|DHHalLib Demo App Source Code ]]
* [[media:DHHalLib_Test_App_Binary_WEC7_R05_2021-10-01.zip|DHHalLib Demo App Binary File]]
* [[media:CSharp_LibWrapper.zip|Download DHHalLib CSharp Demo Wrapper App ]]
* [[media:CSharp_LibWrapper_Binary.zip|Download DHHalLib CSharp Demo Wrapper App Binary File]]

==== WEC7 binary BSP ====
* [[media:2016-05-19_DHCOM_iMX6_BSP_BIN.zip|Download WEC7 binary BSP (date: 2016-05-19)]]

==== WEC2013 DHHalLib.dll (function library) ====
* [[media:DHHalLib_WEC2013_R12_2021-10-01.zip|Download DHHalLib Library Version 1.4.2.2]]
* [[media:DHHalLib_Test_App_Source_WEC2013_R07_2018_06_12.zip|DHHalLib Demo App Source Code ]]
* [[media:DHHalLib_Test_App_Binary_WEC2013_R09_2021-10-01.zip|DHHalLib Demo App Binary File]]
* [[media:CSharp_LibWrapper_Source_WEC2013_R07_2021-10-01.zip|Download DHHalLib CSharp Wrapper]]
* [[media:CSharp_DHHalLib_Wrapper_App_Source_WEC2013_R05_2017_08_08.zip|DHHalLib C# Demo App Source Code]]
* [[media:CSharp_DHHalLib_Wrapper_App_Binary_WEC2013_R05_2017_08_08.zip|DHHalLib C# Demo App Binary File]]

File:DHHalLib Test App Binary WEC7 R05 2021-10-01.zip

2021-10-01T15:52:44Z

Capfel:

DHCOM iMX6-D2

2021-10-01T15:31:22Z

Capfel: /* WEC7 DHHalLib.dll (function library) */

{|
|
|
|-
|__TOC__
|[[Image:IM6Modul.png|600px|COM iMX6-D2]]
|}

== Hardware ==

{| class="wikitable" align="center" | style="width: 100%; color: #000000; background: #f3f3f3;" valign="top" |
|-
| style="width: 50%; background: #076b8d; border: 0pt;" |
| style="width: 50%; background: #076b8d; border: 0pt;" |
|-
|valign="top" style="border: 0pt;" |
* '''Cortex-A9 Freescale i.MX6 Solo/DualLite/Dual/Quad up to 1.2GHz'''
* 2D (GC320) / 3D (GC880/GC2000) graphics accelerator
* 128 - 1024 MByte NAND flash memory (8 bit bus width) or 4 - 16 GByte eMMC flash (8 bit bus width)
* 2 MB SPI boot flash
* 256 - 2048 MByte DDR3-1066 or DDR3-800
* On module microSD card socket (4 bit SDIO) [1]
* SD/MMC card interface, 4 bit SDIO
* LC display controller, 24 bit colors, 2048x1536 pixels
* LVDS 4-channel, max. 165 Mpixels/s
* On-board touch controller for 4-wire resistive touch screens
* Ethernet controller 10/100 Mbit, IEEE1588 conform
* USB 2.0 OTG high-speed
* USB 2.0 host high speed
* Full function UART [2]
* Standard UART with hardware handshake support
* Standard UART
 [1] On module microSD card socket is only available if second CAN port is not connected.
 [2] CTS and RTS is only available if second CAN port is not connected.
|valign="top" style="border: 0pt;" |
* 2x CAN interface [1][2]
* 2x SPI interface
* 2x I²C interface
* I²S Audio codec (1 x microphone, 1 x Line in, 1x Line out)
* Real-time clock (I²C connection), low power temperature compensated
* 12 bit analog input
* 128 Bytes EEPROM with integrated MAC address
* 16 bit address/databus interface on SODIMM-200 socket
* PWM channel
* 24 GPIOs (A-W + INT_HI_PRIO)
* JTAG debug connection via FFC plug connector
* Industrial temperature range (-40°C to +85°C)
* SODIMM-200 socket with DHCOM pin assignment
|}

*[[COM iMX6 Hardware|Hardware Support]]

== Product Change Notifications (PCN) ==
* [[media:PCN_iMX6_R01_2017-08-17.pdf|PCN_iMX6_R01_2017-08-17.pdf (4GByte eMMC)]]
* [[media:PCN_iMX6_R02_2017-08-17.pdf|PCN_iMX6_R02_2017-08-17.pdf (8GByte eMMC)]]
* [[media:PCN_iMX6_R03_2017-09-20.pdf|PCN_iMX6_R03_2017-09-20.pdf (SW ethernet bug)]]
* [[media:PCN_iMX6_R04_2017-09-25.pdf|PCN_iMX6_R04_2017-09-25.pdf (Molex microSD socket)]]
* [[media:PCN_iMX6_R05_2018-01-10.pdf|PCN_iMX6_R05_2018-01-10.pdf (512MB NAND flash)]]
* [[media:PCN_iMX6_R06_2018-10-09.pdf|PCN_iMX6_R06_2018-10-09.pdf (label change)]]
* [[media:PCN_iMX6_R07_2019-11-13.pdf|PCN_iMX6_R07_2019-11-13.pdf (4GByte eMMC)]]
* [[media:PCN_iMX6_R08_2019-11-13.pdf|PCN_iMX6_R08_2019-11-13.pdf (8GByte eMMC)]]
* [[media:PCN_iMX6-009_R01_2021-07-20.pdf|PCN_iMX6-009_R01_2021-07-20.pdf (SPI flash EOL)]]

== Software Support ==
*[[COM iMX6 Bootloader U-Boot|i.MX6: Bootloader U-Boot]]
*[[COM iMX6 Linux|i.MX6: Linux]]
*[[DHCOM Update Mechanism|DHCOM Update Mechanism]]
*[[Yocto | Yocto on DHCOM]]
*[[COM iMX6 WinCE|i.MX6: WinCE]]

== BSP Sources==
==== [https://www.denx.de/wiki/U-Boot U-Boot] ====
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/legacy/2018.05_dhcom DH U-Boot (based on v2018.05)]
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/2015.10_dhcom DH U-Boot (based on v2015.10)]
* [https://github.com/dh-electronics/u-boot-imx6qdl/tree/dev/2013.10_dhcom DH U-Boot (based on v2013.10)]

==== [https://www.kernel.org Linux Kernel] ====
* Mainline
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/dev/4.4.60_dhcom DH 4.4.60 Development]
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/release/4.4.60_dhcom/20190926 DH 4.4.60 Release 2019-09-26 (Yocto reference)]
:* [https://github.com/dh-electronics/linux-imx6qdl/tree/dev/3.14.12_dhcom DH 3.14.12 Development]
* NXP Vendor
:* [https://github.com/dh-electronics/linux-imx6-vendor/tree/release/v4.1.15/20190624 DH 4.1.15 Release 2019-06-24 (Yocto reference)]
:* [https://github.com/dh-electronics/linux-imx6-vendor/tree/release/v3.10.17/20170804 DH 3.10.17 Release 2017-08-04 (Yocto reference)]

== Download binaries/images ==
==== U-Boot (for eMMC DHCOMs) ====
* [[media:U-boot-with-spl_imx6_v2.0.9.0_emmc.imx|DH U-Boot v2.0.9.0 (based on v2018.05)]]
* [[media:V1-1-0-8_u-boot-imx6qdl.tar.xz|DH U-Boot v1.1.0.8 (based on v2015.10)]]
: More on how to program it with the U-Boot command "update bootloader ..." on the page [[DHCOM Update Mechanism#Commandline Mode|"DHCOM Update Mechanism"]]

==== Update Kernel ====
* [[media:2020-07-27_imx6_updatekernel.zip|Update Kernel Release 2020-07-27]]
: More on how to use it on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

==== Debian based images ====
* Debian 8 "Jessie" + Kernel 4.4.60 Release 2020-03-03

:* [[media:HD00035_2020-03-03_imx6_jessie_sdcard_2000MB.img.xz|SD card: 2GB image (xz compressed)]]
:: Open it with Disks by double click on Debian Linux. Use [https://www.balena.io/etcher balenaEtcher] on Windows.

:* [[media:HD00035_2020-03-03_imx6_jessie_USB_stick_update.zip|eMMC: USB stick update image]]
:: Extract the files on a USB stick (MBR / FAT32) and insert it into your board / device. More about the files on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

* Debian 8 "Jessie" with Qt5.9.1 + Vendor Kernel 4.1.15 Release 2019-09-26

:* [[media:HD00039_2019-09-26_imx6_jessie_qt5.9.1_sdcard_2000MB.img.xz|SD card: 2GB image (xz compressed)]]
:: Open it with Disks by double click on Debian Linux. Use [https://www.balena.io/etcher balenaEtcher] on Windows.

:* [[media:HD00039_2019-09-26_imx6_jessie_qt5.9.1_USB_stick_update.zip|eMMC: USB stick update image]]
:: Extract the files on a USB stick (MBR / FAT32) and insert it into your board / device. More about the files on the page [[DHCOM Update Mechanism|"DHCOM Update Mechanism"]]

Hint: You can also progam the eMMC by using the [[COM iMX6 Bootloader U-Boot#USB Mass Storage|U-Boot command "ums"]] (usable since U-Boot v2018.05)

== Download Linux code examples ==
==== [[Virtual Machine for Application Development#Code Examples for Userspace-Applications to Access SPI, I2C, GPIOs, and more|Code Examples for Userspace-Applications to Access SPI, I2C, GPIOs, and more]] ====

== Download WEC ==
==== WEC7 DHHalLib.dll (function library) ====
* [[media:DHHalLib_WEC7_R06_2021-10-01.zip|Download DHHalLib Library Version 1.3.0.2]]
* [[media:DHHalLib_Test_App_Source_R04_2021_09_28.zip|DHHalLib Demo App Source Code ]]
* [[media:DHHalLib_Test_App_Binary_R04_2021_09_28.zip|DHHalLib Demo App Binary File]]
* [[media:CSharp_LibWrapper.zip|Download DHHalLib CSharp Demo Wrapper App ]]
* [[media:CSharp_LibWrapper_Binary.zip|Download DHHalLib CSharp Demo Wrapper App Binary File]]

==== WEC7 binary BSP ====
* [[media:2016-05-19_DHCOM_iMX6_BSP_BIN.zip|Download WEC7 binary BSP (date: 2016-05-19)]]

==== WEC2013 DHHalLib.dll (function library) ====
* [[media:DHHalLib_WEC2013_R12_2021-10-01.zip|Download DHHalLib Library Version 1.4.2.2]]
* [[media:DHHalLib_Test_App_Source_WEC2013_R07_2018_06_12.zip|DHHalLib Demo App Source Code ]]
* [[media:DHHalLib_Test_App_Binary_WEC2013_R09_2021-10-01.zip|DHHalLib Demo App Binary File]]
* [[media:CSharp_LibWrapper_Source_WEC2013_R07_2021-10-01.zip|Download DHHalLib CSharp Wrapper]]
* [[media:CSharp_DHHalLib_Wrapper_App_Source_WEC2013_R05_2017_08_08.zip|DHHalLib C# Demo App Source Code]]
* [[media:CSharp_DHHalLib_Wrapper_App_Binary_WEC2013_R05_2017_08_08.zip|DHHalLib C# Demo App Binary File]]