background image

 

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 language except Chinese and English, volunteers all over the world helped us 

to do the entire localization works. I believe that we can do this again with AR1688, 

hopefully even better because it is well planned from the beginning. 

  

From 0.10 firmware, we have finalized all UI implementations. Of course we will continue 

to improve it and fix bugs, however, developers can do regional and language 

customization based on this version without worrying future huge changes. 

 

Based on 0.32.000 software API, please following steps below to add your own native 

language support: 

Step1. Starting from SDCC\inc\version.h, find the RES_XX sections, check if your 

regional code is in the list or not. The 'XX' code is following ISO 3166 

(

http://www.iso.ch/iso/en/prods-services/iso3166ma/index.html

). If it already 

exists, you can jump to step 3 directly. If it is not, please add it. You can then 

choose to move on to next step, or send an email to 

support@aredfox.com

, tell us 

about your change, and ask us to do step 2, you can jump to step 3. 

Step2.  Add your regional DTMF frequency and interval to SDCC\src\dtmf.c, search for 

"RES_US" in files if you need guide for changes. See the section in Chapter 8 for 

more details. 

Step3. 

Translate the English web pages in SDCC\src\res\us into your native language, 

put them in the new SDCC\src\res\xx directory.

 

Step4. 

Translate SDCC\src \res\us\menu.h, time.h and str.h into your native language, 

keep the original coding as it is in the file. For example, keep ISO-8859-1 coding 

for French special chars and ISO-8859-9 coding for Turkish special chars.

 

Step5. 

In SDCC\src\time.c, 

add judging your regional code and judging accented 

characters, 

change time and date display format accordingly, and add day light 

saving time support if your region uses day light saving. 

China does not use day 

light saving today. Currently only USA day light saving is implemented. Make sure 

"Automatically Adjust Clock for Daylight Saving Changes" option is checked in 

settings. If you need guide for change, search for other language in files, or send 

request to 

support@aredfox.com

Step6. Add judging your regional code and judging accented characters to 

SDCC\src\ui_str.c. If you need guide for change, search for other language in files, 

or send an email to 

support@aredfox.com

. With 2x16 LCD, the display will still be 

English, but we can add other language font display with dot-matrix LCD. 

Step7. 

Add necessary ISO-8859-X font in SDCC\src\font.c, or update Unicode font in the 

256k bytes font data flash storage space.

 

Step8. 

find SDCC\src\res\us\inputmap.h, change it to your own native language. 

Summary of Contents for AR1688

Page 1: ...Communications Inc 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: ...5 Tool Directory 5 AR1688 Program Structure 5 page0 page11 6 page12 page31 7 2 Program Compile 8 Compile Environment 8 Program File 8 Compile Operation 9 mk bat Batch File 9 clean bat Batch File 12 3...

Page 3: ...grade Long Ring Tone 28 7 HTTP Auto Provisioning 29 Settings file and firmware file 29 Preparing settings file 29 Preparing firmware file 29 Set server address and port 29 Auto upgrade settings file a...

Page 4: ...tories under SDCC Bin Directory The directory includes SDCC open source compiler binary files and our own special tools binary files We are using SDCC 2 7 0 steady version You can also download those...

Page 5: ...e space including extended ISO 8859 1 fonts for 2x16 LCD a 4K ROM 8052 is enough cost about 0 5 USD 7 UART at 19200 bps 8 bit data 1 stop no parity check 8 Oscillator at 22 1184Mhz Src Directory Open...

Page 6: ...rved for DSP data The Flash 2M memory space is divided into 32 pages of 64K each The 32 pages are divided into 2 parts page0 page11 and page12 page31 page0 page11 Each page is described as follows y p...

Page 7: ...m each other by the configuration option system_page When configured as system_page 12 the phone will boot from section 1 and from section 1 and let the phone program update the software in section 2...

Page 8: ...guage_OEM_version bin Example ar168x_sip_cn_oem_032000 bin hardware protocol language and oem correspond with parameters in mk command For more details see the chapter about mk command version denotes...

Page 9: ...created y Http data files include Chinese English French Italian Brazil Spain Romania Russia and Turkey y Phone program file includes only one protocol According to protocol parameter value to select...

Page 10: ...VER_AR168MS define VER_BT2008N define VER_FWV2800 y Protocol the protocol for the phone defined as CALL_XXXX in version h The value for this parameter in mk command is XXXX that must be lowercase In v...

Page 11: ...e0 update file When protocol are other values mk compiles codes of phone main program and protocol parts and creates phone update program Examples Example 3 Compile ar168x phone using SIP protocol Eng...

Page 12: ...using English and no OEM language parameter can skip C sdcc src mk ar168x none Enter After compiling phone upgrade program file ar168x_sip_us_032000 bin is created This mode is applicable in followin...

Page 13: ...write to specified file y put Write the data into the phone Updating phone program ring tone and setting information are all writing operation and this parameter is needed y Source source binary file...

Page 14: ...update phone settings Command syntax tftp i host put source Enter source is phone settings file and the filename must begin with settings_ namely settings_xxx dat How to make this file will be describ...

