====== BitFace Breakout Garden: подключение, настройка и начало работы ======

[[amp>product/bitface-breakout-garden?utm_source=man&utm_campaign=bitface-breakout-garden&utm_medium=wiki|BitFace Breakout Garden]] подарит вашему роботу лицо из 17 цветных светодиодов, которые помогут показать текущие эмоции маленького терминатора, например радость, грусть, восхищение и т.д. 

{{ :products:bitface-breakout-garden:bitface-breakout-garden.1.jpg?nolink&600 |}}

Индикаторный модуль отлично подойдёт к роботам с разъёмом Breakout Garden, например [[amp>product/microbit-robot-minibit?utm_source=man&utm_campaign=bitface-breakout-garden&utm_medium=wiki|MiniBit]] или [[amp>product/microbit-robot-bitbot-xl?utm_source=man&utm_campaign=bitface-breakout-garden&utm_medium=wiki|Bit:Bot XL]].

===== Примеры работы =====
BitFace подключается к роботам и другим платформам через разъём Breakout Garden на 5 контактов. В качестве примера подключите модуль со светодиодами к платформе [[amp>product/microbit-robot-minibit?utm_source=man&utm_campaign=bitface-breakout-garden&utm_medium=wiki|MiniBit]].

  - Подключите и настройте платформу [[:products:microbit-robot-minibit#подключение_и_настройка|MiniBit]].
  - Установите плату BitFace в соответствующий разъём на роботе MiniBit.{{ :products:bitface-breakout-garden:bitface-breakout-garden-hardware.1.jpg?nolink |}}

==== Пример для визуального программирования ====
  - Добавьте блок управления глазами.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>MiniBit</span>
<span menu-item>Addons</span>
<span menu-item>BitFace</span>
</span> и выберите блок <span menu><span menu-item>set BitFace eye(s)</span></span>. 
    - Добавьте выбранный блок в цикл ''При начале'' и измените состояние ''left'' на ''both''.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile.1.gif?nolink |}}
  - Добавьте блок управления носом.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>MiniBit</span>
<span menu-item>Addons</span>
<span menu-item>BitFace</span>
</span> и выберите блок <span menu><span menu-item>set BitFace nose</span></span>. 
    - Добавьте выбранный блок в цикл ''При начале'' и измените состояние цвета с красного на зеленый.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile.2.gif?nolink |}}
  - Добавьте блок управления ртом.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>MiniBit</span>
<span menu-item>Addons</span>
<span menu-item>BitFace</span>
</span> и выберите блок <span menu><span menu-item>set BitFace mouth</span></span>. 
    - Добавьте выбранный блок в цикл ''При начале'' и измените состояние цвета с красного на синий.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile.3.gif?nolink |}}
  - Блоки управления готовы, нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile.4.png?nolink |}}
  - После прошивки micro:bit, глаза на плате должны засветится красным цветом, нос — зелёным и улыбка — синим.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile.5.png?nolink |}}
==== Пример для JavaScript ====
  - Переключите визуальный режим Makecode на текстовый редактор JavaScript.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile-js.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript example-face-smile-javascript.js>
minibit.setBitEye(bfEyes.Both, 0xFF0000)
minibit.setBitNose(0x00FF00)
minibit.setBitMouth(bfMouth.Smile, 0x0000FF)
basic.forever(function () {
	
})

</code>{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile-js.2.png?nolink |}}
  - После прошивки micro:bit, глаза на плате должны засветится красным цветом, нос — зелёным и улыбка — синим.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile-js.3.png?nolink |}}

==== Пример для MicroPython ====
  - Переключите визуальный режим Makecode на текстовый редактор MicroPython.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile-python.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python example-face-smile-python.py>
minibit.set_bit_eye(bfEyes.BOTH, 0xFF0000)
minibit.set_bit_nose(0x00FF00)
minibit.set_bit_mouth(bfMouth.SMILE, 0x0000FF)

def on_forever():
    pass
basic.forever(on_forever)
</code>{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile-python.2.png?nolink |}}
  - После прошивки micro:bit, глаза на плате должны засветится красным цветом, нос — зелёным и улыбка — синим.{{ :products:bitface-breakout-garden:bitface-breakout-garden-example-face-smile-python.3.png?nolink |}}
===== Элементы платы =====
{{ :products:bitface-breakout-garden:bitface-breakout-garden-annotation.png?nolink |}}
==== Светодиоды WS2812B ====

На плате расположено 17 адресных светодиодов {{ :products:bitface-breakout-garden:ws2812b-datasheet.pdf |WS2812B}} в виде человеческого лица.

Каждый светодиод состоит из контроллера WS2812 и трёх кристаллов: R – красный, G – зелёный и B – синий. Изменяя ток одного, двух или трёх кристаллов одновременно, можно получить практически любой цвет излучения из видимого спектра. Электрически светодиодные модули WS2812B соединены между собой в цепочку, где первый светодиод выведен на контакт ''S'' разъёма Breakout Garden. Максимальный потребляемый ток каждого светодиода, когда все три кристалла горят на максимум — 60 мА.

Как управлять светодиодами и выводить эмоции читайте в приведённых [[#примеры_работы|примерах работы]].
==== Разъём Breakout Garden (5 pins) ====

Сенсор подключается у мобильным ботам и другим платформам через универсальный разъём Breakout Garden на 5 контактов:

  * Питание (V) — соедините с рабочим напряжением микроконтроллера.
  * Сигнальный (D) — пин данных шины I²C. В дальномере не используется.
  * Сигнальный (C) — пин тактирования шины I²C. В дальномере не используется.
  * Сигнальный (S) — пин приёма данных на цепочку из [[#светодиоды_ws2812b|светодиодов WS2812]].
  * Земля (G) — соедините с землёй микроконтроллера.

===== Габаритный чертёж =====
[[this>_media/products:bitface-breakout-garden:bitface-breakout-garden-dimensions.pdf|{{:products:bitface-breakout-garden:bitface-breakout-garden-dimensions.png}}]]

===== Характеристики =====
  * Модель: BitFace Breakout Garden
  * Совместимость: роботы micro:bit
  * Аппаратный интерфейс: Breakout Garden (5 pins)
  * Программный интерфейс: WS2812, NeoPixel
  * Количество светодиодов: 17
  * Количество цветов: 16 млн цветов (256 оттенков на канал)
  * Напряжение питания: 3,3 В
  * Максимальный потребляемый ток: до 1020 мА
  * Размеры: 57×40×2,9 мм

===== Ресурсы =====
  * [[amp>product/bitface-breakout-garden?utm_source=man&utm_campaign=bitface-breakout-garden&utm_medium=wiki|BitFace Breakout Garden]] в магазине.
  * [[https://github.com/amperka/hardware-drawings/blob/master/bitface-breakout-garden.svg|Векторное изображение модуля]]