C o m m u n i c a t i o n s , I n c . Table of Contents Program Structure ............4 AR1688 Program Director y ................ 4 Bin Directory ....................4 Doc Directory ....................4 Include Directory ..................
C o m m u n i c a t i o n s , I n c . 1 Program Structure We provide software API for all AR1688 IP phone authorized manufacturers and end users. The API includes part of source codes and part of object files. Those source codes are provided under GPL license.
Full source code of those special tools in "bin" directory, in Visual Studio 2008 or MS Visual C++ 6.0 project. AR1688 Program Structure AR1688 series phones use P rogram Flash with 2M bytes. Details as follows: structure, each page has 64k page0 -- boot.bin and safemode.bin, ar168x_none_xx_xxxxxx.bin page1 -- settings.dat, options, flags, digitmap and address book...
– page31 are divided into 2 parts with the same contents, which is a safety characteristic of the AR1688. page12 – page19 is section 1 and the data starts in page 12. page22 – page31 is section 2 and the data starts in page 22. We distinguish the two parts from each other by the configuration option “system_page”.
C o m m u n i c a t i o n s , I n c . 2 Program Compile Compile Environment Compile AR1688 with SDCC compiler. The configuration of compile path is in the file D:\sdcc\src\makefile and the configuration determines location of compiler and program. Makefile is as follows:...
[protocol]=SIP, import settings_sip.htm and [protocol]=IAX2, import settings_iax2.htm; Compile Operation Compile operation of AR1688 runs on DOS environment. Enter the directory C:\sdcc\src\, which includes compile (mk.bat) and clean (clean.bat) bat file, as follows: mk.bat Batch File mk.bat compiles source codes and produces program files.
C o m m u n i c a t i o n s , I n c . 3 Update Updating operation of AR1688 series phones supports TFTP and HTTP protocols. Tftp Update Enter DOS window and input tftp(enter), help information for this command displays.
[-C|--bin2cfg]: “C” in -C must be uppercase,Convert configuration binary file to text file; [-w|--web2web]: Convert html file to AR1688 acceptable html format; [-i|--web2info]:Read parameters in the web page and convert it to a header file. [-h|--bin2h]: Convert a file to a c headfile;...
Page 20
C:\sdcc\src>..\bin\convert -C settings.dat settings_201.txt (Enter) C:\sdcc\src>..\bin\convert --bin2cfg settings_iax2.dat settings_iax2.txt (Enter) After above operation completes, settings_iax2.txt is created in D:\sdcc\src. -w | --web2web Convert the html file to AR1688 acceptable html format. Command syntax: convert -w srcFile dstFile (Enter) convert --web2web srcFile dstFile (Enter) SrcFile is a html file to be converted and dstFile is a specified output html file converted.
Page 22
C:\sdcc\settings>..\bin\convert --bin2h iax2.txt settings_iax2.h (Enter) After above operation completes, settings_iax2.h is created in C:\sdcc\settings. -r | --ring2bin Cut the recorded music file to the size permitted by AR1688 and save as a binary file(bin) Command syntax: convert -r srcFile dstFile (Enter) convert --ring2bin srcFile dstFile (Enter) srcFile is a music file to be converted, and dstFile is an output binary file converted.
Don’t upgrade a ring tone more than 192K bytes. AR1688 ring tone is located in bank 2, 3, 4, total 192k bytes; AR1688 hold music is located in bank 5, 6, 7, the format and size is the same as ring tone.
Input format: mkweb [protocol] (Enter) For the converting operation of the phone setting page. After modifying settings_iax2.htm or settings_sip.htm, run mkweb.bat, converting .htm file to html file accepted by AR1688 and generating web_info_iax2.h and web_info_sip.h in SDCC\include\. Note: We convert web_info_iax2.h and web_info_sip.h according to the English setting page.
:End Step 5. Input command line mkweball fr(Enter), convert all files in \res\fr\ directory to html files accepted by AR1688 and save them in a temporary directory \res\temp_fr\; Step 6. Overwrite files in \res\fr\ with files in \res\temp_fr\; Step 7. Recompile the phone program with mk.bat and choose French, for example, mk ar168f iax2 fr;...
Delete above codes and save the file; Step 2. Input command line mkweb iax2(Enter), convert settings_iax2.htm in \res\us\ to a html file accepted by AR1688 and generate a new file settings_iax2.htm in res directory; Step 3. While doing step2, generate a new web_info_iax2.h in SDCC\include directory;...
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.
If you do not know how to upgrade by TFTP, do not know how to enter safe-mode, or do not know what MAC address is, you can skip the rest. Make sure you have most recent AR1688 API in hand, feel free to write to support@palmmicro.com.cn for a copy if you do not have it.
C o m m u n i c a t i o n s , I n c . 11 Manager Tool Manager.exe can manage AR1688 easily, such as upgrading, updating, debug and so on. AR1688 user can look AR1688 information with PalmTool no longer.
More phones can be selected at the same time. Debug Function With debug window explore all kinds of messages of AR1688. Click “Start Debug” controller and pop debug window. Explore different phone information according to debug options.
Need help?
Do you have a question about the AR1688 and is the answer not in the manual?
Questions and answers