comparison docs/manual/x832.html @ 565:fc072f6cde09

Update documentation to reflect includebin offset/length feature
author William Astle <lost@l-w.ca>
date Thu, 21 Dec 2023 22:16:12 -0700
parents
children
comparison
equal deleted inserted replaced
564:87f904e2b304 565:fc072f6cde09
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Cycle Counts</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="LW Tool Chain"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="LWASM"
14 HREF="c62.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Convenience Instructions"
17 HREF="x827.html"><LINK
18 REL="NEXT"
19 TITLE="LWLINK"
20 HREF="c838.html"></HEAD
21 ><BODY
22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >LW Tool Chain</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="x827.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 3. LWASM</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="c838.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECTION"
73 ><H1
74 CLASS="SECTION"
75 ><A
76 NAME="AEN832"
77 >3.12. Cycle Counts</A
78 ></H1
79 ><P
80 >&#13;The following options for displaying cycle counts in listings are provided.
81 These options are enabled from pragmas on the command line or in the
82 assembly files themselves. For compatibility with other assemblers you can
83 use the "OPT" keyword in addition to "PRAGMA."</P
84 ><PRE
85 CLASS="PROGRAMLISTING"
86 >opt c - enable cycle counts: [8]
87 opt cd - enable detailed cycle counts breaking down addressing modes: [5+3]
88 opt ct - show a running subtotal of cycles
89 opt cc - clear the running subtotal</PRE
90 ><P
91 >&#13;The assembler supports both 6809 as well as native-mode 6309 cycle counts.
92 In 6309 mode the counts are displayed in parenthesis instead of brackets.
93 In addition, some operations have a variable cycle count. In this case a
94 "+?" is displayed to alert the reader. Sample output is shown below.</P
95 ><PRE
96 CLASS="PROGRAMLISTING"
97 >266f 7d25e2 (window.asm):00313 [7] 7 move tst putflg
98 2672 2602 (window.asm):00314 [5] 12 bne a@
99 2674 1e13 (window.asm):00315 [8] 20 exg x,u
100 2676 0dd6 (window.asm):00316 [6] 26 a@ tst is6309
101 2678 2618 (window.asm):00317 [5] 31 bne exit@
102 (window.asm):00318 opt 6309
103 267a 10860085 (window.asm):00319 (4) 35 b@ ldw #133
104 267e 113813 (window.asm):00320 (6+?) 41 tfm x+,u+
105 2681 30881b (window.asm):00321 (4+1) 46 leax 27,x
106 2684 33c81b (window.asm):00322 (4+1) 51 leau 27,u
107 2687 4a (window.asm):00323 (1) 52 deca
108 2688 26f0 (window.asm):00324 (5) 57 bne b@</PRE
109 ></DIV
110 ><DIV
111 CLASS="NAVFOOTER"
112 ><HR
113 ALIGN="LEFT"
114 WIDTH="100%"><TABLE
115 SUMMARY="Footer navigation table"
116 WIDTH="100%"
117 BORDER="0"
118 CELLPADDING="0"
119 CELLSPACING="0"
120 ><TR
121 ><TD
122 WIDTH="33%"
123 ALIGN="left"
124 VALIGN="top"
125 ><A
126 HREF="x827.html"
127 ACCESSKEY="P"
128 >Prev</A
129 ></TD
130 ><TD
131 WIDTH="34%"
132 ALIGN="center"
133 VALIGN="top"
134 ><A
135 HREF="index.html"
136 ACCESSKEY="H"
137 >Home</A
138 ></TD
139 ><TD
140 WIDTH="33%"
141 ALIGN="right"
142 VALIGN="top"
143 ><A
144 HREF="c838.html"
145 ACCESSKEY="N"
146 >Next</A
147 ></TD
148 ></TR
149 ><TR
150 ><TD
151 WIDTH="33%"
152 ALIGN="left"
153 VALIGN="top"
154 >Convenience Instructions</TD
155 ><TD
156 WIDTH="34%"
157 ALIGN="center"
158 VALIGN="top"
159 ><A
160 HREF="c62.html"
161 ACCESSKEY="U"
162 >Up</A
163 ></TD
164 ><TD
165 WIDTH="33%"
166 ALIGN="right"
167 VALIGN="top"
168 >LWLINK</TD
169 ></TR
170 ></TABLE
171 ></DIV
172 ></BODY
173 ></HTML
174 >