====== Светодиодный диск Kitronik ZIP Halo HD: подключение, настройка и начало работы ======

Используйте светодиодный диск [[amp>product/microbit-kitronik-zip-halo-hd?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Kitronik ZIP Halo HD]] из умных цветных светодиодов для отображения красивой подсветки или радужной анимации. А встроенный пьезоизлучатель, часы реального времени и MEMS-микрофон расширят возможности девайса до светового будильника и цветомузыкальной установки.

{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd.1.jpg?600 |}}

Светодиодный диск Kitronik ZIP Halo HD выполнен специально для контроллеров [[amp>product/bbc-microbit?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|BBC micro:bit]].

===== Подключение и настройка =====

Для старта необходимо [[#аппаратная_часть|подключить железо]] и [[#программная_часть|выполнить программную настройку]].

==== Аппаратная часть ====

Светодиодный диск подключается к платформе micro:bit через фирменный краевой разъём.

=== Что понадобится ===

  - [[amp>product/bbc-microbit?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Платформа BBC micro:bit]]
  - [[amp>product/microbit-kitronik-zip-halo-hd?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Kitronik ZIP Halo HD]]
  - [[amp>product/usb-cable-micro?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Кабель USB (A — Micro USB)]]
  - [[amp>product/battery-aa-duracell?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Элемент питания AA (3 шт.)]]

=== Как собрать ===

  - Установите плату Kitronik ZIP Halo HD в соответствующий разъём на плате micro:bit.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-hardware.1.png?nolink |}}
  - Подключите платформу micro:bit к компьютеру по USB.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-hardware.2.png?nolink |}}
  - Установите три элемента питания AA в батарейный отсек на обратной стороне светодиодного диска.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-hardware.3.png?nolink |}}
  - Включите Kitronik ZIP Halo HD, для этого переключите тумблер питания в режим ''ON''.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-hardware.4.gif?nolink |}}
==== Программная часть ====

  - [[products:bbc-microbit-v2|Познакомтесь и запустите BBC micro:bit]].
  - [[https://makecode.microbit.org/|Откройте облачную среду программирования MakeCode]].
  - Создайте новый проект.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-software.1.gif?nolink |}}
  - Установите дополнительное программное обеспечение для miniBit:\\  <span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Расширенные</span>
<span menu-item>Добавить расширение</span>
</span> и вбейте в поиск строку <span menu><span menu-item>Kitronik ZIP Halo HD</span></span>. Далее жмите по иконке найденного расширения для установки модуля. После установки в окне компонентов вы увидите иконку Kitronik Zip Halo HD.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-software.2.gif?nolink |}}
  - В установленном ПО для светодиодного диска вы найдёте блоки для пищалки, светодиодов, микрофона и часов реального времени.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-software.3.gif?nolink |}}

На этом этапе Kitronik ZIP Halo HD настроен на работу с системой micro:bit и можно смело переходить к [[#примеры_работы|примерам работы]].

===== Примеры работы =====

Рассмотрим несколько примеров по работе со светодиодным диском Kitronik ZIP Halo HD. Каждый пример сопровождается инструкцией по визуальному программированию, а затем кодом на JavaScript и Python.

==== Проверка светодиодов ====

Для начала проведем тест cсветодиодного круга, заставим светодиоды по очереди зажигаться красным, зелёным, синим и белым цветом.

=== Пример для визуального программирования ===

  - Соберите схему из визуальных блоков.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink-blocks.1.png?nolink |}}
  - Нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink-blocks.2.png?nolink |}}
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Halo HD будут мигать красным, зелёным, синим и белым цветом.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink.gif?nolink |}}

=== Пример для JavaScript ===

  - Переключите визуальный режим MakeCode на текстовый редактор JavaScript.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink-javascript.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript microbit-kitronik-zip-halo-hd-examples-blink-javascript.js>
let haloDisplay = kitronik_halo_hd.createZIPHaloDisplay(60)
basic.forever(function () {
    haloDisplay.showColor(kitronik_halo_hd.rgb(255, 0, 0))
    basic.pause(1000)
    haloDisplay.showColor(kitronik_halo_hd.rgb(0, 255, 0))
    basic.pause(1000)
    haloDisplay.showColor(kitronik_halo_hd.rgb(0, 0, 255))
    basic.pause(1000)
    haloDisplay.showColor(kitronik_halo_hd.rgb(255, 255, 255))
    basic.pause(1000)
})
</code>
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Halo HD будут мигать красным, зелёным, синим и белым цветом.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink.gif?nolink |}}

=== Пример для Python ===

  - Переключите визуальный режим MakeCode на текстовый редактор Python.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink-python.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python microbit-kitronik-zip-halo-hd-examples-blink-python.py>
