MarlinSerial.cpp 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392
  1. /*
  2. HardwareSerial.cpp - Hardware serial library for Wiring
  3. Copyright (c) 2006 Nicholas Zambetti. All right reserved.
  4. This library is free software; you can redistribute it and/or
  5. modify it under the terms of the GNU Lesser General Public
  6. License as published by the Free Software Foundation; either
  7. version 2.1 of the License, or (at your option) any later version.
  8. This library is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  11. Lesser General Public License for more details.
  12. You should have received a copy of the GNU Lesser General Public
  13. License along with this library; if not, write to the Free Software
  14. Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  15. Modified 23 November 2006 by David A. Mellis
  16. Modified 28 September 2010 by Mark Sproul
  17. */
  18. #include "Marlin.h"
  19. #include "MarlinSerial.h"
  20. uint8_t selectedSerialPort = 0;
  21. #ifndef AT90USB
  22. // this next line disables the entire HardwareSerial.cpp,
  23. // this is so I can support Attiny series and any other chip without a UART
  24. #if defined(UBRRH) || defined(UBRR0H) || defined(UBRR1H) || defined(UBRR2H) || defined(UBRR3H)
  25. #if UART_PRESENT(SERIAL_PORT)
  26. ring_buffer rx_buffer = { { 0 }, 0, 0 };
  27. #endif
  28. FORCE_INLINE void store_char(unsigned char c)
  29. {
  30. int i = (unsigned int)(rx_buffer.head + 1) % RX_BUFFER_SIZE;
  31. // if we should be storing the received character into the location
  32. // just before the tail (meaning that the head would advance to the
  33. // current location of the tail), we're about to overflow the buffer
  34. // and so we don't write the character or advance the head.
  35. if (i != rx_buffer.tail) {
  36. rx_buffer.buffer[rx_buffer.head] = c;
  37. rx_buffer.head = i;
  38. }
  39. }
  40. #if defined(M_USARTx_RX_vect)
  41. // The serial line receive interrupt routine for a baud rate 115200
  42. // ticks at maximum 11.76 kHz and blocks for 2.688 us at each tick.
  43. // If the serial line is fully utilized, this corresponds to 3.16%
  44. // loading of the CPU (the interrupt invocation overhead not taken into account).
  45. // As the serial line is not fully utilized, the CPU load is likely around 1%.
  46. ISR(M_USARTx_RX_vect)
  47. {
  48. // Test for a framing error.
  49. if (M_UCSRxA & (1<<M_FEx))
  50. {
  51. // Characters received with the framing errors will be ignored.
  52. // Dummy register read (discard)
  53. (void)(*(char *)M_UDRx);
  54. }
  55. else
  56. {
  57. // Read the input register.
  58. unsigned char c = M_UDRx;
  59. if (selectedSerialPort == 0)
  60. store_char(c);
  61. #ifdef DEBUG_DUMP_TO_2ND_SERIAL
  62. UDR1 = c;
  63. #endif //DEBUG_DUMP_TO_2ND_SERIAL
  64. }
  65. }
  66. #ifndef SNMM
  67. ISR(USART1_RX_vect)
  68. {
  69. // Test for a framing error.
  70. if (UCSR1A & (1<<FE1))
  71. {
  72. // Characters received with the framing errors will be ignored.
  73. // Dummy register read (discard)
  74. (void)(*(char *)UDR1);
  75. }
  76. else
  77. {
  78. // Read the input register.
  79. unsigned char c = UDR1;
  80. if (selectedSerialPort == 1)
  81. store_char(c);
  82. #ifdef DEBUG_DUMP_TO_2ND_SERIAL
  83. M_UDRx = c;
  84. #endif //DEBUG_DUMP_TO_2ND_SERIAL
  85. }
  86. }
  87. #endif
  88. #endif
  89. // Constructors ////////////////////////////////////////////////////////////////
  90. MarlinSerial::MarlinSerial()
  91. {
  92. }
  93. // Public Methods //////////////////////////////////////////////////////////////
  94. void MarlinSerial::begin(long baud)
  95. {
  96. uint16_t baud_setting;
  97. bool useU2X = true;
  98. #if F_CPU == 16000000UL && SERIAL_PORT == 0
  99. // hard-coded exception for compatibility with the bootloader shipped
  100. // with the Duemilanove and previous boards and the firmware on the 8U2
  101. // on the Uno and Mega 2560.
  102. if (baud == 57600) {
  103. useU2X = false;
  104. }
  105. #endif
  106. // set up the first (original serial port)
  107. if (useU2X) {
  108. M_UCSRxA = 1 << M_U2Xx;
  109. baud_setting = (F_CPU / 4 / baud - 1) / 2;
  110. } else {
  111. M_UCSRxA = 0;
  112. baud_setting = (F_CPU / 8 / baud - 1) / 2;
  113. }
  114. // assign the baud_setting, a.k.a. ubbr (USART Baud Rate Register)
  115. M_UBRRxH = baud_setting >> 8;
  116. M_UBRRxL = baud_setting;
  117. sbi(M_UCSRxB, M_RXENx);
  118. sbi(M_UCSRxB, M_TXENx);
  119. sbi(M_UCSRxB, M_RXCIEx);
  120. #ifndef SNMM
  121. if (selectedSerialPort == 1) { //set up also the second serial port
  122. if (useU2X) {
  123. UCSR1A = 1 << U2X1;
  124. baud_setting = (F_CPU / 4 / baud - 1) / 2;
  125. } else {
  126. UCSR1A = 0;
  127. baud_setting = (F_CPU / 8 / baud - 1) / 2;
  128. }
  129. // assign the baud_setting, a.k.a. ubbr (USART Baud Rate Register)
  130. UBRR1H = baud_setting >> 8;
  131. UBRR1L = baud_setting;
  132. sbi(UCSR1B, RXEN1);
  133. sbi(UCSR1B, TXEN1);
  134. sbi(UCSR1B, RXCIE1);
  135. }
  136. #endif
  137. }
  138. void MarlinSerial::end()
  139. {
  140. cbi(M_UCSRxB, M_RXENx);
  141. cbi(M_UCSRxB, M_TXENx);
  142. cbi(M_UCSRxB, M_RXCIEx);
  143. #ifndef SNMM
  144. cbi(UCSR1B, RXEN1);
  145. cbi(UCSR1B, TXEN1);
  146. cbi(UCSR1B, RXCIE1);
  147. #endif
  148. }
  149. int MarlinSerial::peek(void)
  150. {
  151. if (rx_buffer.head == rx_buffer.tail) {
  152. return -1;
  153. } else {
  154. return rx_buffer.buffer[rx_buffer.tail];
  155. }
  156. }
  157. int MarlinSerial::read(void)
  158. {
  159. // if the head isn't ahead of the tail, we don't have any characters
  160. if (rx_buffer.head == rx_buffer.tail) {
  161. return -1;
  162. } else {
  163. unsigned char c = rx_buffer.buffer[rx_buffer.tail];
  164. rx_buffer.tail = (unsigned int)(rx_buffer.tail + 1) % RX_BUFFER_SIZE;
  165. return c;
  166. }
  167. }
  168. void MarlinSerial::flush()
  169. {
  170. // don't reverse this or there may be problems if the RX interrupt
  171. // occurs after reading the value of rx_buffer_head but before writing
  172. // the value to rx_buffer_tail; the previous value of rx_buffer_head
  173. // may be written to rx_buffer_tail, making it appear as if the buffer
  174. // were full, not empty.
  175. rx_buffer.head = rx_buffer.tail;
  176. }
  177. /// imports from print.h
  178. void MarlinSerial::print(char c, int base)
  179. {
  180. print((long) c, base);
  181. }
  182. void MarlinSerial::print(unsigned char b, int base)
  183. {
  184. print((unsigned long) b, base);
  185. }
  186. void MarlinSerial::print(int n, int base)
  187. {
  188. print((long) n, base);
  189. }
  190. void MarlinSerial::print(unsigned int n, int base)
  191. {
  192. print((unsigned long) n, base);
  193. }
  194. void MarlinSerial::print(long n, int base)
  195. {
  196. if (base == 0) {
  197. write(n);
  198. } else if (base == 10) {
  199. if (n < 0) {
  200. print('-');
  201. n = -n;
  202. }
  203. printNumber(n, 10);
  204. } else {
  205. printNumber(n, base);
  206. }
  207. }
  208. void MarlinSerial::print(unsigned long n, int base)
  209. {
  210. if (base == 0) write(n);
  211. else printNumber(n, base);
  212. }
  213. void MarlinSerial::print(double n, int digits)
  214. {
  215. printFloat(n, digits);
  216. }
  217. void MarlinSerial::println(void)
  218. {
  219. print('\r');
  220. print('\n');
  221. }
  222. void MarlinSerial::println(const String &s)
  223. {
  224. print(s);
  225. println();
  226. }
  227. void MarlinSerial::println(const char c[])
  228. {
  229. print(c);
  230. println();
  231. }
  232. void MarlinSerial::println(char c, int base)
  233. {
  234. print(c, base);
  235. println();
  236. }
  237. void MarlinSerial::println(unsigned char b, int base)
  238. {
  239. print(b, base);
  240. println();
  241. }
  242. void MarlinSerial::println(int n, int base)
  243. {
  244. print(n, base);
  245. println();
  246. }
  247. void MarlinSerial::println(unsigned int n, int base)
  248. {
  249. print(n, base);
  250. println();
  251. }
  252. void MarlinSerial::println(long n, int base)
  253. {
  254. print(n, base);
  255. println();
  256. }
  257. void MarlinSerial::println(unsigned long n, int base)
  258. {
  259. print(n, base);
  260. println();
  261. }
  262. void MarlinSerial::println(double n, int digits)
  263. {
  264. print(n, digits);
  265. println();
  266. }
  267. // Private Methods /////////////////////////////////////////////////////////////
  268. void MarlinSerial::printNumber(unsigned long n, uint8_t base)
  269. {
  270. unsigned char buf[8 * sizeof(long)]; // Assumes 8-bit chars.
  271. unsigned long i = 0;
  272. if (n == 0) {
  273. print('0');
  274. return;
  275. }
  276. while (n > 0) {
  277. buf[i++] = n % base;
  278. n /= base;
  279. }
  280. for (; i > 0; i--)
  281. print((char) (buf[i - 1] < 10 ?
  282. '0' + buf[i - 1] :
  283. 'A' + buf[i - 1] - 10));
  284. }
  285. void MarlinSerial::printFloat(double number, uint8_t digits)
  286. {
  287. // Handle negative numbers
  288. if (number < 0.0)
  289. {
  290. print('-');
  291. number = -number;
  292. }
  293. // Round correctly so that print(1.999, 2) prints as "2.00"
  294. double rounding = 0.5;
  295. for (uint8_t i=0; i<digits; ++i)
  296. rounding /= 10.0;
  297. number += rounding;
  298. // Extract the integer part of the number and print it
  299. unsigned long int_part = (unsigned long)number;
  300. double remainder = number - (double)int_part;
  301. print(int_part);
  302. // Print the decimal point, but only if there are digits beyond
  303. if (digits > 0)
  304. print(".");
  305. // Extract digits from the remainder one at a time
  306. while (digits-- > 0)
  307. {
  308. remainder *= 10.0;
  309. int toPrint = int(remainder);
  310. print(toPrint);
  311. remainder -= toPrint;
  312. }
  313. }
  314. // Preinstantiate Objects //////////////////////////////////////////////////////
  315. MarlinSerial MSerial;
  316. #endif // whole file
  317. #endif // !AT90USB
  318. // For AT90USB targets use the UART for BT interfacing
  319. #if defined(AT90USB) && defined (BTENABLED)
  320. HardwareSerial bt;
  321. #endif