COM iMX25 WinCE - Revision history

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T14:42:04Z

DHHalLib (function library)

← Older revision		Revision as of 16:42, 12 November 2012
Line 240:		Line 240:
	:: This function sets the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>to the value 0. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.		:: This function sets the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone" </code>to the value 0. For saving the value permanent please call <code>SaveRegistry() </code>afterwards.
	:Return value: <code>bool</code> --> true = success; false = failed		: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>''
			\|}

			:'''Set Watchdog Timer'''
			:{\| class="wikitable"
			\|''<code> void SetWatchdog(unsigned char cTime) </code>''
			\|}
			:Input values:
			::<code>unsigned char cTime</code> = Watchdog timeout value (0 = 0.5sec., 1 = 1.0sec., ...)

			:'''Retrigger Watchdog Timer'''
			:{\| class="wikitable"
			\|''<code> void ReloadWatchdog() </code>''
			\|}

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T14:32:29Z

DHHalLib (function library)

@@ Line 231: / Line 231: @@
 :Description:
 :: This function sets the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone"</code> to the value 1. For saving the value permanent please call <code>SaveRegistry()</code> afterwards.
 :Return value: <code>bool</code> --> true = success; false = failed

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T12:32:28Z

DHHalLib (function library)

← Older revision		Revision as of 14:32, 12 November 2012
Line 229:		Line 229:
	\|''<code> bool SaveTouchCalibrationData() </code>''		\|''<code> bool SaveTouchCalibrationData() </code>''
	\|}		\|}
			:Description:
			:: This function sets the registry entry <code>[HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\TOUCH] dword:"TouchCalibrationDone"</code> to the value 1. For saving the value permanent please call <code>SaveRegistry()</code> afterwards.
	:Return value: <code>bool</code> --> true = success; false = failed		:Return value: <code>bool</code> --> true = success; false = failed

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T11:32:32Z

DHHalLib (function library)

← Older revision		Revision as of 13:32, 12 November 2012
Line 207:		Line 207:
	::<code>ULONG NumberOfBytes </code> = Number of mapped bytes		::<code>ULONG NumberOfBytes </code> = Number of mapped bytes
	:Note: From WinCE 6, the function <code> MmUnmapIoSpace() </code> can not be called from the user mode. THis library function provides a workaround.		:Note: From WinCE 6, the function <code> MmUnmapIoSpace() </code> can not be called from the user mode. THis library function provides a workaround.


			=== Backlight ===
			:'''PWM'''
			:{\| class="wikitable"
			\|''<code> bool SetBacklightPWM(int iPercent) </code>''
			\|}
			:Input values:
			::<code>int iPercent</code> = Backlight brightness in percent
			: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

			:'''Save calibration data'''
			:{\| class="wikitable"
			\|''<code> bool SaveTouchCalibrationData() </code>''
			\|}
			:Return value: <code>bool</code> --> true = success; false = failed

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T11:26:54Z

DHHalLib (function library)

← Older revision		Revision as of 13:26, 12 November 2012
Line 29:		Line 29:

	== DHHalLib (function library) ==		== DHHalLib (function library) ==
			The DHHalLib provides hardware related functions for Windows Embedded CE 6 and Windows Embedded Compact 7. All the functionality is available from the user mode.
	=== Version numbers ===		=== Version numbers ===
	:'''Read DHHalLib version'''		:'''Read DHHalLib version'''

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T11:26:12Z

DHHalLib (function library)

← Older revision		Revision as of 13:26, 12 November 2012
Line 165:		Line 165:
	::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name		::<code>DHCOM_GPIOEnum eGpio</code> = DHCOM GPIO pin name
	:Return value: <code>bool</code> --> 0 = low; 1 = high		:Return value: <code>bool</code> --> 0 = low; 1 = high

			=== Memory ===
			:'''Read physical address'''
			:{\| class="wikitable"
			\|''<code> int ReadPhysicalAddress(int iPhyAddr, unsigned char cRegSize) </code>''
			\|}
			:Input values:
			::<code>int iPhyAddr</code> = Physical address
			::<code>unsigned char cRegSize</code> = Register size (16 = 16bit; 32 = 32bit)
			:Return value: <code>int</code> --> current value of the physical address

			:'''Write physical address'''
			:{\| class="wikitable"
			\|''<code> int WritePhysicalAddress( int iPhyAddr, unsigned char cRegSize, int iValue, bool bReadBack) </code>''
			\|}
			:Input values:
			::<code>int iPhyAddr</code> = physical address
			::<code>unsigned char cRegSize</code> = Register size (16 = 16bit; 32 = 32bit)
			::<code>int iValue</code> = Value to be written
			::<code>bool bReadBack</code> = true --> the current value is read back after the write; false --> the current value isn’t read back after the write
			:Return value: <code>int</code> --> content of the physical address after write, if <code>bReadBack</code> = true. Otherwise the function returns 0.

			:'''Map physical memory'''
			:{\| class="wikitable"
			\|''<code> PVOID UserMmMapIoSpace(ULONG PhysicalAddress, ULONG NumberOfBytes, BOOLEAN CacheEnable) </code>''
			\|}
			:Input values:
			::<code>ULONG PhysicalAddress </code>= physical address
			::<code>ULONG NumberOfBytes </code>= Number of bytes to map
			::<code>BOOLEAN CacheEnable</code> = true --> Cached memory map; false --> Uncached memory map
			:Return value: <code>PVOID</code> --> virtual base address of the mapped memory
			:Note: From WinCE 6, the function <code> MmMapIoSpace()</code> can not be called from the user mode. THis library function provides a workaround.

			:'''UnMap physical memory'''
			:{\| class="wikitable"
			\|''<code> void UserMmUnmapIoSpace(PVOID BaseAddress, ULONG NumberOfBytes) </code>''
			\|}
			:Input values:
			::<code>PVOID BaseAddress </code> = pointer to virtual base address of the mapped memory
			::<code>ULONG NumberOfBytes </code> = Number of mapped bytes
			:Note: From WinCE 6, the function <code> MmUnmapIoSpace() </code> can not be called from the user mode. THis library function provides a workaround.

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T11:04:17Z

