DX V3.0 Logging Formats
Contents
1. 66 ZK Celltest Inc DX V3 0 Logging Formats 1 0 Standard DX Data File Structure amp Software Parsing Guidelines I think maybe this should be an appendix in the user manual The channel set calibration and logging realtime sections could refer to this appendix The idea is to provide guidelines for DX datafile users Chris The basic structure used by DX data files are common between all the data files imported or exported e g channel sets receiver calibration realtime logging and log dump files Any parsing software e g Excel macros scripts C programs etc may wish to use the following guidelines for parsing any of these files By following these rules any software scripts macros program etc will be easier to maintain as data file formats evolve to add new features Of course it is not necessary to follow all of these guidelines it is up to the data file user to decide if it is appropriate to their specific application For example it might be safe to assume in your par ticular environment that a log file will contain no comment lines so if you do not plan to prolif erate your parsing scheme to other users who may use comments you could simplify the parsing slightly by not checking for comment lines 1 1 Overview Here is a quick overview of the standard file format used by the DX full details are given below Basically all DX files are ASCII text which consist of 3 types of lines e Comment lines beg2. This message applies to SAM ALL mode only When an adjacent channel interference event occurs the data is logged in this message Synopsis I AB set ing RSSI BER time alignment TA nel Examples system A serving channel 996 lower adjacent channel 995 adjacent RSSI hour minute second latitude km h altitude m upper U or lower L adjacent C I serving channel set abbr serving color code type adjacent set serving channel serving color code value adjacent set abbr longitude sats PDOP heading IA 14 54 55 37 3800 121 9409 4 3 9 344 59 3 100 6 L 22 4 D1 996 C 68 DVCC 153 4 0 0 5 E1 995 90 TABLE 17 Interference IA amp IB Messages Format speed serving channel serving time slot power level adjacent chan serv Field Names Serving Channel Information Adjacent Channel Info gps prefix pe see sec inter color color power timing ae 2 3 1 ference set set chan time code code level align set set chan type CA abbr slot RSSI type value PL BER ment abbr RSSI A band IA 7 L 22 4 D1 996 C 68 DVCC 153 4 0 0 5 E1 995 90 Exam ple Units i 1 char dBm tor 1 dB tor 0 see 1or dBm 2 cha m more note 2 char R chars 1 char s s Min 128 1 1 A 0 0 0 0 1 1 255 255 Max 127 21 102 C 0 DVCC 2 10 100 31 102 102 0 3 55 3 3 g g DCC 4 SAT 3 Bl
3. altitude Example XX 14 51 52 37 3800 121 9409 4 3 9 344 59 3 100 6 Units 2 or more degrees degrees degrees km hr meters chars Min 90 180 1 0 0 0 0 Max No 90 180 360 Blank No HH 2 digithour Yes Yes Yes Yes Yes Yes Yes MM 2 digiti minute SS 2 digit secnod Comments f message Horizontal types are Dilution defined below g Precision Notes 1 The GPS fields are always generated even if the GPS option is not enabled or installed There are three reasons that the GPS fields will be blank 1 GPS is disabled GPS enabled flag DX836 DX54 DL836 User Manual 75 field of the GP message will be 0 or 2 GPS is enabled GP message GPS enabled flag 1 but has not been able to get a fix on enough satellites or 3 the GPS option is not installed 2 3 2 Marker MK Message This message applies to SAM ALL and Select Channel modes Synopsis MK hour minute second latitude longitude number of satellites HDOP heading speed km h altitude m marker number Example marker number 11 MK 14 51 52 37 3800 121 9409 4 3 9 344 59 3 100 6 11 TABLE 11 Marker MK Message Format Field Names message gps prefix type see sec 2 3 1 marker number Example MK x 11 Min 0 Max 99 Blank No h No Comments Marker number increments each time user inserts marker with ENTER key in SAM ALL Marker wraps to 0
4. best idea for parsing software is to explicity ignore non specified lines Essentially software should treat these lines like comment lines i e skip them For example in a LOG data file the only valid lines are START and END any other line beginning with should be ignored 1 4 Message Data Lines 1 4 1 File Type Specific formats The data format is different for each file type e g SAM ALL Channel Set etc refer to the appropriate documentation for specific data format information 1 4 2 Comma Delimitted Syntax An ASCII comma delimitted field syntax for message lines DX836 DX54 DL836 User Manual 69 1 4 3 Extra Fields are Reserved It is possible that formats may change in the future by adding new fields to the end of the existing line formats Ideally therefore parsing software should ignore any fields at the end of a line 1 4 4 End of Lines There is a carriage return at the end of each message line 70 ZK Celltest Inc 2 0 DX V3 0 Realtime and Log Message Formats This section describes the specific messages produced by the SAM ALL amp Select Channel modes The log data conforms to the standard DX data file format please refer to appendix TBD for a description of the standard data file structure To simplify the documentation of SAM ALL Select Channel messages are divided into two types e Non GPS messages These messages do not contain GPS information For example the Date mes
5. might be useful for in building measurements for example Synopsis GP hour minutes seconds flag Example GP 14 51 52 1 TABLE 9 GPS Indicator Message GP Message Format Field Names message type time GPS enabled flag Example SS 14 51 52 1 Min 0 Max 1 Blank No No No Comments HH 2 digit hour Where flag 1 the user has set GPS enabled MM 2 digiti minute Where flag 0 the user has set GPS disabled SS 2 digitsecnod unit does not have GPS option 74 ZK Celltest Inc 2 3 GPS Marked Messages The remaining message types all begin with the same fields which give the associated message type time and GPS information 2 3 1 Prefix for GPS Marked Messages The Prefix for GPS Marked Message is not a message in itself but is part of all GPS marked messages Refer to this section for a description of the time and GPS informtion fields associated with GPS marked logs The same format is used for Select Channel and SAM ALL modes Synopsis Message type hour minute second latitude longitude of sattelites HDOP heading speed km h altitude m message type specific data Example GPS Enabled xx 14 51 52 37 3800 121 9409 4 3 9 344 59 3 100 6 Example GPS Disabled XX rrrrrrrr gt gt gt e TABLE 10 GPS Prefix Format Field Names message type time latitude longitude satellites HDOP heading speed
6. neighbors are ordered from strongest to weakest Synopsis NB hour minute second latitude longitude of satellites PDOP heading speed km h altitude m serving channel number serving time slot serv ing set serving set abbr serving DVCC serving RSSI strongest neighbor channel strongest neighbor RSSI strongest neighbor DVCC neighbors repeated to max provided by system sorted strongest RSSI to weakest Example serving channel 996A strongest neighbor 715 2nd strongest neighbor 708 NB 14 53 19 37 3800 121 9409 4 3 9 344 59 3 100 6 996 A 4 D1 153 83 715 85 153 708 93 153 695 103 111 711 104 162 693 105 43 992 105 162 1002 106 43 TABLE 16 Neighbor List NB Message Format Field Names Neighbor Channel Information Repeated for all neighbors Serving Channel Information provided by system up to 24 max message gps prefix Order is sorted by RSSI strongest type see sec 2 3 1 RSSI first weakest last set channel time slot set abbr DVCC RSSI channel RSSI DVCC Example NB 2 996 A 4 D1 153 83 715 85 153 Units 1or2 dBm dBm chars Min i 1 A 1 0 255 1 255 0 Max x 1023 C 21 255 0 1023 0 255 Blank No No Yes No No Yes Yes No Yes Yes Comments See sec 2 3 1 DX836 DX54 DL836 User Manual 81 2 3 8 Interference IA amp IB Messages
7. white space delimited fields Here is an example SAM ALL realtime output START line model DX836 SAM ALL mes sages version 3 0 firmware version 9 9A START ZK SAM DX836 SAM ALL 09 30 1997 14 51 49 3 0 9 9A Here is an example SAM ALL dump to pce output START line START ZK SAM DX836 LOG 09 30 1997 16 32 13 3 0 9 9A 68 ZK Celltest Inc The format of the START line is as follows TABLE 6 START line format Field Names File File Software START Model Type Date Time Version Version Reserved Dump To PC START ZK SAM LOG 9 30 97 14 51 49 3 0 9 9A example DX836 SAM ALL START ZK SAM SAM 9 30 97 14 51 49 3 0 9 9A Realtime DX836 ALL Example Comments Month Hours Format Note Any other Day Minutes revision V9 9A is data at for File example end of Year Seonds Type only line should be ignored 1 3 2 End of Data END The end of a data file is indicated by a line beginning with END Parsing software should ignore any data following an END Parsing software should ignore data after the END line until the next START line Also parsing software should treat end of file as an END Note when transferring any data file e g calibration and channel set data to a DX the END line is required 1 3 3 Other Control Lines Other lines may be used by specific file types e g Channel Set Other lines may be used in the future the
8. 2 TABLE 18 Individual Voice Channel RSSI RA amp RB Messages Format Field Names Channel Information Repeated for the number of channels configured by the user Sorted by RSSI strongest to weakest message gps prefix type see sec 2 3 1 channel number RSSI A band RA 7 78 71 Example B band RB 486 51 Example Units X dBm Min ii 1 255 Max 1023 0 Blank No J No No Comments See sec 2 3 1 DX836 DX54 DL836 User Manual 83 2 3 10 Select Channel CN Log This message applies to Select Channel mode only description goes here Synopsis CN hour minute second latitude longitude of satellites PDOP heading speed km h altitude m channell channell RSSI channell SAT channell DCC Example channel 255 RSSI 56dBm SAT 1 channel 779 RSSI 56dBm no color code CN 13 41 26 42 0613 87 7518 7 1 2 115 5 9 200 255 56 1 779 56 993 104 1022 106 629 105 1 97 1 TABLE 19 Select Channel CN Message Format Field Names Channel Information Repeated for the number of message gps prefix channels configured by the user type see sec 2 3 1 channel number RSSI SAT DCC A band CN 255 56 1 Example Units d dBm Min 1 255 0 0 Max 3 1023 0 3 4 Blank No s No No Yes Yes Comments See sec 2 3 1 Blank or SAT 3 Blank or DCC 4 indicates no SAT indicate
9. DL836 User Manual 77 2 3 4 Strongest Control Channels Messages CA amp CB This message applies to SAM ALL mode only Synopsis C AB hour minute second latitude longitude of satellites HDOP head ing speed km h altitude m strongest control channel RSSI DCC second strongest control channel RSSI DCC repeated for up to 21 control channels Example 2 strongest control channels for system A CA and system B CB CA 16 27 10 37 3808 121 9412 6 1 1 344 0 0 17 330 76 0 316 84 0 CB 16 27 14 37 3808 121 9412 6 1 1 344 0 0 17 347 79 0 349 88 1 TABLE 13 Strongest Control Channels Messages CA amp CB Format Field Names Repeated for 1st 2nd up to 21 strongest control channels strongest message gps prefix control type see sec 2 3 1 channel RSSI DCC A Band CA 330 76 0 example B Band CB bi 347 79 0 example Units dBm Min 1 255 0 Max 1023 0 4 Blank No x No No Yes Comments See sec 2 3 1 Blank or 4 means 7 no DCC detected 78 ZK Celltest Inc 2 3 5 System ID message ID This message applies to SAM ALL mode only This message provides network type system ID private system ID and residential system ID information available on the serving digital control channel Synopsis ID hour minute second latitude longitude of satellites HDOP heading speed km h altitude m public network type indi
10. V chan nel channel number time slot set set abbr color code type DVCC SAT or DCC color code value RSSI power level BER time alignment TA Example IS136 control channel 996A DVCC 153 RSSI 83dBm PH 14 53 19 37 3800 121 9409 4 3 9 344 59 3 100 6 N6 C 996 A 4 D1 DVCC 153 83 2 0 TABLE 15 Phone PH Message Format Field Names color color msg GPS prefix phone channel set code code power timing type sec 2 3 1 type type channel time slot set abbr type value RSSI level BER alignment Example PH k N6 c 996 A 4 D1 DVCC 153 83 2 0 Units 1or 1 char 1or 1 or dBm see more 2 more note 1 chars chars chars Min 1 1 A 1 0 255 0 0 0 Max s 21 1023 21 DVCC 255 0 10 100 31 DCC 4 SAT 3 Blank No No Yes 2 Yes 2 Yes No No Yes Yes Yes Yes Yes Yes Comments See sec N6 2160 possible blank possi Blank or see 2 3 1 C control not TDMA ble DCC 4 note 1 V voice DVCC SAT 3 SAT or indicates color code DCC not avail able Notes 1 Power level value is equal to Mobile Station Power Level PL as defined by the IS136 specifi cation PL can be converted to dBW PdBW with the following equation PdBW 6dBW PL 4dBW e g PL 1 is 2dbW 2 If channel is blank it implicates a power off event of the phone 80 ZK Celltest Inc 2 3 7 Neighbor List NB Message This message applies to SAM ALL mode only This message logs the neighbor list data as measured by the phone The
11. after reaching 99 Marker number returns to 0 when log memory cleared 76 ZK Celltest Inc 2 3 3 Strongest Voice Channel Sets Messages VA amp VB This message applies to SAM ALL mode only The voice channel sets message is a variable length message which gives the RSSI average RSSI standard deviation and number of channels for the strongest voice channel sets The number of voice channel sets logged depends on user selected preferences Synopsis V AB hour minute second latitude longitude of satellites HDOP head ing speed km h altitude m strongest set strongest set SAT Average RSSI RSSI Standard Deviation of channels repeated for up to 21 stron gest voice sets Example 2 strongest voice sets logged in system A sets D1 amp D3 VA 14 51 53 37 3800 121 9409 4 3 9 344 59 3 100 6 4 D1 3 74 3 8 18 D3 3 79 2 13 TABLE 12 Voice Channel Sets Messages VA amp VB Format Field Names Repeated for 1st 2nd up to 21 strongest sets message gps prefix strongest strongest avg RSSI of type see sec 2 3 1 set set abbr sat RSSI std dev channels A Band VA 4 D1 3 74 3 8 example Units a lor2 dBm dBm chars Min 1 0 255 0 0 Max i 21 3 0 255 255 Blank No No No Yes No No No Comments See sec 2 3 1 Blank or Set s 3 means voice no SAT channels detected above XX dBm DX836 DX54
12. ank No No N No No Ye Yes Yes Yes Yes Yes Yes No No No No o s Com See possi car possi Blankor see ments sec 2 3 1 ble rier ble DCC 4 note L to SAT 3 1 lower intef pvcc indi adia eren cates Pa ce SAT color 7 oF code not U DCC avail upper able adja cent 82 ZK Celltest Inc 1 Power level value is equal to Mobile Station Power Level PL as defined by the IS136 specifi cation PL can be converted to dBW PdBW with the following equation PdBW 6dBW PL 4dBW e g PL 1 is 2dbW 2 3 9 Individual Voice Channel RSSI RA amp RB Messages This message applies to SAM ALL mode only If the user selects a scanning mode that includes voice channel scanning and selects more than zero individual voice channels to store then these messages will log the top XX voice channels and their signal strength where XX ranges from 0 to 40 and is settable by the user in the MORE SAM ALL SETUP SCREEN Synopsis R AB hour minute second latitude longitude sats PDOP heading speed km h altitude m channell channell RSSI channel2 channel2 RSSI Examples system A channels 78 99 996 246 System B channels 486 463 722 591 RA 19 01 25 37 3800 121 9409 4 3 9 344 59 3 100 6 78 71 99 72 996 75 246 75 RB 19 01 31 37 3800 121 9409 4 3 9 344 59 3 100 6 486 51 463 52 722 61 591 6
13. cator private network type indicator residential network type indicator SID PSID1 PSID2 PSID3 PSID4 RSID Example SID 31 public network type no PSID no RSID ID 14 53 08 37 3800 121 9409 4 3 9 344 59 3 100 6 1 0 0 31 TABLE 14 System ID Message ID Format Field Names gps Network Type Indicators private private private private message prefix public system system system system residential type see sec resid system ID ID ID ID system 2 3 1 public private ential ID SID PSID1 PSID2 PSID3 PSID4 ID RSID Example ID 1 0 0 31 Min 5 0 0 0 0 0 0 0 0 0 Max by 1 1 1 65535 65535 65535 65535 65535 65535 Blank No No No No No Yes Yes Yes Yes Yes Com See 0 ID not available the Blank indicates ID not available associated indicator field will ments sec associated ID field s be 0 2 3 1 will be blank 16 bit values 1 ID available the ID value will be indicated by the associated ID field DX836 DX54 DL836 User Manual 79 2 3 6 Phone PH Message This message applies to SAM ALL mode only This message provides the key information coming from the phone with the exception of the neighbors Synopsis PH hour minute second latitude longitude sats PDOP heading speed km h altitude m phone type N6 Nokia2160 control C or voice
14. in with Comments are sometimes inserted by the DX itself to help users interpret a file or a user can optionally use these lines to make notes e Control lines begin with Control lines are used to indicate the start and end of data in a file i e START and END lines are also reserved for future use such as for keywords e Message data lines Comma delimited lines of data DX836 DX54 DL836 User Manual 67 1 2 General Syntax Guidelines 1 2 1 Ignore Extra Whitespace Any blank lines or other extra white space e g tabs spaces new lines nulls should be ignored Also ignore ASCII NUL Hex code 0x00 characters 1 2 2 End of Lines There is a carriage return at the end of each message ASCII Hex code 0x0D 1 2 3 Comments If the first non whitespace character of a line is then the line should be ignored by the parsing software The entire line should be considered a comment and ignored Comments are supported anywhere in a file e g at the beginning before the START line and between data lines 1 3 Start End and Control lines Control lines are lines which begin with an character All data files use START and END lines to indicate the start and end of data 1 3 1 Start Line START The start of data is indicated by a line beginning first non whitespace characters with START Parsing software should ignore any lines before the START line This line uses
15. s no available DCC available
16. sage e GPS marked messages These messages all begin with several fields which indicate the message type time and GPS information 2 1 About Message Format Tables Below each message is described using a table The columns of the table are correspond to a sin gle field of the message The rows of the table give detailed information about the fields The rows of the table are e Example shows the data from the example message given above the table e Units if applicable gives the units of the message field e g meters or dBm e Min Max these to fields if applicable give the minimum and maximum values to be expected in the associated message field e Blank Yes indicates that the field may be blank under certain conditions No indicates that the field will never be blank e Comments miscellaneous notes about the message field DX836 DX54 DL836 User Manual 71 2 2 Non GPS Messages 2 2 1 Date DATE Message This message applies to both SAM ALL and Select Channel modes This log is produced at the time SAM ALL or Select Channel modes are first started Synopsis DATE month day year Examples September 30 1997 amp August 23 2001 DATE 9 30 1997 DATE 8 23 2001 TABLE 7 Date DATE Messages Format Field Names message type date Example 1997 DATE 9 30 1997 Example 2001 DATE 8 23 2001 Units MMIDDIYYYY Min Max Blank No No Comments MM 2 digi
17. t month DD 2 digit day YYYY 4 digit year 72 ZK Celltest Inc 2 2 2 System Settings Message This message applies to SAM ALL mode only This message is generated at the beginning of aSAM ALL session It indicates the scanning mode selected by the user during that SAM ALL session Does not apply to Select Channel mode Synopsis SS hour minute second control channel logging selection voice channel set logging selection Example SS 14 51 52 CAB VAB TABLE 8 System Settings SS Messages Format Field Names HH 2 digit hour MM 2 digiti minute SS 2 digit secnod CAB control A amp B CA control A only CB control B only CNONE no control scanning message type time control channel scanning mode voice channel scanning mode Example SS 14 51 52 CAB VAB Min Max Blank No No No No Comments possible values possible values VAB voice A amp B VA voice A scanning VB voice B scanning VNONE no voice scanning DX836 DX54 DL836 User Manual 73 2 2 3 GPS Indicator GP Message This message applies to SAM ALL and Select Channel modes This log is generated at the beginning of a SAM ALL or Select Channel session to indicate if GPS was enabled If the unit is non GPS then this message will always indicate disabled If the unit does have the GPS option then the user can optionally disable enable GPS via the GLOBAL SETUP menu this
Download Pdf Manuals
Related Search