FreeCalypso > hg > freecalypso-tools

comparison doc/RF_tables @ 309:158fef5f4b82

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/RF_tables: updated for the newly implemented more complete support
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 22 Nov 2017 04:49:29 +0000
parents 0e7a85356130
children 817f3b5f019e
comparison
equal deleted inserted replaced
308:6a254cc6a7f3 309:158fef5f4b82
43 running firmwares) supports rftw and rftr commands for reading and writing 43 running firmwares) supports rftw and rftr commands for reading and writing
44 the fw's in-RAM RF tables via RF_TABLE_WRITE and RF_TABLE_READ command 44 the fw's in-RAM RF tables via RF_TABLE_WRITE and RF_TABLE_READ command
45 packets. Our implementation of the rftw command takes the table data input 45 packets. Our implementation of the rftw command takes the table data input
46 in the form of ASCII text files in our format, and the tables read back from 46 in the form of ASCII text files in our format, and the tables read back from
47 the fw via the rftr command can be written out into host files in the same 47 the fw via the rftr command can be written out into host files in the same
48 format. 48 format with the save-rf-table command.
49 49
50 * RF tables that have been saved in the non-volatile FFS can be read out 50 * RF tables that have been saved in the non-volatile FFS can be read out
51 "in vivo" via fc-fsio or "in vitro" from a raw flash dump via tiffs. They 51 "in vivo" via fc-fsio or "in vitro" from a raw flash dump via tiffs. They
52 are in the firmware's native binary format. Our fc-cal2text utility can be 52 are in the firmware's native binary format. Our fc-cal2text utility can be
53 used to convert these binary files into our adopted text format for easier 53 used to convert these binary files into our adopted text format for easier
54 analysis. The conversion is lossless, but we do not currently have a utility 54 analysis. The conversion is lossless.
55 to perform the opposite conversion, as there does not appear to be a use case 55
56 for it. If such a use case does arise, it will be easy to construct the 56 * Any RF table in our ASCII format can be converted back into the corresponding
57 appropriate tool(s). 57 native binary with our fc-cal2bin utility.
58
59 * Each RF table type for which there is a directly corresponding file in FFS
60 can be uploaded into the FFS of a FreeCalypso GSM device directly from our
61 ASCII format with the fc-fsio utility's upload-rf-table command.
58 62
59 In the case of two particular RF tables there is a slight difference between 63 In the case of two particular RF tables there is a slight difference between
60 the way they are stored in FFS and the way they are read and written via Test 64 the way they are stored in FFS and the way they are read and written via Test
61 Mode commands: 65 Mode commands:
62 66
74 The complete table is stored in FFS as a single file of 512 bytes, but it is 78 The complete table is stored in FFS as a single file of 512 bytes, but it is
75 too big for the TM3 protocol. Instead the Test Mode protocol provides 79 too big for the TM3 protocol. Instead the Test Mode protocol provides
76 dedicated TX_TEMPLATE_WRITE (ttw) and TX_TEMPLATE_READ (ttr) commands which 80 dedicated TX_TEMPLATE_WRITE (ttw) and TX_TEMPLATE_READ (ttr) commands which
77 write or read one 32-byte template at a time. 81 write or read one 32-byte template at a time.
78 82
79 The ASCII text file representation of the RF tables adopted in FreeCalypso 83 Our FreeCalypso ASCII RF table format includes support for a table of type
80 follows the Test Mode protocol model where it deviates from the FFS model: 84 tx-ramps; these ramps tables can be written by fc-cal2text, converted back to
81 fc-cal2text turns the /gsm/rf/tx/ramps.* file for each band into 16 individual 85 native binary with fc-cal2bin and uploaded with fc-fsio's upload-rf-table
82 ramp files, and if there is a /gsm/rf/rx/il2agc file, it will be turned into 86 command, but cannot be uploaded with fc-tmsh's rftw command corresponding to
83 three separate il2agc-av, il2agc-max and il2agc-pwr table files. 87 the RF_TABLE_WRITE Test Mode command. There is also an ASCII format for a
88 single Tx ramp template that can be uploaded with the ttw command; templates
89 read back via the ttr command can be saved in the same format with the
90 save-tx-ramp command.
91
92 In the case of the il2agc table, a FreeCalypso ASCII RF table of type il2agc is
93 singular as in the Test Mode protocal, not triple as in FFS.