PalmMicro AR1688 Development Manual

Manual is about: Based IP Phone

Summary of AR1688

  • Page 1

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 1 ar1688 based ip phone development guide.

  • Page 2

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 2 table of contents 1 program structure ....................................................... 4 a r 1 6 8 8 p r o g r am d i r e ...

  • Page 3

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 3 5 command and batch file ......................................... 19 c o n v e r t. Ex e c o m m an d .............................

  • Page 4: 1 Program Structure

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 4 1 program structure we provide software api for all ar1688 ip phone authorized manufacturers and end users. The api includes part...

  • Page 5

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 5 although the ip phone reference design based on ar168m voip module and an external mcs8051 ui controller is for demo purpose, it ...

  • Page 6

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 6 page11 -- gb font, part 4 page12 -- test_z80.Bin and main.Bin, ar168x_xxxx_xx_xxxxxx.Bin page13 -- bank 2&3 page14 -- bank 4&5 pa...

  • Page 7

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 7 the size of call hold music data in page5 -- page7 must be 192k(3×64k), namely 196608 bytes, and the filename format is holdmusic...

  • Page 8: 2 Program Compile

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 8 2 program compile compile environment compile ar1688 with sdcc compiler. The configuration of compile path is in the file d:\sdcc...

  • Page 9

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 9 y compiling page0 is not supported by our provided api programs. 2) the file is for the program to upgrade phone. The space for p...

  • Page 10

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 10 //#define ver_ar168e //#define ver_ar168f //#define ver_gf302 //#define ver_ywh201 //#define ver_ar168g //#define ver_gp1266 //#...

  • Page 11

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 11 …… note: “xx” are named according to http://www.Iso.Ch/iso/en/prods-services/iso3166ma/index.Html y oem:for special function, de...

  • Page 12

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 12 note: y compiling page0 is not supported by our provided api programs. Y default value for “language” is us. When using english ...

  • Page 13: 3 Update

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 13 3 update updating operation of ar1688 series phones supports tftp and http protocols. Tftp update enter dos window and input tft...

  • Page 14

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 14 update ring tone use parameter put to update ring tone. Command syntax: tftp –i host put source (enter) “source” is ring tone da...

  • Page 15

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 15 to read different data, the file names specified by “destination” are respectively: y reading current settings information, “des...

  • Page 16

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 16 some examples of updating files. Firmware updating phone program files, such as ar168x_iax2_cn_032000.Bin, can be found in chapt...

  • Page 17

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 17 convert -r ringtone.Pcm ringtone_allice.Dat (enter) 3. Update the phone with ringtone_allice.Dat note: description of convert.Ex...

  • Page 18: 4 Debug

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 18 4 debug debug comprises checking date and debugging phone simply. How to enter safe mode press “*” key while the phone is powere...

  • Page 19: 5  Command And Batch File

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 19 5 command and batch file c:\sdcc\bin includes application program commands and batch files. Here we explain phone operation cont...

  • Page 23

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 23 convert -p srcfile dstfile (enter). Or: convert --pb2bin srcfile dstfile(enter) srcfile is phonebook text file to be converted a...

  • Page 25

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 25 getpb.Bat and setpb.Bat getpb.Bat: read phone book information and put them into a text file phonebook.Txt. The command syntax: ...

  • Page 26: 6 Create Music File

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 26 6 create music file music file, including phone ringtone file and call hold music file, is a binary file and can be updated to a...

  • Page 27

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 27 10. Select “8-bit mu-law compressed” in “data formatted as”; 11. Select “pcm raw data (*.Pcm, *.Raw)” in “save type”; 12. Input ...

  • Page 28

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 28 do not upgrade “long” ring tone don’t upgrade a ring tone more than 192k bytes. 1. Ar1688 ring tone is located in bank 2, 3, 4, ...

  • Page 29: 7 Http Auto-Provisioning

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 29 7 http auto-provisioning settings file and firmware file preparing settings file prepare the settings file named [mac].Txt in th...

  • Page 30

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 30 auto-upgrade settings file and firmware file after the properly setting phone starts, it will get the settings file from the upg...

  • Page 31: 8  How To Modify Web Page

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 31 8 how to modify web page it’s not recommended that modifying the phonebook, digitmap and updating program page. The following sh...

  • Page 32

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 32 goto end :do_iax2 ..\..\bin\convert -w -f us\settings_iax2.Htm settings_iax2_us.Htm ..\..\bin\convert -w -f cn\settings_iax2.Htm...

  • Page 33

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 33 ..\..\bin\convert -w -f cn\login.Htm temp_cn\login.Htm ..\..\bin\convert -w -f cn\phonebook_head.Htm temp_cn\phonebook_head.Htm ...

  • Page 34

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 34 ..\..\bin\convert -w -f fr\settings_iax2.Htm temp_fr\settings_iax2.Htm ..\..\bin\convert -w –f fr\settings_sip.Htm temp_fr\setti...

  • Page 35

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 35 delete option english standard settings page include sip protocol and iax2 protocol, whose file respectively is: y sdcc\src\res\...

  • Page 36

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 36 9 how to add regional and language with pa1688, we have supported over 30 different language firmware. None of us understand lan...

  • Page 37

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 37 sdcc\src\res\ro\inputmap.H is romanian example and sdcc\src\res\ru\inputmap.H is russian example. Different inputmap.H is includ...

  • Page 38

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 38 10 how to change mac address the mac address of pa1688 based device can be easily changed by palmtool, and we spent a lot of tec...

  • Page 39: 11   Manager  Tool

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 39 11 manager tool manager.Exe can manage ar1688 easily, such as upgrading, updating, debug and so on. Ar1688 user can look ar1688 ...

  • Page 40

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 40 update phone upgrading programs. In the phone display list, select the phone to be updated and click “upgrade program” controlle...

  • Page 41

    C o m m u n i c a t i o n s , i n c . © 2006-2007 palmmicro communications, inc. Room 0611, bldg.B tsinghua tongfang technology plaza, 1 wangzhuang road, beijing, china 41 the phone syslog information only; 4. With selecting a phone in the list, debug window displays the phone message only; note: y ...