MSP430-Options.html 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182
  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. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: MSP430 Options</title>
  15. <meta name="description" content="Using as: MSP430 Options">
  16. <meta name="keywords" content="Using as: MSP430 Options">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="MSP430_002dDependent.html#MSP430_002dDependent" rel="up" title="MSP430-Dependent">
  25. <link href="MSP430-Syntax.html#MSP430-Syntax" rel="next" title="MSP430 Syntax">
  26. <link href="MSP430_002dDependent.html#MSP430_002dDependent" rel="prev" title="MSP430-Dependent">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="MSP430-Options"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="MSP430-Syntax.html#MSP430-Syntax" accesskey="n" rel="next">MSP430 Syntax</a>, Up: <a href="MSP430_002dDependent.html#MSP430_002dDependent" accesskey="u" rel="up">MSP430-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>
  61. </div>
  62. <hr>
  63. <a name="Options-14"></a>
  64. <h4 class="subsection">9.29.1 Options</h4>
  65. <a name="index-MSP-430-options-_0028none_0029"></a>
  66. <a name="index-options-for-MSP430-_0028none_0029"></a>
  67. <dl compact="compact">
  68. <dt><code>-mmcu</code></dt>
  69. <dd><p>selects the mcu architecture. If the architecture is 430Xv2 then this
  70. also enables NOP generation unless the <samp>-mN</samp> is also specified.
  71. </p>
  72. </dd>
  73. <dt><code>-mcpu</code></dt>
  74. <dd><p>selects the cpu architecture. If the architecture is 430Xv2 then this
  75. also enables NOP generation unless the <samp>-mN</samp> is also specified.
  76. </p>
  77. </dd>
  78. <dt><code>-msilicon-errata=<var>name</var>[,<var>name</var>&hellip;]</code></dt>
  79. <dd><p>Implements a fixup for named silicon errata. Multiple silicon errata
  80. can be specified by multiple uses of the <samp>-msilicon-errata</samp>
  81. option and/or by including the errata names, separated by commas, on
  82. an individual <samp>-msilicon-errata</samp> option. Errata names
  83. currently recognised by the assembler are:
  84. </p>
  85. <dl compact="compact">
  86. <dt><code>cpu4</code></dt>
  87. <dd><p><code>PUSH #4</code> and <samp>PUSH #8</samp> need longer encodings on the
  88. MSP430. This option is enabled by default, and cannot be disabled.
  89. </p></dd>
  90. <dt><code>cpu8</code></dt>
  91. <dd><p>Do not set the <code>SP</code> to an odd value.
  92. </p></dd>
  93. <dt><code>cpu11</code></dt>
  94. <dd><p>Do not update the <code>SR</code> and the <code>PC</code> in the same instruction.
  95. </p></dd>
  96. <dt><code>cpu12</code></dt>
  97. <dd><p>Do not use the <code>PC</code> in a <code>CMP</code> or <code>BIT</code> instruction.
  98. </p></dd>
  99. <dt><code>cpu13</code></dt>
  100. <dd><p>Do not use an arithmetic instruction to modify the <code>SR</code>.
  101. </p></dd>
  102. <dt><code>cpu19</code></dt>
  103. <dd><p>Insert <code>NOP</code> after <code>CPUOFF</code>.
  104. </p></dd>
  105. </dl>
  106. </dd>
  107. <dt><code>-msilicon-errata-warn=<var>name</var>[,<var>name</var>&hellip;]</code></dt>
  108. <dd><p>Like the <samp>-msilicon-errata</samp> option except that instead of
  109. fixing the specified errata, a warning message is issued instead.
  110. This option can be used alongside <samp>-msilicon-errata</samp> to
  111. generate messages whenever a problem is fixed, or on its own in order
  112. to inspect code for potential problems.
  113. </p>
  114. </dd>
  115. <dt><code>-mP</code></dt>
  116. <dd><p>enables polymorph instructions handler.
  117. </p>
  118. </dd>
  119. <dt><code>-mQ</code></dt>
  120. <dd><p>enables relaxation at assembly time. DANGEROUS!
  121. </p>
  122. </dd>
  123. <dt><code>-ml</code></dt>
  124. <dd><p>indicates that the input uses the large code model.
  125. </p>
  126. </dd>
  127. <dt><code>-mn</code></dt>
  128. <dd><p>enables the generation of a NOP instruction following any instruction
  129. that might change the interrupts enabled/disabled state. The
  130. pipelined nature of the MSP430 core means that any instruction that
  131. changes the interrupt state (<code>EINT</code>, <code>DINT</code>, <code>BIC #8,
  132. SR</code>, <code>BIS #8, SR</code> or <code>MOV.W &lt;&gt;, SR</code>) must be
  133. followed by a NOP instruction in order to ensure the correct
  134. processing of interrupts. By default it is up to the programmer to
  135. supply these NOP instructions, but this command line option enables
  136. the automatic insertion by the assembler, if they are missing.
  137. </p>
  138. </dd>
  139. <dt><code>-mN</code></dt>
  140. <dd><p>disables the generation of a NOP instruction following any instruction
  141. that might change the interrupts enabled/disabled state. This is the
  142. default behaviour.
  143. </p>
  144. </dd>
  145. <dt><code>-my</code></dt>
  146. <dd><p>tells the assembler to generate a warning message if a NOP does not
  147. immediately forllow an instruction that enables or disables
  148. interrupts. This is the default.
  149. </p>
  150. <p>Note that this option can be stacked with the <samp>-mn</samp> option so
  151. that the assembler will both warn about missing NOP instructions and
  152. then insert them automatically.
  153. </p>
  154. </dd>
  155. <dt><code>-mY</code></dt>
  156. <dd><p>disables warnings about missing NOP instructions.
  157. </p>
  158. </dd>
  159. <dt><code>-md</code></dt>
  160. <dd><p>mark the object file as one that requires data to copied from ROM to
  161. RAM at execution startup. Disabled by default.
  162. </p>
  163. </dd>
  164. </dl>
  165. <hr>
  166. <div class="header">
  167. <p>
  168. Next: <a href="MSP430-Syntax.html#MSP430-Syntax" accesskey="n" rel="next">MSP430 Syntax</a>, Up: <a href="MSP430_002dDependent.html#MSP430_002dDependent" accesskey="u" rel="up">MSP430-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>
  169. </div>
  170. </body>
  171. </html>