haloDisplay = kitronik_halo_hd.create_zip_halo_display(60)

def on_forever():
    haloDisplay.show_color(kitronik_halo_hd.rgb(255, 0, 0))
    basic.pause(1000)
    haloDisplay.show_color(kitronik_halo_hd.rgb(0, 255, 0))
    basic.pause(1000)
    haloDisplay.show_color(kitronik_halo_hd.rgb(0, 0, 255))
    basic.pause(1000)
    haloDisplay.show_color(kitronik_halo_hd.rgb(255, 255, 255))
    basic.pause(1000)
basic.forever(on_forever)

</code>
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Halo HD будут мигать красным, зелёным, синим и белым цветом.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-blink.gif?nolink |}}

==== Радужное свечение ====

Каждый светодиод на круглом модуле может светится отдельным индивидуальным цветом. Выведем на Kitronik ZIP Halo HD радужное свечение всех цветов.

=== Пример для визуального программирования ===

  - Соберите схему из визуальных блоков.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow-blocks.1.png?nolink |}}
  - Нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow-blocks.2.png?nolink |}}
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Halo HD зажгутся радужным свечением.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow.png?nolink |}}

=== Пример для JavaScript ===

  - Переключите визуальный режим MakeCode на текстовый редактор JavaScript.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow-javascript.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript microbit-kitronik-zip-halo-hd-examples-rainbow-javascript.js>
let haloDisplay = kitronik_halo_hd.createZIPHaloDisplay(60)
haloDisplay.showRainbow(1, 360)
basic.forever(function () {
	
})
</code>
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Halo HD зажгутся радужным свечением.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow.png?nolink |}}

=== Пример для Python ===

  - Переключите визуальный режим MakeCode на текстовый редактор Python.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow-python.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python microbit-kitronik-zip-halo-hd-examples-rainbow-python.py>
haloDisplay = kitronik_halo_hd.create_zip_halo_display(60)
haloDisplay.show_rainbow(1, 360)

def on_forever():
    pass
basic.forever(on_forever)

</code>
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Halo HD зажгутся радужным свечением.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-rainbow.png?nolink |}}

==== Вывод уровня шума ====
Выведем уровень шума в консоль.

=== Пример для визуального программирования ===

  - Соберите схему из визуальных блоков.{{ :products:microbit-kitronik-zip-halo-hd:kitronik-zip-halo-hd-examples-read-noise.1.png?nolink |}}
  - Нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:microbit-kitronik-zip-halo-hd:kitronik-zip-halo-hd-examples-read-noise.2.png?nolink |}}
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте микрофон на изменение уровня шума, например хлопните два раза в ладоши.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-read-noise.png?nolink |}}

=== Пример для JavaScript ===

  - Переключите визуальный режим MakeCode на текстовый редактор JavaScript.{{ :products:microbit-kitronik-zip-halo-hd:kitronik-zip-halo-hd-examples-read-noise-javascript.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript kitronik-zip-halo-hd-examples-read-noise-javascript.js>
basic.forever(function on_forever() {
    serial.writeLine("" + ("" + kitronik_halo_hd.readAverageSoundLevel()))
})
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте микрофон на изменение уровня шума, например хлопните два раза в ладоши.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-read-noise.png?nolink |}}

