MarlinSerial.cpp 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379
  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. #ifdef HAS_UART
  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. ISR(USART1_RX_vect)
  67. {
  68. // Test for a framing error.
  69. if (UCSR1A & (1<<FE1))
  70. {
  71. // Characters received with the framing errors will be ignored.
  72. // Dummy register read (discard)
  73. (void)(*(char *)UDR1);
  74. }
  75. else
  76. {
  77. // Read the input register.
  78. unsigned char c = UDR1;
  79. if (selectedSerialPort == 1)
  80. store_char(c);
  81. #ifdef DEBUG_DUMP_TO_2ND_SERIAL
  82. M_UDRx = c;
  83. #endif //DEBUG_DUMP_TO_2ND_SERIAL
  84. }
  85. }
  86. #endif
  87. // Public Methods //////////////////////////////////////////////////////////////
  88. void MarlinSerial::begin(long baud)
  89. {
  90. uint16_t baud_setting;
  91. bool useU2X = true;
  92. #if F_CPU == 16000000UL && SERIAL_PORT == 0
  93. // hard-coded exception for compatibility with the bootloader shipped
  94. // with the Duemilanove and previous boards and the firmware on the 8U2
  95. // on the Uno and Mega 2560.
  96. if (baud == 57600) {
  97. useU2X = false;
  98. }
  99. #endif
  100. // set up the first (original serial port)
  101. if (useU2X) {
  102. M_UCSRxA = 1 << M_U2Xx;
  103. baud_setting = (F_CPU / 4 / baud - 1) / 2;
  104. } else {
  105. M_UCSRxA = 0;
  106. baud_setting = (F_CPU / 8 / baud - 1) / 2;
  107. }
  108. // assign the baud_setting, a.k.a. ubbr (USART Baud Rate Register)
  109. M_UBRRxH = baud_setting >> 8;
  110. M_UBRRxL = baud_setting;
  111. sbi(M_UCSRxB, M_RXENx);
  112. sbi(M_UCSRxB, M_TXENx);
  113. sbi(M_UCSRxB, M_RXCIEx);
  114. if (selectedSerialPort == 1) { //set up also the second serial port
  115. if (useU2X) {
  116. UCSR1A = 1 << U2X1;
  117. baud_setting = (F_CPU / 4 / baud - 1) / 2;
  118. } else {
  119. UCSR1A = 0;
  120. baud_setting = (F_CPU / 8 / baud - 1) / 2;
  121. }
  122. // assign the baud_setting, a.k.a. ubbr (USART Baud Rate Register)
  123. UBRR1H = baud_setting >> 8;
  124. UBRR1L = baud_setting;
  125. sbi(UCSR1B, RXEN1);
  126. sbi(UCSR1B, TXEN1);
  127. sbi(UCSR1B, RXCIE1);
  128. }
  129. }
  130. void MarlinSerial::end()
  131. {
  132. cbi(M_UCSRxB, M_RXENx);
  133. cbi(M_UCSRxB, M_TXENx);
  134. cbi(M_UCSRxB, M_RXCIEx);
  135. cbi(UCSR1B, RXEN1);
  136. cbi(UCSR1B, TXEN1);
  137. cbi(UCSR1B, RXCIE1);
  138. }
  139. int MarlinSerial::peek(void)
  140. {
  141. if (rx_buffer.head == rx_buffer.tail) {
  142. return -1;
  143. } else {
  144. return rx_buffer.buffer[rx_buffer.tail];
  145. }
  146. }
  147. int MarlinSerial::read(void)
  148. {
  149. // if the head isn't ahead of the tail, we don't have any characters
  150. if (rx_buffer.head == rx_buffer.tail) {
  151. return -1;
  152. } else {
  153. unsigned char c = rx_buffer.buffer[rx_buffer.tail];
  154. rx_buffer.tail = (unsigned int)(rx_buffer.tail + 1) % RX_BUFFER_SIZE;
  155. return c;
  156. }
  157. }
  158. void MarlinSerial::flush()
  159. {
  160. // don't reverse this or there may be problems if the RX interrupt
  161. // occurs after reading the value of rx_buffer_head but before writing
  162. // the value to rx_buffer_tail; the previous value of rx_buffer_head
  163. // may be written to rx_buffer_tail, making it appear as if the buffer
  164. // were full, not empty.
  165. rx_buffer.head = rx_buffer.tail;
  166. }
  167. /// imports from print.h
  168. void MarlinSerial::print(char c, int base)
  169. {
  170. print((long) c, base);
  171. }
  172. void MarlinSerial::print(unsigned char b, int base)
  173. {
  174. print((unsigned long) b, base);
  175. }
  176. void MarlinSerial::print(int n, int base)
  177. {
  178. print((long) n, base);
  179. }
  180. void MarlinSerial::print(unsigned int n, int base)
  181. {
  182. print((unsigned long) n, base);
  183. }
  184. void MarlinSerial::print(long n, int base)
  185. {
  186. if (base == 0) {
  187. write(n);
  188. } else if (base == 10) {
  189. if (n < 0) {
  190. print('-');
  191. n = -n;
  192. }
  193. printNumber(n, 10);
  194. } else {
  195. printNumber(n, base);
  196. }
  197. }
  198. void MarlinSerial::print(unsigned long n, int base)
  199. {
  200. if (base == 0) write(n);
  201. else printNumber(n, base);
  202. }
  203. void MarlinSerial::print(double n, int digits)
  204. {
  205. printFloat(n, digits);
  206. }
  207. void MarlinSerial::println(void)
  208. {
  209. // print('\r');
  210. print('\n');
  211. }
  212. /*void MarlinSerial::println(const String &s)
  213. {
  214. print(s);
  215. println();
  216. }*/
  217. void MarlinSerial::println(const char c[])
  218. {
  219. print(c);
  220. println();
  221. }
  222. void MarlinSerial::println(char c, int base)
  223. {
  224. print(c, base);
  225. println();
  226. }
  227. void MarlinSerial::println(unsigned char b, int base)
  228. {
  229. print(b, base);
  230. println();
  231. }
  232. void MarlinSerial::println(int n, int base)
  233. {
  234. print(n, base);
  235. println();
  236. }
  237. void MarlinSerial::println(unsigned int n, int base)
  238. {
  239. print(n, base);
  240. println();
  241. }
  242. void MarlinSerial::println(long n, int base)
  243. {
  244. print(n, base);
  245. println();
  246. }
  247. void MarlinSerial::println(unsigned long n, int base)
  248. {
  249. print(n, base);
  250. println();
  251. }
  252. void MarlinSerial::println(double n, int digits)
  253. {
  254. print(n, digits);
  255. println();
  256. }
  257. // Private Methods /////////////////////////////////////////////////////////////
  258. void MarlinSerial::printNumber(unsigned long n, uint8_t base)
  259. {
  260. unsigned char buf[8 * sizeof(long)]; // Assumes 8-bit chars.
  261. unsigned long i = 0;
  262. if (n == 0) {
  263. print('0');
  264. return;
  265. }
  266. while (n > 0) {
  267. buf[i++] = n % base;
  268. n /= base;
  269. }
  270. for (; i > 0; i--)
  271. print((char) (buf[i - 1] < 10 ?
  272. '0' + buf[i - 1] :
  273. 'A' + buf[i - 1] - 10));
  274. }
  275. void MarlinSerial::printFloat(double number, uint8_t digits)
  276. {
  277. // Handle negative numbers
  278. if (number < 0.0)
  279. {
  280. print('-');
  281. number = -number;
  282. }
  283. // Round correctly so that print(1.999, 2) prints as "2.00"
  284. double rounding = 0.5;
  285. for (uint8_t i=0; i<digits; ++i)
  286. rounding /= 10.0;
  287. number += rounding;
  288. // Extract the integer part of the number and print it
  289. unsigned long int_part = (unsigned long)number;
  290. double remainder = number - (double)int_part;
  291. print(int_part);
  292. // Print the decimal point, but only if there are digits beyond
  293. if (digits > 0)
  294. print('.');
  295. // Extract digits from the remainder one at a time
  296. while (digits-- > 0)
  297. {
  298. remainder *= 10.0;
  299. int toPrint = int(remainder);
  300. print(toPrint);
  301. remainder -= toPrint;
  302. }
  303. }
  304. // Preinstantiate Objects //////////////////////////////////////////////////////
  305. MarlinSerial MSerial;
  306. #endif // whole file
  307. #endif // !AT90USB
  308. // For AT90USB targets use the UART for BT interfacing
  309. #if defined(AT90USB) && defined (BTENABLED)
  310. HardwareSerial bt;
  311. #endif