In most cases, we recommend using Yealink phones. The UC platform allows programming of all Yealink functions.
Programming the DSS Keys
The ‘button builder’ easily allows configuration of the DSS programmable keys. Each Key can programmed as:
| Setting | Description |
| Line Appearance | A phone extension that allows the user to receive and make calls. All phones should have at least one line. |
| BLF (Busy Lamp field) | A BLF functions as a speeddial for an internal extension, and also shows if that extension is in use. (Green LED when not in use, Red when busy) |
| Call park | See call park |
| Timeframe Toggle | This feature enables a user to manually override a time frame. See Timeframe Override Toggle |
| Queue Toggle | This feature enables the user to log in and out of the queues that they are a member of. The light shows red when logged out and green when logged in. |
| Shared Line Appearance | See ‘shared line appearance’ |
| DTMF | Not in use |
For each key, there is a field for the value (for example extension), and the label that will appear on the phone next to the key.
Next to each key is the 
‘more’ icon. When programming BLF keys, this allows the remaining keys to be programmed using the directory. When set to static, the keys will not change when the directory is updated. In dynamic mode, the keys will be reprogrammed when the extensions in the directory have changed (after a reboot).
The key at the top right has the ‘Additional phone settings” option.
The Yealink phones have literally hundreds of settings that can change the appearance and functionality of the phone. The overrides allow any setting to be included. These have priority over and other settings, or defaults.
The full list of the programming variables for the Yealink phones can viewed here.
The format for these is
setting=”value” (no spaces)
Some common settings that may be included here:
| Setting | Common Options |
| Backlight | phone_setting.backlight_time =” 0″ (always on)
phone_setting.backlight_time = “30” (stays on for 30 seconds) |
| Do Not Disturb Key | programablekey.3.type = “0” (DND key is hidden. Avoids accidental use)
programablekey.3.type = “5” (DND key is shown) |
| DSS Transfer Type | transfer.dsskey_deal_type = “1” (DSS BLF keys are attended transfer)
transfer.dsskey_deal_type = 2 (DSS BLF keys are blind transfer) |
| Language | lang.gui = “English”
lang.gui = “French” |
| Timezone | local_time.time_zone = “-5” (Timezone offset from GMT) |
| Paging | To allow the phone to receive pages, add:
multicast.listen_address.1.ip_address=”224.5.6.20:10008″ To program a key to page other phones (for example DSS key number 2): linekey.2.type=”24″ It is also possible to add multiple paging groups, and specialist paging units. Contact support for more information |
| Ringtones | The ringer for internal calls can be set to ringer 1 as : distinctive_ring_tones.alert_info.1.ringer=”1″For external incoming calls set to ringer 4: account.1.ringtone.ring_type=”Ring4.wav”Click to hear the selection of ringtones |
| Wifi Login | For phones that have built in wifi, or accept a USB wifi dongle, the wifi can be preprogrammed. Multiple wifi logins can be set up. The following would setup the first wifi network. (Replace the ‘1’ for subsequent networks)
static.wifi.1.label=”Your wifi name” Don’t forget, the first time you program the phone, it needs to either be connected by manually setting up the wifi using the phone keyboard, or by plugging into a wired network to get the initla settings.
|
| Firmware | You can specify the firmware level required, and the phone will upgrade to that level if necessary. Available Yealink firmware versions can be found here.
firmware.url=”http://sipcfg.io/frm/yealink/vXX” firmware.url.server_type="http" [REPLACE vXX with the firmware version, example v86] |
| Wallpaper | For the Yealink T48, there are usually 2 wallpapers required.
The first is when the DSS keys are not expanded. In this case, there is blankspace in the middle of the screen that can be used for a larger logo. The second is when the DSS keys are expanded (by pressing the “+More” key). Generally, the logo will make the keys hard to read. The logo either needs to be moved to the bottom where there are no keys, or made to be less prominent. Both logos are 800×480 px png files. They will need to be uploaded to a server where they can be access by url. There is a trick here: Both logos can’t be uploaded and set in one reboot. Step 1: Add these 2 lines to the ‘additional phone settings’ (in this example, the file path is https://yourserver.com/ and filename is t48-main.png). This will add the wallpaper for the main screen. phone_setting.backgrounds=”Config:t48-main.png” Save and sync. The main page wallpaper will now be active. Step 2: Remove the lines above from the ‘additional phone settings’ and replace with the lines below (the filename in the example is t48-main-keys.png). This will add the wallpaper for the screen when the DSS keys are expanded. phone_setting.backgrounds_with_dsskey_unfold=”Config:t48-main-keys.png” Again, save and sync. You may need to reboot the phone for the settings to work rather than just sync. Both the wallpaper files will now be active. Which one is used depends on the status of the DSS keys. |
Saving Configuration
The ‘Save’ button has the options:
- Save – Save, but do not push the settings to the phone
- Save and resync – Pushes in new settings to the phone. For this to work correctly, the phone needs to be already registered to the same extension. If the phone is not registered, or the extension has changed, the phone will need to be manually rebooted to collect the new settings:
- Save as template – There is a template button at the top that allows re-use of an existing template.