Page 15: ...a and phonebook data may use designated batch file getopt bat and setopt bat getpb bat and setpb bat recommended For more details see section 4 HTTP Update Enter phone setting WEB page select update p...

Page 16: ...gs txt settings dat Enter 4 Update the phone with settings dat Note Description of getopt bat and convert ext can be found in chapter 5 Phonebook Phonebook file is a binary file Steps of generating it...

Page 17: ...escription of convert ext can be found in chapter 5 Call Hold Music File It is a binary file for updating call hold music Steps of generating it are 1 Record a pcm ring by referencing chapter 6 2 Use...

Page 18: ...tSubnetMask IP_ALEN 255 255 255 0 const UCHAR _pDefaultRouterIp IP_ALEN 192 168 1 1 Check Date Information We check phone date information in Palmtool debug window Run palmtool exe and input phone IP...

Page 19: ...eptable html format y i web2info Read parameters in the web page and convert it to a header file y h bin2h Convert a file to a c headfile y r ring2bin Convert pcm ring file to AR1688 acceptable binary...

Page 20: ...b2web srcFile dstFile Enter SrcFile is a html file to be converted and dstFile is a specified output html file converted For example Example Convert the phone configuration text file C sdcc src settin...

Page 21: ...h Command syntax convert h srcFile dstFile Enter or convert bin2h srcFile dstFile Enter SrcFile is a binary file to be converted and dstFile is a specified output c head file converted For example Ex...

Page 22: ...n convert r stdring pcm ringtone dat Enter Or input C sdcc src bin convert ring2bin stdring pcm ringtone dat Enter After above operation binary file ringtone dat is created in C sdcc settings director...

Page 23: ...file with this attribution With f force in the command line if an output file dstFile has existed in the directory the file will be overwritten Without f force in the command line if an output file d...

Page 24: ...bat are used together and after running setopt bat options txt will be deleted automatically For example File options txt include 2 different section of settings and digitmap Phone configure listed un...

Page 25: ...book txt as follows Phonebook txt includes phonebook data information total 100 items and only valid items displayed are in the file pb_name stands for the name property of the phonebook and pb_number...

Page 26: ...lays 6 4 08 24 48 seconds Warning The size of music file must be 196608 Bytes If not errors will take place Record Music Use CoolEdit to record music here take example for Cool Edit Pro Version 2 1 Se...

Page 27: ...file to D sdcc src and use tftp command to update the phone Tftp command and convert command have been described in previous chapter and updating ring tone process as follows Example 2 Update call hol...

Page 28: ...260 GP1266 GP2266 is located in bank 8 9 10 11 3 When using TFTP to upgrade ring tone and hold music we will not check file length This is a back door for us to upgrade font because there is no specia...

Page 29: ...flag for settings file mac_address 0x00 0x18 0x1f 0x01 0x00 0x3a provision_server 192 168 1 251 provision_port 8080 provision_ttl 60 prov_filename ar168x_iax2_cn_032000 bin for setting a file name for...

Page 30: ...the one in the phone the phone will be updated with all the parameters in the file After setting parameters the phone will restart to make the parameter valid If prov_filename item in new parameters...

Page 31: ...ake English pages as a template mkweb bat and mkweball bat There are two bat files in SDCC src res mkweb bat and mkweball bat that convert web page easily As follows mkweb bat Input format mkweb proto...

Page 32: ...files with new files in the temporary directory Modify Language Standard WEB pages display English whose codes directory is SDCC src res us We translate English pages into French ab fr As following St...

Page 33: ...ure htm temp_us failure htm bin convert w f us login htm temp_us login htm bin convert w f us phonebook_head htm temp_us phonebook_head htm bin convert w f us phonebook_tail htm temp_us phonebook_tail...

Page 34: ...mpile the phone program with mk bat and choose French for example mk ar168f iax2 fr Step 8 Update the phone and French page is valid Note If you feel difficult for above operation you can do step 1 2...

Page 35: ...iax2 htm and delete IAX2 Server Port IAX2 server port option part codes Codes in settings_iax2 htm are as follows tr td IAX2 server port td td INPUT name iax2_port size 5 maxlength 5 default 4569 td t...

Page 36: ...cy and interval to SDCC src dtmf c search for RES_US in files if you need guide for changes See the section in Chapter 8 for more details Step3 Translate the English web pages in SDCC src res us into...

Page 37: ...INA 37 SDCC src res ro inputmap h is Romanian example and SDCC src res ru inputmap h is Russian example Different inputmap h is included with RES_XX define in SDCC src menu c For users with less progr...

Page 38: ...nd feel free to write to support palmmicro com cn for a copy if you do not have it 2 Also write to support palmmicro com cn saying that you need special firmware to change your MAC address Please prov...

Page 39: ...parameters There are 3 cases 1 Syslog IP is set as 0 0 0 0 and the phone is not displayed in Manager 2 Syslog IP is set as 255 255 255 255 and the phone is displayed in Manager but manage tool IP is...

Page 40: ...elected phone and output it to a txt file Select a phone in the phone list and click Get Phonebook controller read phone settings and display in phonebook txt Select one phone at each time Write phone...

Page 41: ...za 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 Click Start Debug controller and pop de...

Reviews: