MicroPython:Библиотеки/machine/Класс SPI

Содержание

Введение

Основы

Примеры

Библиотеки

Программы

Платы

Прошивки

Резерв

Резерв

Перевод: Максим Кузьмин

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

Класс SPI – протокол шины SPI (со стороны ведущего устройства)

SPI – это протокол синхронной последовательной передачи данных, управляемый ведущим устройством (мастером). На физическом уровне шина SPI состоит из 3 линий: SCK, MOSI и MISO. Одной и той же шиной могут пользоваться несколько устройств, но у каждого устройства должна быть отдельная 4-ая линия SS («Slave Select», что можно перевести как «выбор ведомого устройства»), чтобы выбрать устройство на шине, с которым будет осуществляться коммуникация. Управление SS-сигналом должно осуществляться в коде пользователя (через класс machine.Pin).

Конструкторы

• machine.SPI()

Методы

• SPI.init()
• SPI.deinit()
• SPI.read()
• SPI.readinto()
• SPI.write()
• SPI.write_readinto()
• [[MicroPython:Библиотеки/machine/Класс SPI/
• [[MicroPython:Библиотеки/machine/Класс SPI/
• [[MicroPython:Библиотеки/machine/Класс SPI/
• [[MicroPython:Библиотеки/machine/Класс SPI/

• SPI.init(baudrate=1000000, *, polarity=0, phase=0, bits=8, firstbit=SPI.MSB, sck=None, mosi=None, miso=None, pins=SCK, MOSI, MISO) – инициализирует шину SPI при помощи заданных параметров:
  • baudrate – тактовая частота линии SCK.
  • polarity – здесь может быть «0» или «1»; это полярность тактового сигнала, и она задает его состояние в момент, когда передача данных не осуществляется.
  • phase – здесь может быть «0» или «1»; это фаза тактового сигнала, и она задает, по какому фронту (он может быть передним или задним) будет считываться значение на линии данных.
  • bits – это размер передаваемых данных (в битах). На всех устройствах гарантированно поддерживается только 8 бит.
  • firstbit – здесь может быть SPI.MSB (самый старший бит) или SPI.LSB (самый младший бит).
  • sck, mosi и miso – это объекты machine.Pin, используемые для линий шины. В большинстве аппаратных SPI-шин (задаваемых в аргументе id в конструкторе) эти контакты фиксированы и поменять их нельзя. В некоторых случаях у аппаратных шин бывает 2-3 альтернативных набора контактов. Произвольное назначение контактов допускаются только при использовании программной (bit-banging) SPI-коммуникации (id = -1).
  • pins – порт WiPy не поддерживает аргументы sck, mosi и miso. Вместо этого контакты для SPI-коммуникации для WiPy задаются с помощью кортежа pins.

В случае аппаратной SPI-шины реальная тактовая частота может быть меньше запрошенной – той, что была задана в аргументе baudrate. Это зависит от компонентов, установленных на платформе. Реальную тактовую частоту можно определить, распечатав объект SPI.

• SPI.deinit() – выключает шину SPI.
• SPI.read(nbytes, write=0) – считывает количество байтов, заданное в аргументе nbytes, попутно безостановочно записывая один байт, заданный в аргументе write. Возвращает объект bytes, содержащий считанные данные.
• SPI.readinto(buf, write=0) – считывает данные в буфер buf, попутно безостановочно записывая один байт, заданный в аргументе write. Возвращает None.

Примечание: На WiPy эта функция возвращает количество считанных байтов.

• SPI.write(buf) – записывает байты, содержащиеся в буфере buf. Возвращает None.

Примечание: На WiPy эта функция возвращает количество записанных байтов.

• SPI.write_readinto(write_buf, read_buf) – записывает байты из буфера write_buf, попутно считывая данные в буфер read_buf. В аргументах write_buf и read_buf может быть задан и одинаковый буфер, и разные буферы, но во втором случае эти буферы должны быть одинакового размера. Возвращает None.

Примечание: На WiPy эта функция возвращает количество записанных байтов. Константы

• SPI.MASTER – для инициализации SPI-шины в режиме ведущего устройства. Используется только на WiPy.
• SPI.MSB – задает, чтобы первым битом был самый старший бит.
• SPI.LSB – задает, чтобы первым битом был самый младший бит.

<syntaxhighlight lang="python" enclose="div">