Action Index Form
Light sensor Stylus GSensor NavSensor Proximity Sensor
Settings Keyboard BattClock Color Picker Settings TAPI Other About

Custom Search

   4. Settings
   4.1 Index
   4.2 Light Sensor
   4.3 Stylus Sensor
   4.4 G Sensor Orientation
   4.5 Capacitive Nav Sensor
   4.6 Proximity Sensor
   4.7 Keyboard Sensor
   4.8 BattClock
   4.9 Telephone API
   4.10 Software Input Panel
   4.11 Other Settings
   4.12 About
   4.13 Command line usage

4. Settings

Via the separate program TouchLockAction, TouchLockPro can be tuned at your specific needs. You can start TouchLockAction by pressing the BattClock or via Programs. The TouchLockAction screen will appear. The meaning of the action buttons, from left to right, top to bottom:

First row:

LockScreen (and keep the display on, temporily disable unlock on light sensor and suspend on backlight off)

LockSuspend (and suspend immediately, screen off)

Exit the Action screen

Second row:

Open the Configuration settings

Soft reset your device

Power off the phone completely (you do no longer need to long press Power Off)

So press the Configuration settings icon, to start the Configuration Settings Screens. The default values are chosen, so it works already out of the box. So do not be scared about the possibilities of tuning TouchLockPro, you only need to do that, when you want different behaviour. The next chapters explain in detail the different configuration options.

It is also possible to overrule the default settings via registry: HKCU\Software\ZuinigeRijder\LockSettings Please use a registry editor to create the DWORD values, e.g. PHM RegEdit. A value of 0 means No and a value of 1 means Yes. The default DWORD value is also mentioned. Please make sure to do a soft reset after adding the appropriate overrule settings via a registry editor. You only need to define the values you want to overrule.

Easier is to use the Settings screens of TouchLockAction, because then no soft reset is needed and it is more user friendly. The changed settings are auto-saved when the next or previous/index button is pressed. The saved settings are immediately picked up by TouchLockPro, so you do not need to soft-reset or disable/enable TouchLockPro.

4.1 Index

Via the index screen, you can fast jump to the appropriate settings screen. First Select your PhoneType out of the available list if it is not correct guessed. This will already disable the sensors not supported by your phone type. You can also go through all the settings screens in sequence, by pressing the Next softkey on each Settings screen. The Home softkey, goes back to the initial TouchLockAction screen. The middle softkey is the current selected SIP (Software Input Panel) and can be used when information needs to be typed in.

4.2 Light Sensor

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen.

Use Light Sensor

This is a convenience setting, for enabling/disabling the light sensor. Actually, it switches the UnlockOnLightSensorTime between 0 and the 1500.

UnlockOnLightSensor (UnlockOnLightSensor = 1)

Default it will unlock when the light sensor senses light for some time. If you do not want unlocking by the light sensor, overrule this registry key with "UnlockOnLightSensor = 1".

UnlockOnLightSensorTime (UnlockOnLightSensorTime = 1500 decimal)

Default it will auto unlock when the Light Sensor senses light above a certain level (see UnlockOnLightMinimumValue) for the specified time in milliseconds. If you do not want to have auto unlock by the Light Sensor, overrule this registry key with "UnlockOnLightSensorTime = 0".

UnlockOnLightMinimumValue (UnlockOnLightMinimumValue = 1)

When the Light Sensor senses light equal and above this level, it will be seen as sensing light. The value can range from 1 to 255. However, the light sensor is not so sensitive, so in relative dark ligthing conditions it will not react. Therefore the default value is the lowest possible. If you want to have a higher light level, e.g. because you do wear your phone in a blouse with light shining through, increase this value.

4.3 Stylus Sensor

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen. The current Stylus Status is shown upper right (In, Out, Unknown)..

4.4 G Sensor Orientation

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen. The current G Sensor Status is shown upper right.

Use G Sensor

This is a convenience setting, for enabling/disabling the G Sensor. Actually, it switches the GSensor Time (CmdOrientationTime) between 0 and the 5000.

Use G Sensor When Unlocked (CmdOrientationWhenUnlocked = 1)

Default the GSENSOR orientation commands can be executed when locked or unlocked (screen is on). When you only want the commands to be executed when locked, you can overrule this setting with CmdOrientationWhenUnlocked = 0. Then it will only poll the GSENSOR when locked. If you want to disable the whole GSENSOR, configure Time (CmdOrientationTime = 0).

Time (CmdOrientationTime = 5000)

GSENSOR Orientation change Time in milliseconds for command execution. There can be 4 gesture commands and sequences configured. If the number of orientation changes have not been done within this time, counting is started from 0. If you do not want the GSENSOR orientation changes for command execution (do not want to have the resource usage), specify 0. Note that the GSENSOR is only used when the screen is on.

Sequence 1, CmdOrientationSequence1 = 343 (PORTRAIT, UPSIDE_DOWN, PORTRAIT)

Sequence 1 command, CmdOrientation1 = "!UNLOCK"

