Woody Home Page
Name Rules
June 7, 2008
A typical upgrade file name for AR1688 device looks like xxxxxxxxxxxxxxx_yyyy_zz_vvvvvv.bin. In some special cases, it may be like xxxxxxxxxxxxxxx_yyyy_zz_ooooooooooooooo_vvvvvv.bin. Different part between under score '_' has different meanings.
xxxxxxxxxxxxxxx: This is the hardware type, or "Board Name" as we call it. Although based on the almost same AR1688 chip, different manufacturer has different hardware board designs, which need different software. It is true that we can do hardware detection like most PC software does, and help all different hardware boards to use the same software. However, it will be a considerable waste of code and memory spaces of the resource limited low-cost AR1688 system. Usually "AR168X" hardware type is used for standard designs for everyone. In most cases every manufacturer will likely to pick up their own hardware types because of products difference. For example, Digitmat choose "GP1266" and "GP2266" board names for their IP phones. Hardware type can be as long as 15 combination of characters and numbers. Like other parts of the file name, hardware type is NOT case sensitive, and can NOT use under score inside it. For example, "BT_2008" name need to be changed to "BT2008N", and "DX_DT" name need to be changed to "DXDT".
yyyy: This is the protocol type. It is limited to 4 bytes, for example "SIP" or "IAX2". The string "none" is used as the indication of safe mode upgrade file, which is only 64k bytes. The size is much less than normal upgrade files.
zz: This is the resource type. It is limited to 2 bytes, for example "cn" for Chinese and "fr" for French. We are following ISO 3166 for country code. The obvious problem is that we did not consider the case of a country using multiple languages from the beginning. So it will be a little tricky for a French speaking Canadian to compile a Canada French version for IP phone.
ooooooooooooooo: This is OEM type, all the name rules are the same as hardware type. Again, do NOT use under score in OEM names. OEM type is used when same hardware type product is used for different OEM customers. Special settings and feature implementations can then be included into different software binaries. We also use different OEM names for different testing purposes in our development stage.
vvvvvv: This is the version part. It is always 6 numbers. The first 3 numbers are major version, and the last 3 numbers are minor version. For example, 033007 stands for 0.33 version 007 build. We will use even major version number for official release, and make minor version number all zero. As an example, 032000 is the most recent software release.
We started to use those name rules a few years ago following OBWAN's advice. He was an active PA1688 user at that time. We are keep learning from all customers and partners, please send us your advice today!

No comments for this page yet.

More options? Please login or register account.