visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commits
1 Branch
Branch: main
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/as.html/TIC54X_002dDirectives.html

488 lines
23KB
Raw Permalink Blame History 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- This file documents the GNU Assembler "as".

  4. 

  5. Copyright (C) 1991-2020 Free Software Foundation, Inc.

  6. 

  7. Permission is granted to copy, distribute and/or modify this document

  8. under the terms of the GNU Free Documentation License, Version 1.3

  9. or any later version published by the Free Software Foundation;

  10. with no Invariant Sections, with no Front-Cover Texts, and with no

  11. Back-Cover Texts.  A copy of the license is included in the

  12. section entitled "GNU Free Documentation License".

  13.  -->

  14. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  15. <head>

  16. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  17. <title>TIC54X-Directives (Using as)</title>

  18. 

  19. <meta name="description" content="TIC54X-Directives (Using as)">

  20. <meta name="keywords" content="TIC54X-Directives (Using as)">

  21. <meta name="resource-type" content="document">

  22. <meta name="distribution" content="global">

  23. <meta name="Generator" content="makeinfo">

  24. <link href="index.html#Top" rel="start" title="Top">

  25. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">

  26. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  27. <link href="TIC54X_002dDependent.html#TIC54X_002dDependent" rel="up" title="TIC54X-Dependent">

  28. <link href="TIC54X_002dMacros.html#TIC54X_002dMacros" rel="next" title="TIC54X-Macros">

  29. <link href="TIC54X_002dExt.html#TIC54X_002dExt" rel="prev" title="TIC54X-Ext">

  30. <style type="text/css">

  31. <!--

  32. a.summary-letter {text-decoration: none}

  33. blockquote.indentedblock {margin-right: 0em}

  34. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  35. blockquote.smallquotation {font-size: smaller}

  36. div.display {margin-left: 3.2em}

  37. div.example {margin-left: 3.2em}

  38. div.lisp {margin-left: 3.2em}

  39. div.smalldisplay {margin-left: 3.2em}

  40. div.smallexample {margin-left: 3.2em}

  41. div.smalllisp {margin-left: 3.2em}

  42. kbd {font-style: oblique}

  43. pre.display {font-family: inherit}

  44. pre.format {font-family: inherit}

  45. pre.menu-comment {font-family: serif}

  46. pre.menu-preformatted {font-family: serif}

  47. pre.smalldisplay {font-family: inherit; font-size: smaller}

  48. pre.smallexample {font-size: smaller}

  49. pre.smallformat {font-family: inherit; font-size: smaller}

  50. pre.smalllisp {font-size: smaller}

  51. span.nolinebreak {white-space: nowrap}

  52. span.roman {font-family: initial; font-weight: normal}

  53. span.sansserif {font-family: sans-serif; font-weight: normal}

  54. ul.no-bullet {list-style: none}

  55. -->

  56. </style>

  57. 

  58. 

  59. </head>

  60. 

  61. <body lang="en">

  62. <a name="TIC54X_002dDirectives"></a>

  63. <div class="header">

  64. <p>

  65. Next: <a href="TIC54X_002dMacros.html#TIC54X_002dMacros" accesskey="n" rel="next">TIC54X-Macros</a>, Previous: <a href="TIC54X_002dExt.html#TIC54X_002dExt" accesskey="p" rel="prev">TIC54X-Ext</a>, Up: <a href="TIC54X_002dDependent.html#TIC54X_002dDependent" accesskey="u" rel="up">TIC54X-Dependent</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>

  66. </div>

  67. <hr>

  68. <a name="Directives-2"></a>

  69. <h4 class="subsection">9.45.9 Directives</h4>

  70. 

  71. <a name="index-machine-directives_002c-TIC54X"></a>

  72. <a name="index-TIC54X-machine-directives"></a>

  73. 

  74. <dl compact="compact">

  75. <dd>

  76. <a name="index-align-directive_002c-TIC54X"></a>

  77. <a name="index-even-directive_002c-TIC54X"></a>

  78. </dd>

  79. <dt><code>.align [<var>size</var>]</code></dt>

  80. <dt><code>.even</code></dt>

  81. <dd><p>Align the section program counter on the next boundary, based on

  82. <var>size</var>.  <var>size</var> may be any power of 2.  <code>.even</code> is

  83. equivalent to <code>.align</code> with a <var>size</var> of 2.

  84. </p><dl compact="compact">

  85. <dt><code>1</code></dt>

  86. <dd><p>Align SPC to word boundary

  87. </p></dd>

  88. <dt><code>2</code></dt>

  89. <dd><p>Align SPC to longword boundary (same as .even)

  90. </p></dd>

  91. <dt><code>128</code></dt>

  92. <dd><p>Align SPC to page boundary

  93. </p></dd>

  94. </dl>

  95. 

  96. <a name="index-asg-directive_002c-TIC54X"></a>

  97. </dd>

  98. <dt><code>.asg <var>string</var>, <var>name</var></code></dt>

  99. <dd><p>Assign <var>name</var> the string <var>string</var>.  String replacement is

  100. performed on <var>string</var> before assignment.

  101. </p>

  102. <a name="index-eval-directive_002c-TIC54X"></a>

  103. </dd>

  104. <dt><code>.eval <var>string</var>, <var>name</var></code></dt>

  105. <dd><p>Evaluate the contents of string <var>string</var> and assign the result as a

  106. string to the subsym <var>name</var>.  String replacement is performed on

  107. <var>string</var> before assignment.

  108. </p>

  109. <a name="index-bss-directive_002c-TIC54X"></a>

  110. </dd>

  111. <dt><code>.bss <var>symbol</var>, <var>size</var> [, [<var>blocking_flag</var>] [,<var>alignment_flag</var>]]</code></dt>

  112. <dd><p>Reserve space for <var>symbol</var> in the .bss section.  <var>size</var> is in

  113. words.  If present, <var>blocking_flag</var> indicates the allocated space

  114. should be aligned on a page boundary if it would otherwise cross a page

  115. boundary.  If present, <var>alignment_flag</var> causes the assembler to

  116. allocate <var>size</var> on a long word boundary.

  117. </p>

  118. <a name="index-byte-directive_002c-TIC54X"></a>

  119. <a name="index-ubyte-directive_002c-TIC54X"></a>

  120. <a name="index-char-directive_002c-TIC54X"></a>

  121. <a name="index-uchar-directive_002c-TIC54X"></a>

  122. </dd>

  123. <dt><code>.byte <var>value</var> [,...,<var>value_n</var>]</code></dt>

  124. <dt><code>.ubyte <var>value</var> [,...,<var>value_n</var>]</code></dt>

  125. <dt><code>.char <var>value</var> [,...,<var>value_n</var>]</code></dt>

  126. <dt><code>.uchar <var>value</var> [,...,<var>value_n</var>]</code></dt>

  127. <dd><p>Place one or more bytes into consecutive words of the current section.

  128. The upper 8 bits of each word is zero-filled.  If a label is used, it

  129. points to the word allocated for the first byte encountered.

  130. </p>

  131. <a name="index-clink-directive_002c-TIC54X"></a>

  132. </dd>

  133. <dt><code>.clink [&quot;<var>section_name</var>&quot;]</code></dt>

  134. <dd><p>Set STYP_CLINK flag for this section, which indicates to the linker that

  135. if no symbols from this section are referenced, the section should not

  136. be included in the link.  If <var>section_name</var> is omitted, the current

  137. section is used.

  138. </p>

  139. <a name="index-c_005fmode-directive_002c-TIC54X"></a>

  140. </dd>

  141. <dt><code>.c_mode</code></dt>

  142. <dd><p>TBD.

  143. </p>

  144. <a name="index-copy-directive_002c-TIC54X"></a>

  145. </dd>

  146. <dt><code>.copy &quot;<var>filename</var>&quot; | <var>filename</var></code></dt>

  147. <dt><code>.include &quot;<var>filename</var>&quot; | <var>filename</var></code></dt>

  148. <dd><p>Read source statements from <var>filename</var>.  The normal include search

  149. path is used.  Normally .copy will cause statements from the included

  150. file to be printed in the assembly listing and .include will not, but

  151. this distinction is not currently implemented.

  152. </p>

  153. <a name="index-data-directive_002c-TIC54X"></a>

  154. </dd>

  155. <dt><code>.data</code></dt>

  156. <dd><p>Begin assembling code into the .data section.

  157. </p>

  158. <a name="index-double-directive_002c-TIC54X"></a>

  159. <a name="index-ldouble-directive_002c-TIC54X"></a>

  160. <a name="index-float-directive_002c-TIC54X"></a>

  161. <a name="index-xfloat-directive_002c-TIC54X"></a>

  162. </dd>

  163. <dt><code>.double <var>value</var> [,...,<var>value_n</var>]</code></dt>

  164. <dt><code>.ldouble <var>value</var> [,...,<var>value_n</var>]</code></dt>

  165. <dt><code>.float <var>value</var> [,...,<var>value_n</var>]</code></dt>

  166. <dt><code>.xfloat <var>value</var> [,...,<var>value_n</var>]</code></dt>

  167. <dd><p>Place an IEEE single-precision floating-point representation of one or

  168. more floating-point values into the current section.  All but

  169. <code>.xfloat</code> align the result on a longword boundary.  Values are

  170. stored most-significant word first.

  171. </p>

  172. <a name="index-drlist-directive_002c-TIC54X"></a>

  173. <a name="index-drnolist-directive_002c-TIC54X"></a>

  174. </dd>

  175. <dt><code>.drlist</code></dt>

  176. <dt><code>.drnolist</code></dt>

  177. <dd><p>Control printing of directives to the listing file.  Ignored.

  178. </p>

  179. <a name="index-emsg-directive_002c-TIC54X"></a>

  180. <a name="index-mmsg-directive_002c-TIC54X"></a>

  181. <a name="index-wmsg-directive_002c-TIC54X"></a>

  182. </dd>

  183. <dt><code>.emsg <var>string</var></code></dt>

  184. <dt><code>.mmsg <var>string</var></code></dt>

  185. <dt><code>.wmsg <var>string</var></code></dt>

  186. <dd><p>Emit a user-defined error, message, or warning, respectively.

  187. </p>

  188. <a name="index-far_005fmode-directive_002c-TIC54X"></a>

  189. </dd>

  190. <dt><code>.far_mode</code></dt>

  191. <dd><p>Use extended addressing when assembling statements.  This should appear

  192. only once per file, and is equivalent to the -mfar-mode option see <a href="TIC54X_002dOpts.html#TIC54X_002dOpts"><code>-mfar-mode</code></a>.

  193. </p>

  194. <a name="index-fclist-directive_002c-TIC54X"></a>

  195. <a name="index-fcnolist-directive_002c-TIC54X"></a>

  196. </dd>

  197. <dt><code>.fclist</code></dt>

  198. <dt><code>.fcnolist</code></dt>

  199. <dd><p>Control printing of false conditional blocks to the listing file.

  200. </p>

  201. <a name="index-field-directive_002c-TIC54X"></a>

  202. </dd>

  203. <dt><code>.field <var>value</var> [,<var>size</var>]</code></dt>

  204. <dd><p>Initialize a bitfield of <var>size</var> bits in the current section.  If

  205. <var>value</var> is relocatable, then <var>size</var> must be 16.  <var>size</var>

  206. defaults to 16 bits.  If <var>value</var> does not fit into <var>size</var> bits,

  207. the value will be truncated.  Successive <code>.field</code> directives will

  208. pack starting at the current word, filling the most significant bits

  209. first, and aligning to the start of the next word if the field size does

  210. not fit into the space remaining in the current word.  A <code>.align</code>

  211. directive with an operand of 1 will force the next <code>.field</code>

  212. directive to begin packing into a new word.  If a label is used, it

  213. points to the word that contains the specified field.

  214. </p>

  215. <a name="index-global-directive_002c-TIC54X"></a>

  216. <a name="index-def-directive_002c-TIC54X"></a>

  217. <a name="index-ref-directive_002c-TIC54X"></a>

  218. </dd>

  219. <dt><code>.global <var>symbol</var> [,...,<var>symbol_n</var>]</code></dt>

  220. <dt><code>.def <var>symbol</var> [,...,<var>symbol_n</var>]</code></dt>

  221. <dt><code>.ref <var>symbol</var> [,...,<var>symbol_n</var>]</code></dt>

  222. <dd><p><code>.def</code> nominally identifies a symbol defined in the current file

  223. and available to other files.  <code>.ref</code> identifies a symbol used in

  224. the current file but defined elsewhere.  Both map to the standard

  225. <code>.global</code> directive.

  226. </p>

  227. <a name="index-half-directive_002c-TIC54X"></a>

  228. <a name="index-uhalf-directive_002c-TIC54X"></a>

  229. <a name="index-short-directive_002c-TIC54X"></a>

  230. <a name="index-ushort-directive_002c-TIC54X"></a>

  231. <a name="index-int-directive_002c-TIC54X"></a>

  232. <a name="index-uint-directive_002c-TIC54X"></a>

  233. <a name="index-word-directive_002c-TIC54X"></a>

  234. <a name="index-uword-directive_002c-TIC54X"></a>

  235. </dd>

  236. <dt><code>.half <var>value</var> [,...,<var>value_n</var>]</code></dt>

  237. <dt><code>.uhalf <var>value</var> [,...,<var>value_n</var>]</code></dt>

  238. <dt><code>.short <var>value</var> [,...,<var>value_n</var>]</code></dt>

  239. <dt><code>.ushort <var>value</var> [,...,<var>value_n</var>]</code></dt>

  240. <dt><code>.int <var>value</var> [,...,<var>value_n</var>]</code></dt>

  241. <dt><code>.uint <var>value</var> [,...,<var>value_n</var>]</code></dt>

  242. <dt><code>.word <var>value</var> [,...,<var>value_n</var>]</code></dt>

  243. <dt><code>.uword <var>value</var> [,...,<var>value_n</var>]</code></dt>

  244. <dd><p>Place one or more values into consecutive words of the current section.

  245. If a label is used, it points to the word allocated for the first value

  246. encountered.

  247. </p>

  248. <a name="index-label-directive_002c-TIC54X"></a>

  249. </dd>

  250. <dt><code>.label <var>symbol</var></code></dt>

  251. <dd><p>Define a special <var>symbol</var> to refer to the load time address of the

  252. current section program counter.

  253. </p>

  254. <a name="index-length-directive_002c-TIC54X"></a>

  255. <a name="index-width-directive_002c-TIC54X"></a>

  256. </dd>

  257. <dt><code>.length</code></dt>

  258. <dt><code>.width</code></dt>

  259. <dd><p>Set the page length and width of the output listing file.  Ignored.

  260. </p>

  261. <a name="index-list-directive_002c-TIC54X"></a>

  262. <a name="index-nolist-directive_002c-TIC54X"></a>

  263. </dd>

  264. <dt><code>.list</code></dt>

  265. <dt><code>.nolist</code></dt>

  266. <dd><p>Control whether the source listing is printed.  Ignored.

  267. </p>

  268. <a name="index-long-directive_002c-TIC54X"></a>

  269. <a name="index-ulong-directive_002c-TIC54X"></a>

  270. <a name="index-xlong-directive_002c-TIC54X"></a>

  271. </dd>

  272. <dt><code>.long <var>value</var> [,...,<var>value_n</var>]</code></dt>

  273. <dt><code>.ulong <var>value</var> [,...,<var>value_n</var>]</code></dt>

  274. <dt><code>.xlong <var>value</var> [,...,<var>value_n</var>]</code></dt>

  275. <dd><p>Place one or more 32-bit values into consecutive words in the current

  276. section.  The most significant word is stored first.  <code>.long</code> and

  277. <code>.ulong</code> align the result on a longword boundary; <code>xlong</code> does

  278. not.

  279. </p>

  280. <a name="index-loop-directive_002c-TIC54X"></a>

  281. <a name="index-break-directive_002c-TIC54X"></a>

  282. <a name="index-endloop-directive_002c-TIC54X"></a>

  283. </dd>

  284. <dt><code>.loop [<var>count</var>]</code></dt>

  285. <dt><code>.break [<var>condition</var>]</code></dt>

  286. <dt><code>.endloop</code></dt>

  287. <dd><p>Repeatedly assemble a block of code.  <code>.loop</code> begins the block, and

  288. <code>.endloop</code> marks its termination.  <var>count</var> defaults to 1024,

  289. and indicates the number of times the block should be repeated.

  290. <code>.break</code> terminates the loop so that assembly begins after the

  291. <code>.endloop</code> directive.  The optional <var>condition</var> will cause the

  292. loop to terminate only if it evaluates to zero.

  293. </p>

  294. <a name="index-macro-directive_002c-TIC54X"></a>

  295. <a name="index-endm-directive_002c-TIC54X"></a>

  296. </dd>

  297. <dt><code><var>macro_name</var> .macro [<var>param1</var>][,...<var>param_n</var>]</code></dt>

  298. <dt><code>[.mexit]</code></dt>

  299. <dt><code>.endm</code></dt>

  300. <dd><p>See the section on macros for more explanation (See <a href="TIC54X_002dMacros.html#TIC54X_002dMacros">TIC54X-Macros</a>.

  301. </p>

  302. <a name="index-mlib-directive_002c-TIC54X"></a>

  303. </dd>

  304. <dt><code>.mlib &quot;<var>filename</var>&quot; | <var>filename</var></code></dt>

  305. <dd><p>Load the macro library <var>filename</var>.  <var>filename</var> must be an

  306. archived library (BFD ar-compatible) of text files, expected to contain

  307. only macro definitions.   The standard include search path is used.

  308. </p>

  309. <a name="index-mlist-directive_002c-TIC54X"></a>

  310. <a name="index-mnolist-directive_002c-TIC54X"></a>

  311. </dd>

  312. <dt><code>.mlist</code></dt>

  313. <dt><code>.mnolist</code></dt>

  314. <dd><p>Control whether to include macro and loop block expansions in the

  315. listing output.  Ignored.

  316. </p>

  317. <a name="index-mmregs-directive_002c-TIC54X"></a>

  318. </dd>

  319. <dt><code>.mmregs</code></dt>

  320. <dd><p>Define global symbolic names for the &rsquo;c54x registers.  Supposedly

  321. equivalent to executing <code>.set</code> directives for each register with

  322. its memory-mapped value, but in reality is provided only for

  323. compatibility and does nothing.

  324. </p>

  325. <a name="index-newblock-directive_002c-TIC54X"></a>

  326. </dd>

  327. <dt><code>.newblock</code></dt>

  328. <dd><p>This directive resets any TIC54X local labels currently defined.  Normal

  329. <code>as</code> local labels are unaffected.

  330. </p>

  331. <a name="index-option-directive_002c-TIC54X"></a>

  332. </dd>

  333. <dt><code>.option <var>option_list</var></code></dt>

  334. <dd><p>Set listing options.  Ignored.

  335. </p>

  336. <a name="index-sblock-directive_002c-TIC54X"></a>

  337. </dd>

  338. <dt><code>.sblock &quot;<var>section_name</var>&quot; | <var>section_name</var> [,&quot;<var>name_n</var>&quot; | <var>name_n</var>]</code></dt>

  339. <dd><p>Designate <var>section_name</var> for blocking.  Blocking guarantees that a

  340. section will start on a page boundary (128 words) if it would otherwise

  341. cross a page boundary.  Only initialized sections may be designated with

  342. this directive.  See also See <a href="TIC54X_002dBlock.html#TIC54X_002dBlock">TIC54X-Block</a>.

  343. </p>

  344. <a name="index-sect-directive_002c-TIC54X"></a>

  345. </dd>

  346. <dt><code>.sect &quot;<var>section_name</var>&quot;</code></dt>

  347. <dd><p>Define a named initialized section and make it the current section.

  348. </p>

  349. <a name="index-set-directive_002c-TIC54X"></a>

  350. <a name="index-equ-directive_002c-TIC54X"></a>

  351. </dd>

  352. <dt><code><var>symbol</var> .set &quot;<var>value</var>&quot;</code></dt>

  353. <dt><code><var>symbol</var> .equ &quot;<var>value</var>&quot;</code></dt>

  354. <dd><p>Equate a constant <var>value</var> to a <var>symbol</var>, which is placed in the

  355. symbol table.  <var>symbol</var> may not be previously defined.

  356. </p>

  357. <a name="index-space-directive_002c-TIC54X"></a>

  358. <a name="index-bes-directive_002c-TIC54X"></a>

  359. </dd>

  360. <dt><code>.space <var>size_in_bits</var></code></dt>

  361. <dt><code>.bes <var>size_in_bits</var></code></dt>

  362. <dd><p>Reserve the given number of bits in the current section and zero-fill

  363. them.  If a label is used with <code>.space</code>, it points to the

  364. <strong>first</strong> word reserved.  With <code>.bes</code>, the label points to the

  365. <strong>last</strong> word reserved.

  366. </p>

  367. <a name="index-sslist-directive_002c-TIC54X"></a>

  368. <a name="index-ssnolist-directive_002c-TIC54X"></a>

  369. </dd>

  370. <dt><code>.sslist</code></dt>

  371. <dt><code>.ssnolist</code></dt>

  372. <dd><p>Controls the inclusion of subsym replacement in the listing output.  Ignored.

  373. </p>

  374. <a name="index-string-directive_002c-TIC54X"></a>

  375. <a name="index-pstring-directive_002c-TIC54X"></a>

  376. </dd>

  377. <dt><code>.string &quot;<var>string</var>&quot; [,...,&quot;<var>string_n</var>&quot;]</code></dt>

  378. <dt><code>.pstring &quot;<var>string</var>&quot; [,...,&quot;<var>string_n</var>&quot;]</code></dt>

  379. <dd><p>Place 8-bit characters from <var>string</var> into the current section.

  380. <code>.string</code> zero-fills the upper 8 bits of each word, while

  381. <code>.pstring</code> puts two characters into each word, filling the

  382. most-significant bits first.  Unused space is zero-filled.  If a label

  383. is used, it points to the first word initialized.

  384. </p>

  385. <a name="index-struct-directive_002c-TIC54X"></a>

  386. <a name="index-tag-directive_002c-TIC54X"></a>

  387. <a name="index-endstruct-directive_002c-TIC54X"></a>

  388. </dd>

  389. <dt><code>[<var>stag</var>] .struct [<var>offset</var>]</code></dt>

  390. <dt><code>[<var>name_1</var>] element [<var>count_1</var>]</code></dt>

  391. <dt><code>[<var>name_2</var>] element [<var>count_2</var>]</code></dt>

  392. <dt><code>[<var>tname</var>] .tag <var>stagx</var> [<var>tcount</var>]</code></dt>

  393. <dt><code>...</code></dt>

  394. <dt><code>[<var>name_n</var>] element [<var>count_n</var>]</code></dt>

  395. <dt><code>[<var>ssize</var>] .endstruct</code></dt>

  396. <dt><code><var>label</var> .tag [<var>stag</var>]</code></dt>

  397. <dd><p>Assign symbolic offsets to the elements of a structure.  <var>stag</var>

  398. defines a symbol to use to reference the structure.  <var>offset</var>

  399. indicates a starting value to use for the first element encountered;

  400. otherwise it defaults to zero.  Each element can have a named offset,

  401. <var>name</var>, which is a symbol assigned the value of the element&rsquo;s offset

  402. into the structure.  If <var>stag</var> is missing, these become global

  403. symbols.  <var>count</var> adjusts the offset that many times, as if

  404. <code>element</code> were an array.  <code>element</code> may be one of

  405. <code>.byte</code>, <code>.word</code>, <code>.long</code>, <code>.float</code>, or any

  406. equivalent of those, and the structure offset is adjusted accordingly.

  407. <code>.field</code> and <code>.string</code> are also allowed; the size of

  408. <code>.field</code> is one bit, and <code>.string</code> is considered to be one

  409. word in size.  Only element descriptors, structure/union tags,

  410. <code>.align</code> and conditional assembly directives are allowed within

  411. <code>.struct</code>/<code>.endstruct</code>.  <code>.align</code> aligns member offsets

  412. to word boundaries only.  <var>ssize</var>, if provided, will always be

  413. assigned the size of the structure.

  414. </p>

  415. <p>The <code>.tag</code> directive, in addition to being used to define a

  416. structure/union element within a structure, may be used to apply a

  417. structure to a symbol.  Once applied to <var>label</var>, the individual

  418. structure elements may be applied to <var>label</var> to produce the desired

  419. offsets using <var>label</var> as the structure base.

  420. </p>

  421. <a name="index-tab-directive_002c-TIC54X"></a>

  422. </dd>

  423. <dt><code>.tab</code></dt>

  424. <dd><p>Set the tab size in the output listing.  Ignored.

  425. </p>

  426. <a name="index-union-directive_002c-TIC54X"></a>

  427. <a name="index-tag-directive_002c-TIC54X-1"></a>

  428. <a name="index-endunion-directive_002c-TIC54X"></a>

  429. </dd>

  430. <dt><code>[<var>utag</var>] .union</code></dt>

  431. <dt><code>[<var>name_1</var>] element [<var>count_1</var>]</code></dt>

  432. <dt><code>[<var>name_2</var>] element [<var>count_2</var>]</code></dt>

  433. <dt><code>[<var>tname</var>] .tag <var>utagx</var>[,<var>tcount</var>]</code></dt>

  434. <dt><code>...</code></dt>

  435. <dt><code>[<var>name_n</var>] element [<var>count_n</var>]</code></dt>

  436. <dt><code>[<var>usize</var>] .endstruct</code></dt>

  437. <dt><code><var>label</var> .tag [<var>utag</var>]</code></dt>

  438. <dd><p>Similar to <code>.struct</code>, but the offset after each element is reset to

  439. zero, and the <var>usize</var> is set to the maximum of all defined elements.

  440. Starting offset for the union is always zero.

  441. </p>

  442. <a name="index-usect-directive_002c-TIC54X"></a>

  443. </dd>

  444. <dt><code>[<var>symbol</var>] .usect &quot;<var>section_name</var>&quot;, <var>size</var>, [,[<var>blocking_flag</var>] [,<var>alignment_flag</var>]]</code></dt>

  445. <dd><p>Reserve space for variables in a named, uninitialized section (similar to

  446. .bss).  <code>.usect</code> allows definitions sections independent of .bss.

  447. <var>symbol</var> points to the first location reserved by this allocation.

  448. The symbol may be used as a variable name.  <var>size</var> is the allocated

  449. size in words.  <var>blocking_flag</var> indicates whether to block this

  450. section on a page boundary (128 words) (see <a href="TIC54X_002dBlock.html#TIC54X_002dBlock">TIC54X-Block</a>).

  451. <var>alignment flag</var> indicates whether the section should be

  452. longword-aligned.

  453. </p>

  454. <a name="index-var-directive_002c-TIC54X"></a>

  455. </dd>

  456. <dt><code>.var <var>sym</var>[,..., <var>sym_n</var>]</code></dt>

  457. <dd><p>Define a subsym to be a local variable within a macro.  See

  458. See <a href="TIC54X_002dMacros.html#TIC54X_002dMacros">TIC54X-Macros</a>.

  459. </p>

  460. <a name="index-version-directive_002c-TIC54X"></a>

  461. </dd>

  462. <dt><code>.version <var>version</var></code></dt>

  463. <dd><p>Set which processor to build instructions for.  Though the following

  464. values are accepted, the op is ignored.

  465. </p><dl compact="compact">

  466. <dt><code>541</code></dt>

  467. <dt><code>542</code></dt>

  468. <dt><code>543</code></dt>

  469. <dt><code>545</code></dt>

  470. <dt><code>545LP</code></dt>

  471. <dt><code>546LP</code></dt>

  472. <dt><code>548</code></dt>

  473. <dt><code>549</code></dt>

  474. </dl>

  475. </dd>

  476. </dl>

  477. 

  478. <hr>

  479. <div class="header">

  480. <p>

  481. Next: <a href="TIC54X_002dMacros.html#TIC54X_002dMacros" accesskey="n" rel="next">TIC54X-Macros</a>, Previous: <a href="TIC54X_002dExt.html#TIC54X_002dExt" accesskey="p" rel="prev">TIC54X-Ext</a>, Up: <a href="TIC54X_002dDependent.html#TIC54X_002dDependent" accesskey="u" rel="up">TIC54X-Dependent</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>

  482. </div>

  483. 

  484. 

  485. 

  486. </body>

  487. </html>