Sequence 2, CmdOrientationSequence2 = 365 (PORTRAIT, FACE_UP, FACE_DOWN)

Sequence 2 command, CmdOrientation2 = "!LOCKSUSPEND"

Sequence 3, CmdOrientationSequence3 = 356 (PORTRAIT, FACE_DOWN, FACE_UP)

Sequence 3 command, CmdOrientation3 = "!LOCKSCREEN"

Sequence 4, CmdOrientationSequence4 = 343 (Not used, PORTRAIT, UPSIDE_DOWN, PORTRAIT)

Sequence 4 command, CmdOrientation4 = "!UNLOCK"

The correct GSENSOR orientation sequence changes are counted and if the configured sequence is reached within the specified time, the phone will execute the corresponding command. The orientation sequence can be configured for 4 commands, each command sequence can contain combinations of orientation changes. The following orientation changes are supported by the TouchLockPro:

LANDSCAPE
REVERSE_LANDSCAPE
PORTRAIT
UPSIDE_DOWN
FACE_DOWN
FACE_UP
LANDSCAPE or REVERSE_LANDSCAPE
PORTRAIT or UPSIDE_DOWN
Any of the above

So you can do your own orientation gesture which suits you the best for command execution. The default sequence is 343 (so the sequence Portrait-UpsideDown-Portrait will unlock). Note that you should not do the moves too fast, because the standard polling interval is about 200 ms for detecting the orientation changes. In the battclock, a negative number will be shown as the number of orientation changes for the first sequence (when locked), till then. The command to execute when the corresponding orientation sequence is correct. Note that TouchLockPro has the builtin commands:

!UNLOCK (unlock)

!LOCKSCREEN (lock screen)

!LOCKSUSPEND (lock screen and request power state suspend)

!SUSPEND (request power state suspend)

!TOGGLELOCK (unlock/backlight on OR locksuspend)

!BACKLIGHTOFF (request backlight off)

!BACKLIGHTON (request backlight on)

!IDLE (request power state user idle)

!SCREENOFF (request screen off)

!SCREENON (request screen on)

!KEEPALIVEON (sensors keep working (e.g. for !BACKLIGHTON;!KEEPALIVEON swipe), phone will be kept alive, great for in combination with e.g. GPS)

!KEEPALIVEOFF

!TOUCHLOCKACTION (start TouchLockAction)

