login | register
Sat 22 of Nov, 2008 [06:04 UTC]

voip-info.org

Discuss [7] History

Polycom Idle Images

Created by: dbruce,Last modification on Fri 08 of Aug, 2008 [05:18 UTC] by pifiu

Idle Images


According to the Polycom administrator manual here are the sizes that should be used for the idle image feature:

Idle image for Polycom phones
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>


  • 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>



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"/>


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

Comments Filter
222

333Dynamic IdleImage

by dreaken667, Tuesday 21 of October, 2008 [05:32:39 UTC]
I am trying to set the idle image on some Polycom 550's to a php script that generates an image displaying queue information. I intend to use the animation feature to have this image updated automatically. I've gotten the first few frames to show on the phones with updated information, but am running into issues with maintaining it. Has anyone attempted this, or does anyone know an easier way of displaying updated queue information on these phones (such as calls in queue, longest wait time, etc)?
222

333Re: Problems with Polycom 550 and SIP 3.0.0..258

by rasko, Monday 02 of June, 2008 [14:29:03 UTC]
Well her is the situation.
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
222

333Problems with Polycom 550 and SIP 3.0.0..258

by rasko, Wednesday 28 of May, 2008 [10:47:34 UTC]
I got problems with showing bitmaps on Polycom 550 phones.
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?
222

333Polycom 430 and SIP 2.0.3.0127

by jostrosky, Saturday 03 of March, 2007 [01:01:26 UTC]
Here is what worked for me, following information here, and in Appendix 1 of the 430 Admin manual.

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!
222

333Image Numbers

by Mr.Anderson, Tuesday 23 of January, 2007 [20:21:49 UTC]
For those, like I did, think why not just skip a few numbers ahead to keep from conflicting (without looking at the sip file), the image numbers must be sequential... Just a heads up.
222

333Polycom 650 and SIP 2.0.3.0131

by gadams999, Thursday 18 of January, 2007 [17:36:08 UTC]
The IdleDefault has been removed from the sip.cfg file. For the IP650, place the path to image (or URL - confirmed working) in bitmap.IP_600.65.name="" . Make the other changes as indicated. Haven't tried 8BPP but the IP600 image size and 4BPP works well.
222

333idleimage path

by TalkPBX, Monday 31 of July, 2006 [14:39:46 UTC]
1. Note, the path to the idle image is not absolute. I just place my bitmap in the default ftp directory. So... this "IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="path/to/idle/image/imagename" became this, "IDLE_DISPLAY ind.anim.IP_X00.ZZ.frame.1.bitmap="imagename"

2. I too was able to use an 8BPP image.