Arduino:Справочник языка Arduino/Библиотеки/Wire/endTransmission()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция Wire.endTransmission()[1]

Завершает передачу данных ведомому устройству, которая была запущена функцией beginTransmission(), и очередь из байтов для которой создавалась при помощи функции write().

Начиная с Arduino 1.0.1 функция beginTransmission() может работать с булевыми аргументами, меняя свое поведение, чтобы обрести совместимость с теми или иными I2C-девайсами.

Если поставить true, то beginTransmission(), осуществив передачу данных, отправит стоп-сообщение, высвобождающее I2C-шину.

Если поставить false, то requestFrom(), осуществив передачу данных, перезапустит сообщение. Таким образом, I2C-шина не освободится, и это помешает другому ведущему устройству осуществлять передачу данных между сообщениями.

Благодаря этому ведущее устройство может за одну сессию выполнять сразу несколько передач данных.

Значение по умолчанию — true.

Синтаксис

Wire.endTransmission()
Wire.endTransmission(stop)

Параметры

stop  булев аргумент. Если поставить true, после передачи данных будет отправлено стоп-сообщение, освобождающее шину. Если поставить false, после передачи данных будут постоянно отправляться сообщения, благодаря чему соединение будет оставаться в активном состоянии.

Что возвращает

Байт, сообщающий о статусе передачи данных:
0  успешно
1  данных слишком много, чтобы они могли уместиться в буфер передачи
2  при передаче адреса получен NACK
3  при передаче данных получен NACK
4  другая ошибка

См.также

  1. Wire.beginTransmission()
  2. Wire.write()

Внешние ссылки