44eea1ece7e420bfe40fe17a8d5fe8d595e31f33
[fw/altos] / ao-tools / ao-bitbang / ao-bitbang.1
1 .\"
2 .\" Copyright © 2009 Keith Packard <keithp@keithp.com>
3 .\"
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful, but
10 .\" WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 .\" General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License along
15 .\" with this program; if not, write to the Free Software Foundation, Inc.,
16 .\" 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
17 .\"
18 .\"
19 .TH AO-BITBANG 1 "ao-bitbang" ""
20 .SH NAME
21 ao-bitbang \- Low-level cc1111 interface diagnostic tool
22 .SH SYNOPSIS
23 .B "ao-bitbang"
24 .SH DESCRIPTION
25 .I ao-bitbang
26 connects through a CP2103 usb-to-serial converter and uses the GPIO
27 pins to communicate with the debug port on a cc1111 device. It
28 provides raw access to the debug pins to help debug the lowest level
29 communication path.
30 .SH USAGE
31 .I ao-bitbang
32 reads a sequence of bit manipulations from stdin, sends them to the
33 device and reports status on stdout.
34 .P
35 Each line on stdin should contain a single letter command for each of
36 the three debug lines on the cc1111 -- clock, data and reset. Each bit
37 can be in one of three states -- on (C, D or R), off (.) or tri-state
38 (-) for input. Empty lines, or lines starting with '#' are
39 ignored. Anything beyond the last bit in a line is also ignored. The
40 bits must be listed in the correct order, and the 'on' values must
41 match the desired bit.
42 .SH EXAMPLE
43 .IP "Reset the target device"
44 # reset
45 .br
46 C D R
47 .br
48 C D R
49 .br
50 C D R
51 .br
52 C D R
53 .IP "Get Chip ID"
54 #
55 .br
56 # Debug mode - drive RESET_N low for two clock cycles
57 .br
58 #
59 .br
60 C D R
61 .br
62 . D .
63 .br
64 C D .
65 .br
66 . D .
67 .br
68 C D .
69 .br
70 . D R
71 .br
72
73 .br
74 #
75 .br
76 # GET_CHIP_ID
77 .br
78
79 .br
80 C . R   0
81 .br
82 . . R
83 .br
84 C D R   1
85 .br
86 . D R
87 .br
88 C D R   1
89 .br
90 . D R
91 .br
92 C . R   0
93 .br
94 . . R
95 .br
96
97 .br
98 C D R   1
99 .br
100 . D R
101 .br
102 C . R   0
103 .br
104 . . R
105 .br
106 C . R   0
107 .br
108 . . R
109 .br
110 C . R   0
111 .br
112 . . R
113 .br
114
115 .br
116 #
117 .br
118 # start reading again
119 .br
120
121 .br
122 C D R
123 .br
124 . - R
125 .br
126 C - R
127 .br
128 . - R
129 .br
130 C - R
131 .br
132 . - R
133 .br
134 C - R
135 .br
136 . - R
137 .br
138
139 .br
140 C - R
141 .br
142 . - R
143 .br
144 C - R
145 .br
146 . - R
147 .br
148 C - R
149 .br
150 . - R
151 .br
152 C - R
153 .br
154 . - R
155 .br
156
157 .br
158 C - R
159 .br
160 . - R
161 .br
162 C - R
163 .br
164 . - R
165 .br
166 C - R
167 .br
168 . - R
169 .br
170 C - R
171 .br
172 . - R
173 .br
174
175 .br
176 C - R
177 .br
178 . - R
179 .br
180 C - R
181 .br
182 . - R
183 .br
184 C - R
185 .br
186 . - R
187 .br
188 C - R
189 .br
190 . - R
191 .br
192
193 .br
194 C D R
195 .SH AUTHOR
196 Keith Packard