!PROXIMITYDISABLE (disable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYENABLE (enable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYIGNORE (ignore proximity changes, other programs can still react)

!PROXIMITYACCEPT (accept proximity changes and execute the configured commands)

!HOME (goto HOME screen)

!SOFTRESET (soft reset)

!POWEROFF (power off)

But you can also configure external commands, e.g. "OperaL.exe".

4.5 Capacitive Nav Sensor

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen. The last Nav Sensor Status is shown upper right.

Use Capacitive Nav Sensor

This is a convenience setting, for enabling/disabling the Nav Sensor. Actually, it switches the CapacitiveToggleTime between 0 and the 3000.

Use Zoombar (UseZoombar = 1)

Setting to enable/disable Zoombar.

CapacitiveCommandsWhenUnlocked (CapacitiveCommandsWhenUnlocked = 1)

Default the capacitive commands can be executed when locked or unlocked (screen is on). When you only want the commands to be executed when locked, you can overrule this setting with CapacitiveCommandsWhenUnlocked = 0. Then it will only poll the capacitive sensor when locked. If you want to disable the whole capacitive sensor, configure CapacitiveToggleTime = 0.

TF3DWorkaround (TF3DWorkaround = 1)

Enable/disable the TF3D workaround (tab right - tab left at power on and when on the TFD Home screen) for the HTC bug of capacitive sensor not always working when on home screen of TF3D. The workaround is only triggered, if the phone is still locked after 5 seconds and when the TF3D is the home foreground screen. One way or the other, TF3D Today home screen in the newer HTC ROM's (i.e. 2.03) is blocking the capacitive touches sometimes. But not always. Non TF3D users will not see any difference. If you use an older ROM (e.g. 1.93), then you can disable the workaround. If you do not like the workaround, you can disable it, but there will be a chance that the capacitive touches are not working. You need to unlock then via the other solutions (e.g. Stylus out is the quickest then). I am still searching for a better solution for the problem introduced by HTC.

CapacitiveToggleTime (CapacitiveToggleTime = 3000 or BB8 hexadecimal)

By default, triple touching the capacitive area is 3000 milliseconds to unlock. Overrule this registry key with another milliseconds value, if you need more or less time. If you specify 0, you cannot unlock via triple touch.

CapacitiveTouchesSequence (CapacitiveTouchesSequence = 222)

The default configuration is to unlock touching three times the middle capacitive button or touching the ZoomBar. Note that you can also unlock by slide the ZoomBar (if your phone has one) far enough left or right. You can configure specific area's and the number of touches. Each number corresponds to one touch, indicating which area is valid. If you want to have only 2 touches of the middle button, configure 22.
Areas:

1 (left area)

2 (middle center button or touching Zoombar)

3 (right area)

4 (any area)

5 (left area 1 or right area 3)

6 (middle center button area 2 and area around the middle button)

You can also define your own secret sequence for unlocking, e.g. 1321. The touches sequence can be up to 8 touches. If you want to use this as a Security pin, make sure you disable the other locking features (UseStylus, UseSlider, UnlockOnACPower, UnlockOnLightSensor) and of course configure a Windows Mobile password. Note that capacitive touches do not work on a Touch HD.

Capacitive Swipe

Left Swipe Up (CmdLeftUp = "!BACKLIGHTON")

Left Swipe Down (CmdLeftDown = "!BACKLIGHTOFF;!KEEPALIVEON")

Left Swipe Right (CmdLeftRight = "!SCREENOFF;!KEEPALIVEON")

Left Swipe Left (CmdLeftLeft = "!SCREENON")

Right Swipe Up (CmdRightUp = "!UNLOCK")

Right Swipe Down (CmdRightDown = "!LOCKSCREEN")

Right Swipe Right (CmdRightRight = "!LOCKSUSPEND")

Right Swipe Left (CmdRightLeft = "!LOCKSUSPEND")

8 different (external) command can be coupled to Capacitive Swipes. Note that TouchLockPro has the builtin commands:

!UNLOCK (unlock)

!LOCKSCREEN (lock screen)

!LOCKSUSPEND (lock screen and request power state suspend)

!SUSPEND (request power state suspend)

!TOGGLELOCK (unlock/backlight on OR locksuspend)

!BACKLIGHTOFF (request backlight off)

!BACKLIGHTON (request backlight on)

!IDLE (request power state user idle)

!SCREENOFF (request screen off)

!SCREENON (request screen on)

!KEEPALIVEON (sensors keep working (e.g. for !BACKLIGHTON;!KEEPALIVEON swipe), phone will be kept alive, great for in combination with e.g. GPS)

!KEEPALIVEOFF

!TOUCHLOCKACTION (start TouchLockAction)

!PROXIMITYDISABLE (disable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYENABLE (enable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYIGNORE (ignore proximity changes, other programs can still react)

!PROXIMITYACCEPT (accept proximity changes and execute the configured commands)

!HOME (goto HOME screen)

!SOFTRESET (soft reset)

!POWEROFF (power off)

But you can also configure external commands, e.g. "OperaL.exe".

4.6 Proximity Sensor

Use Proximity (UseProximity = 0)

Default, the Proximity sensor will not be used. If your phone has a supported Proximity Sensor, you can overrule this registry key with "UseProximity = 1"

Proximity Sensor Time (ProximitySensorTime = 700)

The time in milliseconds how long the Proximity must be the same value to see as a change.

Near (CmdProximityNear = "!SUSPEND")

Command to execute when an object is detected near for the ProximitySensorTime. Default it will try to suspend the phone, so it will to a deep sleep if allowed by other programs. Note that it can include the commands !PROXIMITYENABLE, !PROXIMITYDISABLE, !PROXIMITYIGNORE and !PROXIMITYACCEPT.

Not Near (CmdProximityNotNear = "!UNLOCK")

Command to execute when no object is detected near for the ProximitySensorTime. Note that it can include the commands !PROXIMITYENABLE, !PROXIMITYDISABLE, !PROXIMITYIGNORE and !PROXIMITYACCEPT.

On Bluetooth (CmdProximityOnBluetooth = "")

Command to execute when bluetooth is active. Note that it can include the commands !PROXIMITYENABLE, !PROXIMITYDISABLE, !PROXIMITYIGNORE and !PROXIMITYACCEPT.

Lock (CmdLock = "!PROXIMITYACCEPT")

Command to execute when the phone gets locked. Note that this command is not specific to Proximity, so it can be usefull for other purposes too.

Unlock Call (CmdUnlockCall = "!PROXIMITYIGNORE")

Command to execute when the phone gets unlocked and there is a call active (incoming, connected). Note that this command is not specific to Proximity, so it can be usefull for other purposes too.

Unlock No Call (CmdUnlockNoCall = "!PROXIMITYIGNORE;!PROXIMITYDISABLE")

Command to execute when the phone gets unlocked and there is NO call active (incoming, connected). Note that this command is not specific to Proximity, so it can be usefull for other purposes too.

Note that TouchLockPro has the builtin commands:

!UNLOCK (unlock)

!LOCKSCREEN (lock screen)

!LOCKSUSPEND (lock screen and request power state suspend)

!SUSPEND (request power state suspend)

!TOGGLELOCK (unlock/backlight on OR locksuspend)

!BACKLIGHTOFF (request backlight off)

!BACKLIGHTON (request backlight on)

!IDLE (request power state user idle)

!SCREENOFF (request screen off)

!SCREENON (request screen on)

!KEEPALIVEON (sensors keep working (e.g. for !BACKLIGHTON;!KEEPALIVEON swipe), phone will be kept alive, great for in combination with e.g. GPS)

!KEEPALIVEOFF

!TOUCHLOCKACTION (start TouchLockAction)

!PROXIMITYDISABLE (disable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYENABLE (enable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYIGNORE (ignore proximity changes, other programs can still react)

!PROXIMITYACCEPT (accept proximity changes and execute the configured commands)

!HOME (goto HOME screen)

!SOFTRESET (soft reset)

!POWEROFF (power off)

4.7 Keyboard Sensor

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen. The last Keyboard Status is shown upper right (In, Out, Unknown).

Use Slider (UseSlider = 1)

Default, the keyboard Slider (if available) will be used for unlocking/locking. If you do not want this behaviour, overrule this registry key with "UseSlider = 0"

Suspend On Slider In (SuspendOnSliderIn = 1)

Default it will suspend when you slide the keyboard in when in lockmode. If you do not want this behaviour, overrule this registry key with "SuspendOnSliderIn = 0"

Slider Out Disabled LockMode (SliderOutDisablesLockMode = 1)

Default it will disable lockmode when you slide the keyboard out. If you do not want this behaviour, overrule this registry key with "SliderOutDisablesLockMode = 0"

HTCLockAPI (HTCLockAPI = 0)

There are 2 methods for locking the hardware keys in TouchLockPro. The HTC Lock API, locks all the keys (including the power button) and the TouchPanel. This HTC Lock API is only available on the newer HTC phones.

The other (new) key lock method is a general locking method, using a low level keyboard hook, which also works on other types of phones.

This keyboard hook keeps the power button unlocked and the press is not detected.

The TouchPanel is not locked (TouchLockPro has a separate TouchPanel hook)

This makes it possible also to lock only the hardware keys (e.g. in combination with Slide 2 Answer at incoming call)

The Home and Back keys are blocked, but still they are detected by the phone, so when pressed, the phone will still go to the Home screen.

The general keyboard hook, makes it possible to unlock more keys or detect keys pressed, so also an unlock key sequence can be specified.

On my Touch Diamond, unlocking the VolumeUp and VolumeDown does not work correctly. Although unlocked, the change is detected, but the volume will not change, while the volume screen is shown. Therefore the keyboard hook is only applied when locked, to avoid side effects like just mentioned.

Default it will use the general lock method. If you want the HTC Lock method, overrule this registry key with "HTCLockAPI = 1"

EnableInputAtSuspend (EnableInputAtSuspend = 1)

The HTC Lock API also locks the power button. To avoid power on button problems for some people/phones in combination with HTC Lock API (you enabled this one), this one is enabled by default. When using the general keyboard lock method, this setting does not have an effect. Overrule this registry key with "EnableInputAtSuspend = 0", if you do not want the power button unlocked at power off.

DoubleTouchPanelLock (DoubleTouchPanelLock = 0)

With this setting there are 2 locking methods applied for the TouchPanel. For some people one of the methods does not always lock the TouchPanel. The second method powers off the TouchPanel, so the TouchPanel presses are no lomger detected. The first method of locking, has the feature that the scroll area is still sensitive, and also the upper right part (where the taskmanager is located). See for more details, this post.. If you want those features, you must disable this setting. But then there is a possibility the TouchPanel does not always lock.

KeepAliveAlways (KeepAliveAlways = 0)

With this setting enabled, the phone will not go into a deep sleep, but TouchLockPro will keep the CPU alive, so TouchLockPro can e.g. detect the unlock key sequence and awake the phone. Note that this costs approx. 8% battery per hour on my phone, with no other programs running in the background. So use with care, with the convenience you do not need the power button to awake the phone.

UnlockedKeys (UnlockedKeys =)

This setting does only have effect, with setting "HTCLockAPI = 0". Default no keys are unlocked. You can specify which keys you want to be unlocked. You must specify the decimal key values, separated by a space, comma or semicolon. For a list of virtual key codes, see here

A list of the most important keys:

8 = Back: VK_TBACK/VK_ESCAPE = 0x08

37 = Left: VK_TLEFT = 0x25

38 = Up: VK_TUP = 0x26

39 = Right: VK_TRIGHT = 0x27

40 = Down: VK_TDOWN = 0x28

91 = Home: VK_THOME = 0x5B

114 = Talk: VK_TTALK = 0x72

115 = End: VK_TEND = 0x73

117 = VolumeUp: VK_TVOLUMEUP, 0x75

118 = VolumeDown: VK_TVOLUMEDOWN, 0x76

129 = Power: VK_TPOWER = 0x81 (cannot be detected)

130 = Red Key: VK_REDKEY = 0x82

134 = Middle button: VK_ACTION 0x86 (at least on my Touch Diamond)

UnlockKeySequence (UnlockedKeySequence = 118,117)

This setting does only have effect, with setting "HTCLockAPI = 0", Default you cannot unlock with a key sequence. You can specify a key sequence (one or more keys) to unlock the phone. You must specify the decimal key values, separated by a space, comma or semicolon. See previous setting for the possibilities for the keys.

4.8 BattClock

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen. Changes in the BattClock settings (e.g. position) are immediately reflected in the upper start row. Press the color picker in the upper right when you want to change the colors.

BattClock

This is not a registry setting, but a convenience setting in TouchLockAction. Checking this checkbox resets to the BattClock related default settings.

Stripe

This is not a registry setting, but a convenience setting in TouchLockAction. Checking this checkbox does not show the BattClock, but it shows a small stripe (640x2) at the top and will be shown only when locked.

Stealth

This is not a registry setting, but a convenience setting in TouchLockAction. Checking this checkbox will show no BattClock and no stripe (actually a 1x1 black pixel, so it will not be noticed). People often configure the vibration then too, because there is no visual feedback when locked.

Clickable (ClockClickable = 1)

Default the BattClock is clickable, for enabling "lock mode". If you do not want the BattClock to be clickable, overrule this registry key with "ClockClickable = 0"

LockIndicator (LockIndicator = 1)

Defines if the LockIndicator is shown.

ClockLockActiveTime (ClockLockActiveTime = 5000 or 1F40 hexadecimal)

Defines the time in milliseconds how long the locked BattClock will be shown, before it will be recreated. You can increase or decrease this value to your needs.

Configure BattClock

Opens the BattClock settings. See BattClock settings for the details of the screens and settings Note that the color for Time is used as Background color and the background color setting is used as Text color, when the phone is locked.

4.9 Telephone API

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen.

UseTAPI (UseTAPI = 1)

Default TAPI (monitoring incoming, connected and ended calls) is loaded, so the TAPI related functions will be possible. If you do not want TAPI support and you want to use less resources, overrule this registry key with "UseTAPI = 0".

UnlockWhenConnected (UnlockWhenConnected = 1)

Default, it will unlock when connected (and 5 seconds therafter), so when the screen goes off, you can still end the call via the hardware keys or power on the phone and press the TouchPanel. If you do not want this behaviour, overrule this registry key with "UnlockWhenConnected = 0"

InCallTweak (InCallTweak = 1)

Default it will put the screen off, when connected and the GSENSOR orientation is portrait or reverselandscape, to avoid presses with your ear. If you put the phone in another GSENSOR orientation, the screen will go on again. When the GSENSOR is not working for your phone, it will go to screen off when connected. If you do not want this behaviour, overrule this registry key with "InCallTweak = 0"

LockWhenIncoming (LockWhenIncoming = 0)

Default it will NOT lock when there is an incoming call, because the default setting AutoLockOnPowerOn = 1 avoids already accidently missed calls. If you do not want the additional behaviour that it will be always locked at an incoming call (even when the phone was still on), overrule this registry key with "LockWhenIncoming = 1"

KeysOnly (LockWhenIncomingKeyOnly = 0)

Default it will default lock (so including TouchPanel). If you only want the keys locked at incoming call (e.g. you have a Slide 2 Answer and want to take the phone via the slider), you can enable this setting. Note that if you use HTCLockAPI = 1, temporarily the general keyboard hooking is used, to make this functionality work.

DetectBluetooth (DetectBluetooth = 0)

With this setting enabled, you can keep the phone locked when Bluetooth radio is on, do not unlock by light sensor and do not execute TAPI commands. By default this setting is disabled, if you want the bluetooth detection, enable this setting.

DetectBluetoothLightUnlock (DetectBluetoothLightUnlock = 1)

This setting only has effect when DetectBluetooth is set. With this setting enabled, it will unlock on light sensor, when the Bluetooth radio is on. If you do not want this behaviour with DetectBluetooth, overrule this setting with "DetectBluetoothLightUnlock = 0".

HTCLockAPIWhenBluetoothActive (HTCLockAPIWhenBluetoothActive = 0)

With this setting enabled, the HTCLockAPI = 1 is used when bluetooth is active and there is a call. With this setting it is possible to answer with bluetooth keys. Note that if you do not have a phone which supports the HTCLockAPI, do not pick up the phone with the bluetooth answer key or do not want this behaviour, you must *NOT* enable this setting.

Incoming (CommandCallIncoming = )

You can couple a command to a CallIncoming event. Note this is a string value in the registry. The command must be enclosed in double quotes, to separate it from the parameters. Example: !UNLOCK

Connected (CommandCallConnected = )

You can couple a command to a CallConnected event. Note this is a string value in the registry. The command must be enclosed in double quotes, to separate it from the parameters. Example: !LOCKSUSPEND

Ended (CommandCallEnded = )

You can couple a command to a CallEnded event. Note this is a string value in the registry. The command must be enclosed in double quotes, to separate it from the parameters. Example: !LOCKSUSPEND

You can configure also extrnal commands. When there are parameters for the command or when the command contains spaces, they must be enclosed by double quotes.

Note that TouchLockPro has the builtin commands:

!UNLOCK (unlock)

!LOCKSCREEN (lock screen)

!LOCKSUSPEND (lock screen and request power state suspend)

!SUSPEND (request power state suspend)

!TOGGLELOCK (unlock/backlight on OR locksuspend)

!BACKLIGHTOFF (request backlight off)

!BACKLIGHTON (request backlight on)

!IDLE (request power state user idle)

!SCREENOFF (request screen off)

!SCREENON (request screen on)

!KEEPALIVEON (sensors keep working (e.g. for !BACKLIGHTON;!KEEPALIVEON swipe), phone will be kept alive, great for in combination with e.g. GPS)

!KEEPALIVEOFF

!TOUCHLOCKACTION (start TouchLockAction)

!PROXIMITYDISABLE (disable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYENABLE (enable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYIGNORE (ignore proximity changes, other programs can still react)

!PROXIMITYACCEPT (accept proximity changes and execute the configured commands)

!HOME (goto HOME screen)

!SOFTRESET (soft reset)

!POWEROFF (power off)

4.10 Software Input Panel Changer

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen.

Via the SIP (software input panel) you can enter input via the Touch Screen in applications. Often it is handy to use another SIP, e.g. when you operate via the Stylus you want to use Full QWERTY SIP, otherwise you want the Phone Pad SIP. Because TouchLockPro already knows the position of the Stylus, Keyboard and the orientation, I make this feature available, although it is not directly related to locking/unlocking. Phones with Keyboard (Touch Pro), can define 4 different SIP's, if you only have a Stylus, there are still 4 possibilities (Keyboard In, Portrait or Landscape). Default it is empty, so the SIP is not changed due to the Stylus and Keyboard position. Some people also install a NullKb (search on XDA), so they can disable the SIP when the Keyboard is out.

Stylus Out, Keyboard In or Portrait (sipStylusOut = )

Stylus In, Keyboard In or Portrait (sipStylusKeyboardIn =)

Stylus Out, Keyboard Out or Landscape (sipStylusKeyboardOut = )

Stylus In, Keyboard Out or Landscape (sipKeyboardOut = )

The available SIP methods on your phone are filled in. You can select another SIP for a Stylus/Keyboard/Orientation combination, by pressing the up/down. TouchLockPro will set the current SIP, dependent of the Stylus/Keyboard/Orientation, when you select a non-empty SIP.

SIP keyboards

4.11 Other Settings

Press the Next softkey to go to the next Settings screen. Press the Index softkey, to go back to the Index screen.

LogDebug (LogDebug = 0)

Default there will be no debug logging written. When changing the setting to 1, it will write debug logging in the root of your phone: \\touchlockpro.log.txt
This is handy for reporting problems. Please report the problem description and at which time it occurred and upload the log file. Note that the size of this file can grow big, so normally do not enable this setting or only for a relative short time.

LogDebugDetailed (LogDebugDetailed = 0)

See above. Even more detailed debug logging is written. Note that the size of this file can grow big, so normally do not enable this setting or only for a relative short time.

AutoLockOnPowerOn (AutoLockOnPowerOn = 1)

Default it will auto lock when the power goes ON. If you do not want to have it locked automatically at power on, overrule this registry key with "AutoLockOnPowerOn = 0"

LockTouchPanelOnly (LockTouchPanelOnly = 0)

Default it will lock the hardware buttons AND touchpanel. If you only want to lock the touchpanel, overrule this registry key with "LockTouchPanelOnly = 1" Please be careful with the non-default setting LockTouchPanelOnly = 1, because hardwware keys can also be pressed in your pocket!

UnlockOnACPower (UnlockOnACPower = 1)

Default it will be unlocked when on AC/USB power. If you want to have it locked also when on AC/USB power, overrule this registry key with "UnlockOnACPower = 0"

SuspendOnBacklightOff (SuspendOnBacklightOff = 0)

Default it will NOT try to go to suspend, when the backlight switches from ON to OFF, because another setting is added to go to suspend after a timeout has expired after power on. If you do want to suspend, overrule this registry key with "SuspendOnBacklightOff = 1".

BeepsLock (BeepsLock = 0)

If you want beeps when locked, you can change this value. Possible values: 0, 1 and 2.

BeepsUnlock (BeepsUnlock = 0)

If you want beeps when unlocked, you can change this value. Possible values: 0, 1 and 2.

VibratesLock (VibratesLock = 0)

If you want vibrations when locked, you can change this value. Possible values: 0, 1 and 2.

VibratesUnlock (VibratesUnlock = 0)

If you want vibrations when unlocked, you can change this value. Possible values: 0, 1 and 2.

SuspendTimeOutPowerOn (SuspendTimeOutPowerOn = 30000)

Defines the time in milliseconds, to suspend the device again when it is still locked. In previous versions it was only possible to couple the suspend to the SuspendOnBackLightOff setting. Now you can configure this independent via this setting. If you do not want this suspend behaviour, overrule this registry key with "SuspendTimeOutPowerOn = 0"

LED number (LEDNumber = -1)

You can configure which LED (beneath the hardware buttons) to be on, when the phone is locked AND on. Note that the LED will not be on, when locked after 30 seconds of power on. Default no LED's is configured to be on. Some values for the Touch Diamond:

128 Pulse center once

256 Pulse center repeatedly

512 Home/Call answer/Back/End call

1024 Pulse center once/Home/Call answer/Back/End call

2048 Pulse center led anticlockwise spiral twice, pause and repeat

4096 all on

8192 all off, backlight off

Especially, 2048 is nice: Pulse center led anticlockwise spiral twice, pause and repeat. On other types of phone you must try which values work.

4.12 About

Press the Next softkey to go to the Home screen of TouchLockAction. Press the Index softkey, to go back to the Index screen.

The about screen has a link to this TouchLockPro website and a PayPal > USD / EUR button. Press "Reset settings to defaults" when you want all the TouchLockPro settings to be reset to the built-in defaults.
My wife will be glad if we can drink a cup of coffee in the city, because of your donation.
Hope she forgets then the time I did spent on supporting TouchLockPro ;-)

4.13 Command line usage

TouchLockPro has the builtin commands:

!UNLOCK (unlock)

!LOCKSCREEN (lock screen)

!LOCKSUSPEND (lock screen and request power state suspend)

!SUSPEND (request power state suspend)

!TOGGLELOCK (unlock/backlight on OR locksuspend)

!BACKLIGHTOFF (request backlight off)

!BACKLIGHTON (request backlight on)

!IDLE (request power state user idle)

!SCREENOFF (request screen off)

!SCREENON (request screen on)

!KEEPALIVEON (sensors keep working (e.g. for !BACKLIGHTON;!KEEPALIVEON swipe), phone will be kept alive, great for in combination with e.g. GPS)

!KEEPALIVEOFF

!TOUCHLOCKACTION (start TouchLockAction)

!PROXIMITYDISABLE (disable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYENABLE (enable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYIGNORE (ignore proximity changes, other programs can still react)

!PROXIMITYACCEPT (accept proximity changes and execute the configured commands)

!HOME (goto HOME screen)

!SOFTRESET (soft reset)

!POWEROFF (power off)

Multiple commands can be given, by separating by ;

Note that !SCREENOFF and !BACKLIGHTOFF will not work with programs who keep the display on. I use OziExplorer as GPS program and their you can disable the KeepAlive. Unfortunately Google Maps and IGO8 will not let you put the screen or backlight off (or I could not find it).

TouchLockAction can be used interactively, but can also be called programmatically or via shortcuts. Syntax:

"TouchLockAction.exe" action

Possible actions (multiple can be specified):

!UNLOCK (unlock)

!LOCKSCREEN (lock screen)

!LOCKSUSPEND (lock screen and request power state suspend)

!SUSPEND (request power state suspend)

!TOGGLELOCK (unlock/backlight on OR locksuspend)

!BACKLIGHTOFF (request backlight off)

!BACKLIGHTON (request backlight on)

!IDLE (request power state user idle)

!SCREENOFF (request screen off)

!SCREENON (request screen on)

!KEEPALIVEON (sensors keep working (e.g. for !BACKLIGHTON;!KEEPALIVEON swipe), phone will be kept alive, great for in combination with e.g. GPS)

!KEEPALIVEOFF

!TOUCHLOCKACTION (start TouchLockAction)

!PROXIMITYDISABLE (disable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYENABLE (enable the Proximity sensor for HTC phones, for Samsung phones it just disables the notification for only TouchLockPro)

!PROXIMITYIGNORE (ignore proximity changes, other programs can still react)

!PROXIMITYACCEPT (accept proximity changes and execute the configured commands)

!HOME (goto HOME screen)

!SOFTRESET (soft reset)

!POWEROFF (power off)

EnableSuspendOnBacklightOff

DisableSuspendOnBacklightOff

EnableUnlockOnLightSensorTime

DisableUnlockOnLightSensorTime

EnableLockTouchPanelOnly

DisableLockTouchPanelOnly

EnableAutoLockOnPowerOn

DisableAutoLockOnPowerOn

BacklightOff

Exit

Exec "command;parameter1 parameter2"

Registry Action settings TouchLockPro will react on (programming API) TouchLockAction is communicating to TouchLockPro via the registry key: HKCU\Software\ZuinigeRijder\ActionSettings This can also be seen as a sort of programming API, other programs can also write these registry keys to execute actions by TouchLockPro. Registry values:

Command (write one of the above ! commands or multiple, separated by ;

For the other registry settings, read the current value and increment them by one and write them back to the registry. Registry values:

Unlock

LockScreen

LockSuspend

Also the Status of TouchLockPro is written below the registry key HKCU\Software\ZuinigeRijder\Status, so other programs can also see the lock status of TLP and can react on that:

PayPal > USD / EUR

5. History, how things started

4. Settings

4.1 Index

4.2 Light Sensor

Use Light Sensor

UnlockOnLightSensor (UnlockOnLightSensor = 1)

UnlockOnLightSensorTime (UnlockOnLightSensorTime = 1500 decimal)

UnlockOnLightMinimumValue (UnlockOnLightMinimumValue = 1)

4.3 Stylus Sensor

UseStylus (UseStylus = 1)

SuspendOnStylusIn (SuspendOnStylusIn = 1)

StylusOutDisablesLockMode (StylusOutDisablesLockMode = 1)

StylusOutInToggleTime (StylusOutInToggleTime = 1000 decimal or 3E8 hexadecimal)

4.4 G Sensor Orientation

Use G Sensor

Use G Sensor When Unlocked (CmdOrientationWhenUnlocked = 1)

Time (CmdOrientationTime = 5000)

Sequence 1, CmdOrientationSequence1 = 343 (PORTRAIT, UPSIDE_DOWN, PORTRAIT)

Sequence 1 command, CmdOrientation1 = "!UNLOCK"

Sequence 2, CmdOrientationSequence2 = 365 (PORTRAIT, FACE_UP, FACE_DOWN)

Sequence 2 command, CmdOrientation2 = "!LOCKSUSPEND"

Sequence 3, CmdOrientationSequence3 = 356 (PORTRAIT, FACE_DOWN, FACE_UP)

Sequence 3 command, CmdOrientation3 = "!LOCKSCREEN"

Sequence 4, CmdOrientationSequence4 = 343 (Not used, PORTRAIT, UPSIDE_DOWN, PORTRAIT)

Sequence 4 command, CmdOrientation4 = "!UNLOCK"

4.5 Capacitive Nav Sensor

Use Capacitive Nav Sensor

Use Zoombar (UseZoombar = 1)

CapacitiveCommandsWhenUnlocked (CapacitiveCommandsWhenUnlocked = 1)

TF3DWorkaround (TF3DWorkaround = 1)

CapacitiveToggleTime (CapacitiveToggleTime = 3000 or BB8 hexadecimal)

CapacitiveTouchesSequence (CapacitiveTouchesSequence = 222)

Left Swipe Up (CmdLeftUp = "!BACKLIGHTON")

Left Swipe Down (CmdLeftDown = "!BACKLIGHTOFF;!KEEPALIVEON")

Left Swipe Right (CmdLeftRight = "!SCREENOFF;!KEEPALIVEON")

Left Swipe Left (CmdLeftLeft = "!SCREENON")

Right Swipe Up (CmdRightUp = "!UNLOCK")

Right Swipe Down (CmdRightDown = "!LOCKSCREEN")

Right Swipe Right (CmdRightRight = "!LOCKSUSPEND")

Right Swipe Left (CmdRightLeft = "!LOCKSUSPEND")

4.6 Proximity Sensor

Use Proximity (UseProximity = 0)

Proximity Sensor Time (ProximitySensorTime = 700)

Near (CmdProximityNear = "!SUSPEND")

Not Near (CmdProximityNotNear = "!UNLOCK")

On Bluetooth (CmdProximityOnBluetooth = "")

Lock (CmdLock = "!PROXIMITYACCEPT")

Unlock Call (CmdUnlockCall = "!PROXIMITYIGNORE")

Unlock No Call (CmdUnlockNoCall = "!PROXIMITYIGNORE;!PROXIMITYDISABLE")

4.7 Keyboard Sensor

Use Slider (UseSlider = 1)

Suspend On Slider In (SuspendOnSliderIn = 1)

Slider Out Disabled LockMode (SliderOutDisablesLockMode = 1)

HTCLockAPI (HTCLockAPI = 0)

EnableInputAtSuspend (EnableInputAtSuspend = 1)

DoubleTouchPanelLock (DoubleTouchPanelLock = 0)

KeepAliveAlways (KeepAliveAlways = 0)

UnlockedKeys (UnlockedKeys =)

UnlockKeySequence (UnlockedKeySequence = 118,117)

4.8 BattClock

BattClock

Stripe

Stealth

Clickable (ClockClickable = 1)

LockIndicator (LockIndicator = 1)

ClockLockActiveTime (ClockLockActiveTime = 5000 or 1F40 hexadecimal)

Configure BattClock

4.9 Telephone API

UseTAPI (UseTAPI = 1)

UnlockWhenConnected (UnlockWhenConnected = 1)

InCallTweak (InCallTweak = 1)

LockWhenIncoming (LockWhenIncoming = 0)

KeysOnly (LockWhenIncomingKeyOnly = 0)

DetectBluetooth (DetectBluetooth = 0)

DetectBluetoothLightUnlock (DetectBluetoothLightUnlock = 1)

HTCLockAPIWhenBluetoothActive (HTCLockAPIWhenBluetoothActive = 0)

Incoming (CommandCallIncoming = )

Connected (CommandCallConnected = )

Ended (CommandCallEnded = )

4.10 Software Input Panel Changer

Stylus Out, Keyboard In or Portrait (sipStylusOut = )