Idle Images
According to the Polycom administrator manual here are the sizes that should be used for the idle image feature:
| Model | Width | Height | Color Depth |
|---|---|---|---|
| IP 301 | n/a | n/a | n/a |
| IP 320/330 | 102 | 23 | monochrome |
| IP 430 | 94 | 23 | monochrome |
| IP 501 | 114 | 51 | 2-bit grayscale or monocrhome |
| IP 600/601 | 209 | 109 | 2-bit grayscale or monochrome |
| IP 550/560/650 | 209 | 109 | 4-bit grayscale or monochrome |
| IP 4000 | 150 | 33 | monochrome |
The manual also mentions the following:
Logos smaller than described in the table above are acceptable, but larger logos may be truncated or interfere with other areas of the user interface. (ie. You might see the logo in the background popping out the sides of menus when browsing through menus or while on calls)
The SoundPoint IP501/600/601 phones only support four colors black, grey, light gray and white. Any other colors will be approximated.
The SoundPoint IP550/560/650 phones support a 4-bit grayscale, which is a smooth gradient from black (0,0,0) to white (FF,FF,FF).
The SoundStation IP 4000 phone only supports black and white. Any other colors will be rendered as either white or black.
Files should be saved as BMP format: Windows, 4BPP (or 16 color), Uncompressed (No RLE). For consistency you should save all the files as 4BPP/16 color.
You can add an idle image to the phone either 1) globally by modifying the sip.cfg file, or 2) for specific phones by modifying the phone specific configuration file
1) Global Idle Image
- load your existing sip.cfg file into your favorite text editor.
- find the parameter bitmap.IP_X00.YY.name="IdleDefault" . (where X = 5, 6 or 40, YY = image identifier)
- modify the parameter to bitmap.IP_X00.YY="path/to/idle/image/imagename". The name must NOT have the extension (ie .bmp)
- find the parameter IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="IdleDefault" (where X = 5, 6 or 40, ZZ = Animation Identifier)
- modify the parameter to IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename". The name must NOT have the extension (ie .bmp)
- find the parameter IDLE_DISPLAY_WIDE ind.anim.IP_X00.AA.frame.1.bitmap="IdleDefault" (where X = 5, 6 or 40, AA = Animation Identifier)
- modify the parameter to IDLE_DISPLAY_WIDE ind.anim.IP_X00.AA.frame.1.bitmap="path/to/idle/image/imagename". The name must NOT have the extension (ie .bmp)
- save the modified file and reboot your phones.
NOTE: DO NOT CHANGE the numbers that appear in the original config file in place of YY, ZZ or AA.
2) Phone Specific Idle Image
- load your sip.cfg file into your favorite text editor.
- find the parameter bitmap.IP_X00.YY.name="IdleDefault" . (where X = 5, 6 or 40, YY = image identifier). Take note of the YY value.
- find the parameter IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="IdleDefault" (where X = 5, 6 or 40, ZZ = Animation Identifier). Take note of the ZZ value.
- find the parameter IDLE_DISPLAY_WIDE ind.anim.IP_X00.AA.frame.1.bitmap="IdleDefault" (where X = 5, 6 or 40, AA = Animation Identifier). Take note of the AA value.
- load your phone.cfg file.
- add the following entries to your phone.cfg file immediately after the <phone1> tag, substititing the values of YY, ZZ and AA that you noted above.
<bitmaps>
<IP_X00 bitmap.IP_X00.YY.name="path/to/idle/image/imagename"/>
</bitmaps>
<indicators>
<Animations>
<IP_X00>
<IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename" ind.anim.IP_X00.ZZ.frame.1.duration="0"/>
<IDLE_DISPLAY_WIDE ind.anim.IP_X00.AA.frame.1.bitmap="path/to/idle/image/imagename" ind.anim.IP_X00.AA.frame.1.duration="0"/>
</IP_X00>
</Animations>
</indicators>
<IP_X00 bitmap.IP_X00.YY.name="path/to/idle/image/imagename"/>
</bitmaps>
<indicators>
<Animations>
<IP_X00>
<IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename" ind.anim.IP_X00.ZZ.frame.1.duration="0"/>
<IDLE_DISPLAY_WIDE ind.anim.IP_X00.AA.frame.1.bitmap="path/to/idle/image/imagename" ind.anim.IP_X00.AA.frame.1.duration="0"/>
</IP_X00>
</Animations>
</indicators>
- save your modified configuration file and reboot the phone.
IMPORTANT: After 1) or 2) you HAVE to do this:
3)
N.B. The line <indicators> above should be replaced by...
<indicators ind.idleDisplay.enabled="1">
and if you set it in sip.cfg, just change the
<indicators ind.idleDisplay.enabled="0">
to
<indicators ind.idleDisplay.enabled="1">
This will enable the idle display.
To animate the display, you will need at least two images.
Check sip.cfg for the highest value of YY for
parameter bitmap.IP_X00.YY.name="IdleDefault" . (where X = 5, 6 or 40, YY = image identifier)
then add this to your file (sip.cfg, or phone.cfg)
<bitmaps>
<IP_X00 bitmap.IP_X00.{YY+1}.name="path/to/idle/image/imagename1" bitmap.IP_X00.{YY+2}.name="path/to/idle/image/imagename2"/>
</bitmaps>
<IP_X00 bitmap.IP_X00.{YY+1}.name="path/to/idle/image/imagename1" bitmap.IP_X00.{YY+2}.name="path/to/idle/image/imagename2"/>
</bitmaps>
replacing {YY+1} and {YY+2} with the next higher numbers above YY
the Animations lines should now read...
<IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename1" ind.anim.IP_X00.ZZ.frame.1.duration="3000" ind.anim.IP_X00.ZZ.frame.2.bitmap="path/to/idle/image/imagename2" ind.anim.IP_X00.ZZ.frame.2.duration="3000"/>
<IDLE_DISPLAY_WIDE ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename1" ind.anim.IP_X00.ZZ.frame.1.duration="3000" ind.anim.IP_X00.ZZ.frame.2.bitmap="path/to/idle/image/imagename2" ind.anim.IP_X00.ZZ.frame.2.duration="3000"/>
<IDLE_DISPLAY_WIDE ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename1" ind.anim.IP_X00.ZZ.frame.1.duration="3000" ind.anim.IP_X00.ZZ.frame.2.bitmap="path/to/idle/image/imagename2" ind.anim.IP_X00.ZZ.frame.2.duration="3000"/>
You may use as many images as you'd like, but be sure to use consecutive numbers, and not to reuse the same number twice.
Duration is milliseconds. (1/1000 of a second)
Note: Don't set the duration to low, try 3000 first, otherwise the pictures silently fail.
A word of caution! The image sizes above are MANDATORY, unless you get into editing size and position
Too large, and it will reboot a few times and not display.
But you may be able to use 8 bit.
Digium Lists Success Story
Bitmap Quotas
If you still can't see the image on the display but the layout changed to a smaller and relocated date and time (leaving a blank space where you'd expect to see your image), you may've hit the memory quota limit that the phone has for bitmaps.Solution:
- Edit sip.conf.
- Search for:
res.quotas.2.name="bitmap" res.quotas.2.value="10"
(this means your quota for bitmaps is 10KBytes)
- Increase value to a number greater than the bitmaps you plan to load to the phone (my single not animated bitmap was 15K so I increased the number to "20").
- Save sip.conf, reboot the phone, and enjoy!
To clarify, it seems that that bitmap quota is for all user loaded bitmaps, not just each individual one. I.e., if you set it to 20k as above, all of them must come in at under 20k, or the phone will just start dropping the ones that come in over that amount. E.g., I just recently set mine to 35 because I had three 4 bit bitmaps in an animation that came to around 33 or 34k.
Web-based bitmap files
I've found that just as for the sound files, the image files can be hosted on any reachable web server.example:
bitmap.IP_500.67.name="http://www.mywebserver.com/polycom-pix/moocow.bmp"

