Howto:Disable Function Key Modification On Phone UI

Starting with Version 9, one can actively disable the modification of function keys on the phone user-interface. Thus, only the administrator could setup the function key map through the web user interface.

List of function keys:

UNDEF		=  0,	// not configured
DIAL		=  1,	// "dial"
CF		=  2,	// "cf"
LOCK		=  3,	// "lock"
RINGOFF        =  4,	// "ring-off"
CALLWAIT	=  5,	// "callwait"
CLIR		=  6,	// "clir"
HEADSET        =  7,	// "headset"
PARTNER	=  8,	// "partner"
PICKUP		=  9,	// "pickup"
REG		= 10,	// "reg"
UNREG		= 11,	// "unreg"
SWITCH		= 12,	// "switch"
HOTDESK	= 13,	// "hotdesk"
MWI		= 14,	// "mwi"
TRANSFER	= 15,	// "transfer"
REDIRECT	= 16,	// "redirect"
PARK		= 17,	// "park"
ENABLE		= 18,	// "enable"
ACTIVE		= 19,	// "active"
GROUP		= 20,	// "group"
DIR		= 21,	// "dir"
COND		= 22,	// "cond"
RECORD		= 23,	// "record"
PRESENCE       = 24,   // "presence"

Example: we want to disable the modification of Partner and Pickup function keys.

1) generate a 32bit mask with bits 8 (partner)and 9 (pickup) set:

printf %x $(((1<<8)+(1<<9)))
0x300

2a) Insert computed mask into "Function keys not modifiable on the phone" on the Phone->Protect page, activate.

Or alternatively:

2b) Set funcion key lock readonly mask

config add PHONE USER /funclock-ro-mask 0x300

Save and activate

config write
config activate

From now on, the function keys which cannot be viewed and modified will be marked by a leading asterisk (*) in front of their name in the Function Keys screen.

To return to default mode, where all function keys can be viewed and modified through the phone user interface as well:

1) delete mask from "Function keys not modifiable on the phone" on the Phone->Protect page, activate.

or alternatively

1b) invoke:

config rem PHONE USER /funclock-ro-mask
config write
config activate

See Reference7:Fine_grained_function_locking for details.