FreeCalypso > hg > freecalypso-tools

annotate rvinterf/etmsync/fsio.help @ 620:dd162a4cb9fa

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
CHANGES: objective performance comparison instead of blind patch
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 27 Feb 2020 01:21:58 +0000
parents 3a9b8f9c7225
children 28d58a8cd704
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 === main
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 === all
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 The following commands are available:
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4
596
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
5 cleandir Clean FFS directory
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 cpout Copy content out of device FFS to host file system
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 cpout-file Copy out a single file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 dieid Retrieve Calypso die ID via ETM query
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 exec Execute a command script
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 exit Exit from fc-fsio
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 fd Low level file descriptor operations
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 ffs2ver TMFFS2 version query
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 format Format FFS on device (dangerous!)
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 fwrite Write a file into device FFS
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 hd Hex dump of a file in FFS
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 ls Directory listing
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 ll Shorthand for ls -l
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 memdump Dump a target memory region via ETM command
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 omemdump Dump a target memory region via TM3 command
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 mkdir Create a directory in device FFS
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 mk-std-dirs Create standard set of FFS directories
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 pirelli-get-imei Retrieve factory IMEI on Pirelli DP-L10
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 pirelli-magnetite-init Initialize FFS for FC Magnetite fw on Pirelli target
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 preformat Preformat FFS on device (dangerous!)
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 readlink Raw interface to ffs_readlink() API call
593
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
26 rm Delete FFS object
596
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
27 rm-subtree Delete FFS directory subtree
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 set-imeisv Write /etc/IMEISV or /pcm/IMEI file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 set-pcm-string Write /pcm/CGxx files
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 set-rfcap Write /gsm/com/rfcap file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 stat Raw interface to ffs_xlstat() API call
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 symlink Create a symlink in device FFS
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 upload-file Upload a file into device FFS
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 upload-fs Upload a complete file system tree into device FFS
313
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
35 upload-rf-table Upload an RF calibration table into device FFS
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 upload-subtree Upload a subtree into device FFS
392
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
37 write-battery-table Upload table of battery thresholds into device FFS
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
38 write-charging-config Upload FCHG configuration into device FFS
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 To get help on any command, type help and the command keyword.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 The RTOS environment inside GSM device firmwares with which this utility
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 communicates has no notion of a current directory, hence all target side
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 FFS pathnames must be absolute.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45
596
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
46 === cleandir
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
47 cleandir ffs-pathname
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
48
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
49 This command deletes all files and subdirectories contained in the named FFS
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
50 directory, leaving an empty directory; the named FFS directory must exist.
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
51
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
52 This command is primarily intended for cleaning out the /mmi directory when
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
53 experimenting with different UI firmware versions, or after loading AT command
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
54 modem firmware into a device which previously ran some fw version with UI layers
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
55 included.
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
56
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 === cpout
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 cpout target-pathname host-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 This command copies a single file, a directory subtree or the complete device
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61 file system tree from the target device FFS to your Unix host file system.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
63 === cpout-file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64 cpout-file target-pathname host-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
65
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
66 This command is like regular cpout, but assumes that the target pathname refers
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
67 to a single file and not a directory, and skips the pathname validation and
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68 xlstat query steps toward that end.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
70 === dieid
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
71 This command sends an ETM query for the Calypso die ID to the running firmware
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
72 on the target and displays the returned result.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
73
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
74 === exec
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
75 exec script-filename
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
76
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
77 This command executes an fc-fsio command script; each line in the script file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
78 is interpreted and executed as an fc-fsio command.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 If the execution of any command in the script file encounters an error, the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81 processing of the script is stopped and the following commands won't be
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
82 executed.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
83
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
84 === exit
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
85 This command is self-explanatory.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
87 === fd
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
88 fd open ffs-pathname flags
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89 fd read tfd nbytes
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
90 fd close tfd
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
92 These low-level debug commands provide a raw interface to FFS file descriptor
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
93 operations ffs_open(), ffs_read() and ffs_close(); they are intended for deep
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94 developers only.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
95
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
96 === ffs2ver
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
97 This command sends a TMFFS2 version query ETM packet to the running firmware
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
98 on the target and displays the returned result.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
99
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
100 === format
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
101 format format-name
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
102
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
103 This command requests the GSM device firmware to format its flash file system.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
104 The "format name" argument must begin with a forward slash and will be stored
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
105 in the root inode of the newly created FFS; it can also contain some FFS tuning
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
106 settings - see the FFS firmware component source code for the details. It is
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
107 usually sufficient to set the "format name" aka the root inode name to just /,
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
108 although some production lines (TI and Openmoko) have set it to /ffs-root.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
109
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
110 The FFS component in the firmware will normally accept this command only when
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
111 the FFS is in the unformatted state; if instead you wish to blow away an
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
112 existing format, see the preformat command.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
113
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
114 === fwrite
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
115 fwrite ffs-pathname ascii "ASCII string content"
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
116 fwrite ffs-pathname hex "xx xx xx xx ..."
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
117 fwrite ffs-pathname file host-filename
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
118
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
119 This command creates a file or overwrites an existing file in the device FFS,
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
120 using an ASCII string, a binary string given as hex bytes or a host file as the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
121 content to be written.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
122
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
123 === hd
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
124 hd ffs-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
125
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
126 This command displays a hex dump of the named file in FFS, which must be a
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
127 regular file. It will only work if the size of the file is 254 bytes or less;
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
128 to examine larger FFS files, you will need to read them out with the cpout or
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
129 cpout-file command.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
130
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
131 === ls
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
132 ls [-l] ffs-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
133
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
134 This command works much like the classic UNIX ls command, but on the flash file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
135 system of a GSM device. In the basic form (without -l) the named FFS object
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
136 must be a directory, and the operation of the ls command is limited to ETM
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
137 packet exchanges corresponding to ffs_opendir() and ffs_readdir() API calls.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
138 In the long form (with -l) the named FFS object may be of any type (file,
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
139 directory or symlink), and the operation of the ls command involves additional
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
140 ETM packet exchanges corresponding to the ffs_xlstat() API call, as well as some
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
141 FFS pathname validation and manipulation inside the fc-fsio utility itself.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
142
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
143 === ll
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
144 ll ffs-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
145
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
146 This command is a shorthand for ls -l on the given FFS pathname.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
147
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
148 === memdump
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
149 memdump addr length
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
150
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
151 This command requests a read of a target memory address range via the ETM
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
152 memory read command, and displays the returned bytes as a hex dump.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
153 Both arguments are always interpreted as hexadecimal, and the length may not
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
154 exceed 0xEE (238 decimal) - the limit for the ETM memory read command.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
155
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
156 === omemdump
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
157 omemdump addr length
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
158
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
159 This command requests a read of a target memory address range via the TM3
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
160 memory read command, and displays the returned bytes as a hex dump.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
161 Both arguments are always interpreted as hexadecimal, and the length may not
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
162 exceed 0x7C (124 decimal) - the limit for the TM3 memory read command.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
163
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
164 === mkdir
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
165 mkdir ffs-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
166
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
167 This command creates a directory object in the target device FFS at the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
168 specified pathname. If the named directory already exists, it is not an error,
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
169 but it is an error if a non-directory object exists at that pathname.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
170
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
171 === mk-std-dirs
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
172 This command creates the standard set of FFS directories, or rather the set
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
173 deemed as standard for our FreeCalypso firmware projects based on or inspired
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
174 by TI's TCS211. This set currently consists of:
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
175
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
176 /gsm
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
177 /gsm/com
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
178 /gsm/rf
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
179 /gsm/rf/rx
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
180 /gsm/rf/tx
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
181 /pcm
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
182 /sys
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
183 /mmi
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
184 /var
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
185 /var/dbg
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
186 /aud
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
187 /etc
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
188
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
189 Each directory is created as if by our mkdir command, i.e., it is not an error
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
190 if that directory already exists, but it is an error if a non-directory object
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
191 exists at that pathname.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
192
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
193 === pirelli-get-imei
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
194 This command works only if the GSM device with whose firmware fc-fsio is
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
195 communicating is a Pirelli DP-L10, and only if that fw is either one of
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
196 Foxconn/Pirelli's official versions or FC Magnetite - it will not work against
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
197 FC Citrine firmware. When run against a Pirelli phone with a compatible fw
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
198 version, this command will retrieve and display Pirelli's factory IMEI.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
199
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
200 === pirelli-magnetite-init
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
201 This command may only be run against FC Magnetite firmware running on the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
202 Pirelli DP-L10 target, and never against any other target/firmware combination.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
203 See FreeCalypso Magnetite firmware documentation for the details.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
204
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
205 === preformat
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
206 This command requests the GSM device firmware to blow away its flash file system
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
207 and prepare for a new format. DO NOT issue this command unless you really wish
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
208 to blow away your FFS, and if you really do wish to perform this drastic
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
209 operation, the firmware should be fully quiescent with GSM off as in AT+CFUN=0.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
210
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
211 === readlink
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
212 readlink ffs-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
213
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
214 This command provides raw access to the ffs_readlink() API call and displays
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
215 the returned response as a hex dump. Use ls -l (or ll) as a more user-friendly
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
216 interface.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
217
593
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
218 === rm
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
219 rm [-f] ffs-pathname
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
220
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
221 This command deletes the named object in the device FFS, which must be a regular
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
222 file, an empty directory or a symlink.
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
223
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
224 Note that in classic UNIX there are two different "delete file system object"
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
225 elementary operations: unlink for regular files or symlinks and rmdir for empty
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
226 directories, but TI's FFS implementation provides a single ffs_remove() API call
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
227 instead for deleting all 3 object types; our rm command is the interface to
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
228 this ffs_remove() API call.
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
229
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
230 If the -f option is given, the condition where the object to be deleted does not
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
231 exist is treated as not-an-error; all other errors are still reported.
f315cdb1555f fc-fsio help updated for new rm command
Mychaela Falconia <falcon@freecalypso.org>
parents: 392
diff changeset
232
596
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
233 === rm-subtree
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
234 rm-subtree [-f] ffs-pathname
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
235
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
236 This command deletes an entire subtree of directories and files in the target
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
237 device FFS, starting with the specified pathname which must be a directory, not
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
238 a regular file or symlink. It is an approximate equivalent of rm -r in UNIX.
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
239
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
240 If the -f option is given, the condition where the top directory to be deleted
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
241 does not exist is treated as not-an-error; all other errors are still reported.
3a9b8f9c7225 fc-fsio help: cleandir and rm-subtree additions documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 593
diff changeset
242
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
243 === set-imeisv
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
244 set-imeisv fc XXXXXXXX-YYYYYY-ZZ # write /etc/IMEISV
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
245 set-imeisv pcm XXXXXXXX-YYYYYY-ZZ # write /pcm/IMEI
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
246
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
247 This command sets the IMEISV to be used for GSM operation and stores it either
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
248 in /etc/IMEISV (one format) or /pcm/IMEI (a different format) depending on the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
249 "fc" or "pcm" keyword argument. Please refer to the doc/IMEI article in the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
250 FreeCalypso host tools source package for the explanation as to when you should
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
251 use which.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
252
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
253 For the IMEISV argument 16 decimal digits must always be given; punctuation is
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
254 optional and may be placed anywhere.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
255
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
256 === set-pcm-string
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
257 set-pcm-string CGxx "ASCII string content"
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
258
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
259 This command writes the /pcm/CGxx files whose content is displayed by AT+CGxx
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
260 commands; CGxx must be one of CGMI, CGMM, CGMR or CGSN. The length of these
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
261 ASCII string files is limited to 20 characters by TI's firmware design.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
262
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
263 === set-rfcap
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
264 This command writes the /gsm/com/rfcap file to communicate the hardware RF band
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
265 configuration to the firmware as follows:
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
266
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
267 set-rfcap dual-eu # 900/1800 MHz single-region dual-band
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
268 set-rfcap dual-us # 850/1900 MHz single-region dual-band
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
269 set-rfcap tri900 # 900/1800/1900 MHz triband
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
270 set-rfcap tri850 # 850/1800/1900 MHz triband
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
271 set-rfcap quad # All 4 bands
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
272
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
273 === stat
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
274 stat ffs-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
275
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
276 This command provides raw access to the ffs_xlstat() API call; the information
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
277 returned by this call and displayed by this command is similar to what you would
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
278 get with the lstat system call in classic UNIX.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
279
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
280 Use ls -l (or ll) as a more user-friendly interface.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
281
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
282 === symlink
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
283 symlink link-target-pathname link-object-pathname
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
284
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
285 This command creates a symlink object in the FFS; the 2nd argument is the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
286 pathname at which the object is to be created and the 1st argument is the link
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
287 target string to be written into this symlink object - the order of the
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
288 arguments matches the classic UNIX symlink system call.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
289
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
290 Note that although TI's FFS implementation supports symlinks, it appears that
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
291 no production configuration has ever used them.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
292
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
293 === upload-file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
294 upload-file host-file target-file
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
295
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
296 This command uploads a single regular file from your Unix host file system into
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
297 the target device FFS.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
298
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
299 === upload-fs
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
300 upload-fs host-dir
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
301
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
302 This command uploads an entire file system tree from the given host location
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
303 into the target device FFS at the root level.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
304
313
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
305 === upload-rf-table
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
306 upload-rf-table host-table-file [band]
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
307
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
308 This command uploads an RF calibration or configuration table into the target
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
309 device FFS. The table is read from a source file in FreeCalypso ASCII format,
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
310 the type (meaning) of the table is indicated in its header, and the FFS
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
311 pathname into which the bits of this table should be written after conversion
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
312 to binary is known from this table type.
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
313
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
314 Some RF tables are global while others are instantiated for each supported
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
315 frequency band. If the table being uploaded is of the per-band variety, the
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
316 band argument must be given (the name of the band as used in the FFS pathnames
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
317 of that band's calibration/config files); if the table is of the global variety,
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
318 no band argument is allowed.
a9bd4b15f502 fc-fsio help: upload-rf-table addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 24
diff changeset
319
24
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
320 === upload-subtree
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
321 upload-subtree host-dir target-dir
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
322
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
323 This command uploads a directory subtree from your Unix host file system into
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
324 the given non-root directory in the target device FFS.
2323849a5a91 rvinterf/etmsync/fsio.help written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
325
392
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
326 === write-battery-table
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
327 write-battery-table src-file
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
328
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
329 This command provides the mechanism for uploading FreeCalypso-invented battery
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
330 discharge threshold tables to target devices. The argument is the name of the
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
331 table source file on the host; this source file is read and compiled into the
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
332 corresponding binary representation, and the latter is then written into
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
333 /etc/batterytab on the target.
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
334
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
335 === write-charging-config
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
336 write-charging-config src-file
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
337
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
338 This command provides the mechanism for uploading FreeCalypso-invented battery
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
339 charging configuration files (configuration for the FreeCalypso battery charging
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
340 driver FCHG) to target devices. The argument is the name of the config source
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
341 file on the host; this source file is read and compiled into the corresponding
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
342 binary representation, and the latter is then written into /etc/charging on the
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
343 target.
01c97de62dda fc-fsio help: write-battery-table and write-charging-config documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 313
diff changeset
344