HardwareSerial::_rx_complete_irq()

概要

_rx_complete_irq()は、シリアル通信でデータを受信したときに起動される割り込みハンドラの、USART_RX_vectから呼び出され、ATmega328Pの受信バッファからArduinoの受信バッファにデータを移動します。

ソースコード

_rx_complete_irq()は、hardware/arduino/avr/cores/arduino/HardwareSerial_private.hに定義されています。以下に全ソースコードを示します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

void HardwareSerial::_rx_complete_irq(void)
{
  if (bit_is_clear(*_ucsra, UPE0)) {
    // No Parity error, read byte and store it in the buffer if there is
    // room
    unsigned char c = *_udr;
    rx_buffer_index_t i = (unsigned int)(_rx_buffer_head + 1) % SERIAL_RX_BUFFER_SIZE;
 
    // if we should be storing the received character into the location
    // just before the tail (meaning that the head would advance to the
    // current location of the tail), we're about to overflow the buffer
    // and so we don't write the character or advance the head.
    if (i != _rx_buffer_tail) {
      _rx_buffer[_rx_buffer_head] = c;
      _rx_buffer_head = i;
    }
  } else {
    // Parity error, read byte but discard it
    *_udr;
  };
}

入力はありません。戻り値もありません。

1
2

void HardwareSerial::_rx_complete_irq(void)
{

bit_is_clear()で、_ucsra(UCSR0A)レジスタのUPE0が0かどうかを判定します。0のときはパリティエラーがない状態なので、データを読み込みます。

 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

if (bit_is_clear(*_ucsra, UPE0)) {
  // No Parity error, read byte and store it in the buffer if there is
  // room
  unsigned char c = *_udr;
  rx_buffer_index_t i = (unsigned int)(_rx_buffer_head + 1) % SERIAL_RX_BUFFER_SIZE;
 
  // if we should be storing the received character into the location
  // just before the tail (meaning that the head would advance to the
  // current location of the tail), we're about to overflow the buffer
  // and so we don't write the character or advance the head.
  if (i != _rx_buffer_tail) {
    _rx_buffer[_rx_buffer_head] = c;
    _rx_buffer_head = i;
  }

_udr(UDR0)は、受信したデータが入っているレジスタです。

_rx_buffer_headは、今受信したデータを格納する予定の位置を示す変数です。この次に受信するデータを格納する位置を求めて(+1する）、その位置が、バッファの一番古いデータを格納する_rx_buffer_tailと同じであれば、今受信したデータはバッファに格納せずに破棄されます。つまり、最低1バイトは、利用せずに開けておきます。バッファに余裕がある場合は、バッファにデータを格納し、_rx_buffer_headを更新します。

17
18
19
20
21

  } else {
    // Parity error, read byte but discard it
    *_udr;
  };
}

パリティエラーが発生したときは、_udrを読み出し、何もせずに破棄します。

バージョン

Arduino AVR Boards 1.8.6

ライセンス

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

/*
  Copyright (c) 2016 garretlab.
  Added source code explanation by garretlab.
*/

/*
  HardwareSerial_private.h - Hardware serial library for Wiring
  Copyright (c) 2006 Nicholas Zambetti.  All right reserved.

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public
  License along with this library; if not, write to the Free Software
  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

  Modified 23 November 2006 by David A. Mellis
  Modified 28 September 2010 by Mark Sproul
  Modified 14 August 2012 by Alarus
*/

最終更新日

July 31, 2025

inserted by FC2 system