Search:
 
      Home arrow Smartphone software arrow Automatic Keylock arrow Documentation Friday, 03 September 2010      
 
Documentation

This  documentation applies to the latest version 3.8 of Automatic Keylock.

Page 1 (General):

On this page, general settings for the application are set.

  • Keylock
    This checkbox enables an disables the automatic keylock.
  • Screen saver
    With this checkbox you can en- and disable the screen saver.
  • Home screen only
    If this box is checked, keypad lock and screen saver are only enabled if the phone was on the home screen before. This way, all applications are excluded.
  • Locking mode
    You can select here if the program should only lock the keypad or if it should do a device lock. If you select "device lock" here, you have to enable the device lock of Windows Mobile by selecting Settings->Security->Enable phone lock from start menu. It is wise to select a large timeout there.
  • Excludes
    You can define several applications which you want to exclude from the automatic keylock and the screen saver. The list box below controls how the applications are selected:
    • If you select "Simple mode", there are 4 checkboxes to select a pre-defined application to exclude. You can select the Windows Media Player, Internet Explorer, the HTC Camera application and BetaPlayer/TCPMP.
    • If this does not suit your needs, you can select "Advanced mode". In the edit field below you can enter a list of executable names you want to exclude. You can separate them by any character you wish.
      e.g.: Camera.exe;Mapopolis.exe;player.exe
  • Unlock automatically
    If this option is selected, the keypad is automatically unlocked if one of the applications excluded above comes to the foreground.

Page 2 (Timeouts)

The settings on this page control when the keypad lock is applied.

  • Timeout in home screen
    After the time given here, the keylock is applied and/or the screen saver is launched if one of the following windows is in the foreground:
    • home screen
    • dial screen
    • start menu
  • Timeout in applications If none of the above were in the foreground, the keypad and/or screen saver are launched after this time.
  • Refresh interval
    This is the refresh interval for the profile settings.

Page 3 (Special profiles)

There are several cases in which the program can optionally behave diferently:

  • The phone is charged. Charging via USB is not detected if the battery is fully charged on WM2K3 devices. This is an OS limitation!
  • The phone is in "headset" profile.
  • The phone is in "handsfree" profile.
  • The phone is in "car" profile.

For each of these cases, there are some or all of the options mentioned below:

  • Disable keylock
    When the matching case applies, the keypad won't be locked automatically any longer.
  • Unlock automatically
    If the keylock also should be removed, you have to check this option. This only works if keypad lock is selected as lock mode on page 1.
  • Disable screen saver
    The screen saver is disabled if the matching case applies if this option is set.
  • Do not disable display
    If this option is set, the display is not turned off (no power saving).
  • Enable backlight
    The backlight can be switched on permanently with this option.
  • Enable Bluetooth
    Bluetooth can be switched to discoverable with this option. After charging ends, the state before charging is restored.

Page 4-1 (Screen saver - General)

With these options, you can influence the appearance of the screen saver.

  • Moving clock
    If this option is set, the clock moves vertically once in a minute. If it is not set, it rests in the middle of the screen.
  • Suppress key presses
    The "Suppress key presses" option is meant for people who only use the screen saver and not the keypad lock: If this option is set and the screen saver is active, a key press only disables the screen saver and does nothing more.
  • Color scheme
    You can select between several color schemes here:
    • Standard colors (white on black)
    • Standard colors (inverted) (black on white)
    • From home screen (colors of the softkey bar)
    • From home screen (inverted)
  • Date format
    You can select between short and long date here. You can control how the date is formatted via Settings->Regional Settings in start menu.

Page 4-2 (Screen saver - Layout)

On this page, you can select the layout of the screen saver.

There is a maximum of 8 lines which can be displayed. For each line, size and font face can be configured.