=== Пример для Python ===

  - Переключите визуальный режим MakeCode на текстовый редактор Python.{{ :products:microbit-kitronik-zip-halo-hd:kitronik-zip-halo-hd-examples-read-noise-python.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python kitronik-zip-halo-hd-examples-read-noise-python.py>
def on_forever():
    serial.write_line("" + str((kitronik_halo_hd.read_average_sound_level())))
basic.forever(on_forever)
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте микрофон на изменение уровня шума, например хлопните два раза в ладоши.{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-examples-read-noise.png?nolink |}}

===== Элементы платы =====
{{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-annotation.png?nolink |}}

==== Светодиодное кольцо ====

По внешнему кругу платы расположено 60 адресных светодиодов {{ :products:microbit-kitronik-zip-halo-hd:ws2812b-mini-datasheet.pdf |WS2812B Mini}}.

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

Для работы cо светодиодами используйте библиотеку [[https://github.com/KitronikLtd/pxt-kitronik-halohd|Kitronik Halo HD для MakeCode]] и читайте в приведённых [[#примеры_работы|примерах работы]].
==== MEMS-микрофон ====

На плате Kitronik ZIP Halo HD расположен микрофон разработанный по технологии MEMS, который позволяет определять звук и уровень шума. Микрофон общается с контроллером BBC micro:bit по аналоговому сигналу. 

Для работы c микрофоном используйте библиотеку [[https://github.com/KitronikLtd/pxt-kitronik-halohd|Kitronik Halo HD для MakeCode]] и читайте в приведённых [[#примеры_работы|примерах работы]].

==== Микросхема RTC ====

За подсчётом времени занимается встроенная микросхема часов реального времени {{ :products:microbit-kitronik-zip-halo-hd:mcp7940n-datasheetpdf.pdf |MCP7940N}}. Чип общается с контроллером BBC micro:bit по интерфейсу I²C c адресом <span menu><span menu-item>0x6F</span></span>. 

Для работы c часами реального времени используйте библиотеку [[https://github.com/KitronikLtd/pxt-kitronik-halohd|Kitronik Halo HD для MakeCode]].

==== Зуммер ====

На модуле расположен пьезодинамик {{ :products:microbit-kitronik-zip-halo-hd:hps12g-datasheet.pdf |HPS12G}} для воспроизведения писков, жужжаний и других простых звуков.

Для работы c зуммером используйте библиотеку [[https://github.com/KitronikLtd/pxt-kitronik-halohd|Kitronik Halo HD для MakeCode]].
==== Батарейный отсек ====

Отсек для батареек служит для установки трёх элементов питания формата AA, например [[amp>product/battery-aa-duracell?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Duracell AA]]. Без батареек [[#светодиодное_кольцо|светодиодное кольцо гореть не будет]].

<WRAP center round important 85%>
Для питания платы используйте батарейки AA с выходным напряжением не более 1,5 вольт. Элементы питания с большим напряжением — выведут модуль из строя.
</WRAP>

==== Тумблер питания ====

За включение питания от [[#батарейный_отсек|батарейного отсека]] используйте механический переключатель на плате с двумя режимами работы:

  * ON — модуль включен.
  * OFF — модуль выключен.

==== Контакты питания ====

Если вам не нужна автономность модуля, вы можете установить на плату разъём JST PH-2 и питать всю конструкцию от [[amp>product/microbit-power?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|модуля питания Power micro:bit]].

==== Контакты ввода-вывода ====

При желании к Kitronik ZIP Halo HD можно подключать [[amp>collection/troyka?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Troyka-модули]] для расширения возможностей девайса. Для этого необходимо напаять к плате парочку штырьков [[amp>product/pin-headers?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|PLS-3]], чтобы получить доступ к контактам micro:bit: <span menu><span menu-item>P1/V/G</span></span> и <span menu><span menu-item>P2/V/G</span></span>.


==== Регулятор напряжения ====

Элементы питания в батарейном отсеке выдают в сумме напряжение от 4,5 до 5 вольт. Понижающий линейный регулятор преобразует напряжение с батарейного отсека до точных 3,3 вольт.
==== Гнездо под краевой разъём BBC micro:bit ====

Светодиодный диск Kitronik ZIP Halo HD содержит гнездо {{ :products:microbit-kitronik-zip-halo-hd:microbit-connector-cylconn-90degree.pdf |Cylconn 90 Degree Connector}} для подключения платы BBC micro:bit через краевой разъём. Никаких проводов и тем более пайки не понадобится.
===== Габаритный чертёж =====

[[this>_media/products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-dimensions.pdf|{{:products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-dimensions.png}}]]

===== Характеристики =====

  * Модель: Kitronik ZIP Halo HD (SKU 5672)
  * Совместимость: микрокомпьютеры BBC micro:bit
  * Аппаратный интерфейс: гнездо под краевой разъём micro:bit
  * Светодиоды: цветные адресные LED WS2812B-Mini
  * Количество светодиодов: 60
  * Количество уровней яркости: 256
  * Встроенная периферия:
    * Часы реального времени (RTC)
    * Пьезо-пищалка
    * MEMS-микрофон
  * Чувствительность микрофона: −42 дБ
  * Отношение сигнал/шум микрофона: 59 дБ
  * Батарейный отсек: 3×AA
  * Напряжение питания: 3,3–5 В
  * Ток потребления: до 0,9 А (по 15 мА на светодиод)
  * Размеры: 86,8×86,8×28,1 мм
===== Ресурсы =====
  * [[amp>product/microbit-kitronik-zip-halo-hd?utm_source=man&utm_campaign=microbit-kitronik-zip-halo-hd&utm_medium=wiki|Kitronik ZIP Halo HD]] в магазине.
  * [[https://github.com/amperka/hardware-drawings/blob/master/microbit-kitronik-zip-halo-hd.svg|Векторное изображение модуля]]
  * [[https://makecode.microbit.org/|Облачная среда MakeCode]]
  * [[https://github.com/KitronikLtd/pxt-kitronik-halohd|Библиотека для MakeCode]]
  * {{ :products:microbit-kitronik-zip-halo-hd:microbit-kitronik-zip-halo-hd-datasheet.pdf |Документация на Kitronik ZIP Halo HD от производителя}}