DHHalLib (function library)

← Older revision		Revision as of 13:04, 12 November 2012
Line 110:		Line 110:
	::<code>unsigned char iDevId</code> = I2C device address (0..127)		::<code>unsigned char iDevId</code> = I2C device address (0..127)
	:Return value: <code>bool</code> --> true = success; false = failed		:Return value: <code>bool</code> --> true = success; false = failed

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

			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_NOT_DEFINED
			};

			:'''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

Ageisreiter: /* I2C */

2012-11-12T10:51:31Z

I2C

← Older revision		Revision as of 12:51, 12 November 2012
Line 83:		Line 83:
	::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)		::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)
	::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)		::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
	::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true  stop bit is generated)		::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true --> stop bit is generated)
	::<code>unsigned char *pOutBuffer</code> = Pointer to the read buffer		::<code>unsigned char *pOutBuffer</code> = Pointer to the read buffer
	:Return value: <code>bool</code> --> true = success; false = failed		:Return value: <code>bool</code> --> true = success; false = failed
Line 96:		Line 96:
	::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)		::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)
	::<code>unsigned char cBytes</code> = Number of bytes to be written (max. 255)		::<code>unsigned char cBytes</code> = Number of bytes to be written (max. 255)
	::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true  stop bit is generated)		::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true --> stop bit is generated)
	::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer		::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
	:Return value: <code>bool</code> --> true = success; false = failed		:Return value: <code>bool</code> --> true = success; false = failed

Ageisreiter: /* DHHalLib (function library) */

2012-11-12T10:50:55Z

DHHalLib (function library)

← Older revision		Revision as of 12:50, 12 November 2012
Line 29:		Line 29:

	== DHHalLib (function library) ==		== DHHalLib (function library) ==
			=== 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)

			=== I2C ===
			:'''Read'''
			:{\| class="wikitable"
			\|''<code> bool I2CRead( unsigned char cI2CPort, unsigned char cDevId, unsigned char cI2CReg, bool bSendStop, unsigned char *pOutBuffer) </code>''
			\|}
			:Input values:
			::<code>unsigned char cI2CPort</code> = DHCOM I2C port number (1.. 2)
			::<code>unsigned char iDevId</code> = I2C device address (0..127)
			::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)
			::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true --> stop bit is generated)
			::<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( unsigned char cI2CPort, unsigned char cDevId, unsigned char cI2CReg, unsigned char cValue, bool bSendStop) </code>''
			\|}
			:Input values:
			::<code>unsigned char cI2CPort</code> = DHCOM I2C port number (1.. 2)
			::<code>unsigned char iDevId</code> = I2C device address (0..127)
			::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)
			::<code>unsigned char iValue</code> = Value to be written
			::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true --> stop bit is generated)
			:Return value: <code>bool</code> --> true = success; false = failed

			:'''Read multiple bytes'''
			:{\| class="wikitable"
			\|''<code> bool I2CReadMultipleBytes( unsigned char cI2CPort, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, bool bSendStop, unsigned char *pOutBuffer) </code>''
			\|}
			:Input values:
			::<code>unsigned char cI2CPort</code> = DHCOM I2C port number (1.. 2)
			::<code>unsigned char iDevId</code> = I2C device address (0..127)
			::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)
			::<code>unsigned char cBytes</code> = Number of bytes to be read (max. 255)
			::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true  stop bit is generated)
			::<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( unsigned char cI2CPort, unsigned char cDevId, unsigned char cI2CReg, unsigned char cBytes, bool bSendStop, unsigned char *pInBuffer)</code>''
			\|}
			:Input values:
			::<code>unsigned char cI2CPort</code> = DHCOM I2C port number (1.. 2)
			::<code>unsigned char iDevId</code> = I2C device address (0..127)
			::<code>unsigned char iI2CReg</code> = I2C device register address (0..255)
			::<code>unsigned char cBytes</code> = Number of bytes to be written (max. 255)
			::<code>bool bSendStop</code> = send or not send stop bit at the end of the transfer (true  stop bit is generated)
			::<code>unsigned char *pInBuffer</code> = Pointer to the input buffer
			:Return value: <code>bool</code> --> true = success; false = failed

			:'''Bus scan'''
			:{\| class="wikitable"
			\|''<code> bool I2CProbe(unsigned char cI2CPort, unsigned char cDevId)</code>''
			\|}
			:Description:
			::Scans the bus for the specified device address. Is this achievable, then the function returns "true".
			:Input values:
			::<code>unsigned char cI2CPort</code> = DHCOM I2C port number (1.. 2)
			::<code>unsigned char iDevId</code> = I2C device address (0..127)
			:Return value: <code>bool</code> --> true = success; false = failed

Ageisreiter at 10:28, 12 November 2012

2012-11-12T10:28:17Z

← Older revision		Revision as of 12:28, 12 November 2012
Line 27:		Line 27:
	[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\NAND_Flash]		[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\NAND_Flash]
	“FlashDiskBaseAddress“=dword:02000000 ; Configures the WinCE NAND FlashDisk Base address		“FlashDiskBaseAddress“=dword:02000000 ; Configures the WinCE NAND FlashDisk Base address

			== DHHalLib (function library) ==