You can select the line which should be configured with the first list box on this page. The second list box selects the content:

  • Not used (this line is not shown at all)
  • Digital clock (this line shows a text clock)
  • Analog clock (an analog clock is shown - don't forget to set a larger size!)
  • Date
  • Missed calls & messages (this line shows information how many calls and messages you have missed)
  • Phone status (status informatio: signal, battery, profile, temperature)
  • Network operator
  • CellProfileSwitcher (CPS)
  • Status icons (icons which show the current state of the phone)
    Currently, there are the following icons available:
    • Missed calls
    • Missed messages
    • Weak signal
    • Phone is roaming
    • Wek battery
    • Battery is charging
    • Keypad or device lock activated
    • Alarm is set
    • Ringtone is set to silent
    • Bluetooth is activated
    • WiFi is enabled/connecting/connected (WM5 only)
    • Unconditional call forwarding is enabled
  • Line break (this line creates some space between two other lines) 

If the status and CPS lines are selected, there are check boxes which allow to control the contents of this line. This way it is possible to have several status or CPS lines with different content.

  • Status and CPS information
    With these options, you can disable certain elements of the status and CPS lines.

Page 5 (Notifications)

If you have missed calls and/or missed messages, Automatic Keylock has some options to call your attention on this. With the first 3 check boxes, you can select of which events you want to be reminded:

  • Missed calls
  • Missed messages
  • Missed reminders (WM5 only)

 If there is a missed event, there are the following reminder actions:

  • Blink green LED faster
    Automatic Keylock can make the green LED on the top of your phone blink faster (1.5 second interval instead of 3 second interval). Unfortunately, due to unknown reasons this does not work on all devices at the moment.
  • Enable backlight
    On a missed item, Automatic Keylock can enable the backlight for a certain amount of time.
  • Blink interval
    To create even more attention, the backlight can optionally blink. You can set the blink interval (on time) here. The blinking has a 50% duty cycle, so the off time will match the on time.
  • Play sound
    A wave file can be played in regular intervals when there is a new message. In the first list box you can select the interval and in the second the wave file to be played. The program looks for the wave files in the following directories:
    • \Storage\Application Data\Sounds (WM2K3); \Application Data\Sounds (WM5)
    • \Storage Card\My Documents
    • \Storage Card\My Documents\My Sounds
  • Vibration interval
    The phone can be made vibrating when there is a missed item. In regular intervals, there will be a long-short-long vibration. The interval can be set with this option.

Registry settings

For the advanced users, there are some registry values which allow deeper control of the program. They are located below the registry key HKEY_CURRENT_USER\Software\maniac\AutoKeylock.

The following values can be set:

ValueType
Default value
Notes
IgnoreCallREG_DWORD 0

If this is set to 1, the keypad lock and the screen saver will also be activated during a phone call.    

EnableLightWorkaround REG_DWORD
0
When set to 1 (only do this on HTC devices, tested on Tornado only!), the backlight will be completely off during screensaver mode. If you need it to see the screensaver, you can press one of the keys listed under LightOnKeys.
LockCallKeysWhenKeypadIsLocked
REG_DWORD
0

If this option is set to non-0, the call keys ("Call" and "Hangup") will need to pressed multiple times  when the keypad is locked to be recognized. The value set is the amount of additionally needed keypresses. E.g. if the value is set to 3, the keys need to be pressed 4 times to be recognized.

This option mainly is meant for the Cingular 2125 and Orange C600 users.

Notification\DisableKeystroke
REG_BINARY
 0x0A list of keys that can dismiss a notification.
 Screensaver\ShowCallForwardIcon REG_DWORD1
Because getting the call forwarding info causes some network activity every time the screen saver is launched, it can be disabled by settings this option to 0.
Screensaver\CPSPrefix REG_STRING"CPS:" This is the prefix of the CellProfileSwitcher status line in the screen saver.
Screensaver\FGColor REG_DWORD
0xffffff
The screen saver foreground color in 0x00RRGGBB format.
Screensaver\BGColor REG_DWORD
0x000000
The screen saver background color in 0x00RRGGBB format.
Screensaver\CounterResetKeys REG_BINARY0x73 0x73 This is the keystroke used to reset the missed item counter on WM2K3 devices. The keys will be processed as they are listed here. In the default value, the counter is reset on a double press of the "Hangup" button.
Screensaver\LightOnKeys REG_BINARY0x75 0x76
This is a list of keys which enable the backlight on the screen saver instead of disabling it. The order of listing does not matter here.
 Screensaver\ScreensaverDisableKeysREG_BINARY
0x70
This entry lists the keys which disable the screen saver when they are pressed while the screen saver is in the foreground. By default, only the left soft key disables the screen saver.
If the screen saver is in the background (e.g. due to an incoming call), each keypress disables it.

By default, these values do not exist. If you want to use them, you have to create these values with the appropriate types. To reset the the behaviour to the defaults, simply delete those values.

The key codes for the keystrokes are as following:

Key Decimal value
Hexadecimal value
"Any key" 0
0x00
Power 129 0x81
Left Softkey
112 0x70
Right Softkey
113 0x71
Home 91 0x5b
Back 27 0x1b

"Call"

114 0x72
"Hangup" 115 0x73
0 to 9 48 to 57
0x30 to 0x39
Star (*)
119 0x77
Hash (#)
120
0x78
Camera 121 0x79
Comm Manager (HTC Tornado)
234
0xea
Volume Up
117
0x75
Volume Down
118 0x76
Left 37 0x25
Right 39 0x27
Up 38 0x26
Down 40 0x28
Action 13 0xd
 
 
  maniac's Smartphone Tools