Comments
333Dynamic IdleImage
333Re: Problems with Polycom 550 and SIP 3.0.0..258
Because of undocumented aciton in my network I had problem with downloading bmp. Now it's ok, but this is it:
For display on Polycom IP550 phone you must use settings for 600, and also yu can use (208 x 110) that bmp dimesion. Works with 8BPP image
333Problems with Polycom 550 and SIP 3.0.0..258
I tried both fot IP500 and IP600, but I'm still not able to see the bitmap.
I also noticed that there's no IdelDisplay so I put the bmp in both 1 and 61 field (for 500) and (for 600) in 1 and 65, but there's no displaz.
I also noticed error in logs:
0528122031|copy |4|03|Download of 'PMlogo.bmp' FAILED on attempt 1
0528122031|res |4|03|ResFinderC: Download - Failed to download file PMlogo.bmp, errno 0x380003.
0528122031|copy |3|03|'tftp://10.1.133.22/PMlogo.bmp' from '10.1.133.22'
0528122031|copy |3|03|TFTP download error
0528122031|copy |3|03|tftpLib error: tftp transfer failed: error 0x4b0008
0528122031|copy |4|03|Download of 'PMlogo.bmp' FAILED on attempt 1
0528122031|res |4|03|ResFinderC: Download - Failed to download file PMlogo.bmp, errno 0x380003.
Any suggestions?
333Polycom 430 and SIP 2.0.3.0127
This went in my site-specific cfg file:
<!-- Idle Display -->
<bitmaps>
<IP_400 bitmap.IP_400.1.name="lcms" />
</bitmaps>
<indicators ind.idleDisplay.enabled="1">
<Animations>
<IP_400>
<IDLE_DISPLAY ind.anim.IP_400.38.frame.1.bitmap="lcms" ind.anim.IP_400.38.frame.1.duration="0"/>
</IP_400>
</Animations>
</indicators>
Here is my <mac>.cfg file
<?xml version="1.0" standalone="yes"?>
<!-- Default Master SIP Configuration File-->
<!-- Edit and rename this file to <Ethernet-address>.cfg for each phone.-->
<!-- $Revision: 1.14 $ $Date: 2005/07/27 18:43:30 $ -->
<APPLICATION APP_FILE_PATH="sip.ld"
CONFIG_FILES="p22-reg.cfg, spkrloud.cfg, xxxxx-settings.cfg, phone1.cfg, sip.cfg"
MISC_FILES="lcms.bmp" LOG_FILE_DIRECTORY="" OVERRIDES_DIRECTORY="" CONTACTS_DIRECTORY=""/>
Note that in the original sip.cfg file, the bitmaps entry shows:
<IP_400 bitmap.IP_400.61.name=""/>
This wasn't working for me, so I took a guess and changed 61 to 1. Voila!
333Image Numbers
333Polycom 650 and SIP 2.0.3.0131
333idleimage path
2. I too was able to use an 8BPP image.