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

Используйте светодиодную матрицу 8×8 [[amp>product/microbit-kitronik-zip-tile?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Kitronik ZIP Tile]] из умных цветных светодиодов для отображения радужной анимации, бегущего текста и простых изображений. Матрицы объединяются в цепочки или гирлянды. Благодаря симметричному и равномерному размещению светодиодов по лицевой стороне из нескольких панелей легко собрать большой экран.

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

Светодиодная матрица Kitronik ZIP Tile сделана специально для контроллеров [[amp>collection/microbit?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|BBC micro:bit]].


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

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

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

Подключите светодиодную матрицу к платформе mirco:bit, выберите один из двух способов:

  * [[#bbc_microbit_hidden|BBC micro:bit Hidden.]] Плата micro:bit расположена под светодиодной матрицей.
  * [[#bbc_microbit_visible|BBC micro:bit Visible.]] Плата micro:bit расположена над светодиодной матрицей.

В обоих случаях платы скрепляются через 5 отверстий в краевом разъёме платы micro:bit и соответствующих резьбовых отверстий в Kitronik ZIP Tile. Для крепежа используйте металлические винты и пластиковые стойки, которые идут в комплекте.

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

  - [[amp>product/bbc-microbit?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Платформа BBC micro:bit]]
  - [[amp>product/microbit-kitronik-zip-tile?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Kitronik ZIP Tile]]
  - [[amp>product/usb-cable-micro?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Кабель USB (A — Micro USB)]]
  - Источник питания для Kitronik ZIP Tile, например:
    - [[amp>product/battery-holder-3aa?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Батарейный отсек]] с [[amp>product/connector-jst-ph-2-pin?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|разъёмом JST PH-2]] и [[amp>product/battery-aa-duracell?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|элементами питания AA.]]
    - [[amp>product/microbit-power?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Модуль питания micro:bit]] с [[amp>product/power-supply-adapter-robiton-tn1000s?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|сетевым адаптером]].
  - Крепёж из комплекта: винты и стойки

=== BBC micro:bit Hidden ===

  - Установите micro:bit лицевой стороной сверху на обратную сторону платы Kitronik ZIP Tile.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-hardware.1.png?nolink |}}
  - Подключите платформу micro:bit к компьютеру по USB.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-hardware.2.png?nolink |}}
  - Подключите к полученному устройству питания через JST PH-2 разъём.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-hardware.3.png?nolink |}}

=== BBC micro:bit Visible ===

  - Установите micro:bit обратной стороной сверху на обратную сторону платы Kitronik ZIP Tile.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-hardware.4.png?nolink |}}
  - Подключите платформу micro:bit к компьютеру по USB.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-hardware.5.png?nolink |}}
  - Подключите к полученному устройству питания через JST SH-2 разъём.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-hardware.6.png?nolink |}}

==== Программная часть ====

  - [[products:bbc-microbit|Познакомтесь и запустите BBC micro:bit]].
  - [[https://makecode.microbit.org/|Откройте облачную среду программирования MakeCode]].
  - Создайте новый проект.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-software.1.gif?nolink |}}
  - Установите дополнительное программное обеспечение для Kitronik ZIP Tile:\\  <span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Расширенные</span>
<span menu-item>Добавить расширение</span>
</span> и вбейте в поиск строку <span menu><span menu-item>Kitronik ZIP Tile</span></span>. Далее жмите по иконке найденного расширения для установки модуля. После установки в окне компонентов вы увидите дополнительные блоки для светодиодной матрицы.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-software.2.gif?nolink |}}
На этом этапе матрица настроена на работу с системой micro:bit и можно смело переходить к [[#примеры_работы|примерам работы]].



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

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

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

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

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

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

  - Переключите визуальный режим MakeCode на текстовый редактор JavaScript.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-blink-javascript.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript microbit-kitronik-zip-tile-examples-blink-javascript.js>
let tileDisplay = Kitronik_Zip_Tile.createZIPTileDisplay(1, 1, Kitronik_Zip_Tile.UBitLocations.Hidden)
basic.forever(function () {
    tileDisplay.showColor(Kitronik_Zip_Tile.colors(ZipLedColors.Red))
    basic.pause(1000)
    tileDisplay.showColor(Kitronik_Zip_Tile.colors(ZipLedColors.Green))
    basic.pause(1000)
    tileDisplay.showColor(Kitronik_Zip_Tile.colors(ZipLedColors.Blue))
    basic.pause(1000)
    tileDisplay.showColor(Kitronik_Zip_Tile.colors(ZipLedColors.White))
})
</code>
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Tile будут мигать красным, зелёным, синим и белым цветом.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-blink.gif?nolink |}}

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

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

def on_forever():
    tileDisplay.show_color(Kitronik_Zip_Tile.colors(ZipLedColors.RED))
    basic.pause(1000)
    tileDisplay.show_color(Kitronik_Zip_Tile.colors(ZipLedColors.GREEN))
    basic.pause(1000)
    tileDisplay.show_color(Kitronik_Zip_Tile.colors(ZipLedColors.BLUE))
    basic.pause(1000)
    tileDisplay.show_color(Kitronik_Zip_Tile.colors(ZipLedColors.WHITE))
basic.forever(on_forever)

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


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

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

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

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

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

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

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

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

def on_forever():
    pass
basic.forever(on_forever)
</code>
  - После прошивки micro:bit, светодиоды на Kitronik ZIP Tile зажгутся радужным свечением.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-rainbow.png?nolink |}}

==== Бегущая строка ====

А теперь выведем на матрицу бегущую строку с текстом <span menu><span menu-item>Amperka</span></span>.

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

  - Соберите схему из визуальных блоков.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka-blocks.1.png?nolink |}}
  - Нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka-blocks.2.png?nolink |}}
  - После прошивки micro:bit, вы увидите на матрице Kitronik ZIP Tile бегущую строку с текстом <span menu><span menu-item>Amperka</span></span>.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka.gif?nolink |}}

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

  - Переключите визуальный режим MakeCode на текстовый редактор JavaScript.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka-javascript.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript microbit-kitronik-zip-tile-examples-amperka-javascript.js>
let tileDisplay = Kitronik_Zip_Tile.createZIPTileDisplay(1, 1, Kitronik_Zip_Tile.UBitLocations.Hidden)
basic.forever(function () {
    tileDisplay.scrollText(
    "Amperka",
    Kitronik_Zip_Tile.TextDirection.Left,
    100,
    Kitronik_Zip_Tile.TextStyle.None,
    Kitronik_Zip_Tile.colors(ZipLedColors.Red),
    Kitronik_Zip_Tile.colors(ZipLedColors.Orange)
    )
})

</code>
  - После прошивки micro:bit, вы увидите на матрице Kitronik ZIP Tile бегущую строку с текстом <span menu><span menu-item>Amperka</span></span>.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka.gif?nolink |}}

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

  - Переключите визуальный режим MakeCode на текстовый редактор Python.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka-python.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python microbit-kitronik-zip-tile-examples-amperka-python.py>
tileDisplay = Kitronik_Zip_Tile.create_zip_tile_display(1, 1, Kitronik_Zip_Tile.UBitLocations.HIDDEN)

def on_forever():
    tileDisplay.scroll_text("Amperka",
        Kitronik_Zip_Tile.TextDirection.LEFT,
        100,
        Kitronik_Zip_Tile.TextStyle.NONE,
        Kitronik_Zip_Tile.colors(ZipLedColors.RED),
        Kitronik_Zip_Tile.colors(ZipLedColors.ORANGE))
basic.forever(on_forever)

</code>
  - После прошивки micro:bit, вы увидите на матрице Kitronik ZIP Tile бегущую строку с текстом <span menu><span menu-item>Amperka</span></span>.{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-examples-amperka.gif?nolink |}}
===== Элементы платы =====
{{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-annotation.png?nolink |}}

==== Светодиодная матрица ====

На лицевой стороне платы расположена матрица 8×8 адресных светодиодов {{ :products:microbit-kitronik-zip-tile:ws2812b-datasheet.pdf |WS2812B}}.

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

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

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

При желании к Kitronik ZIP Tile можно подключать [[amp>collection/troyka?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Troyka-модули]] для расширения возможностей девайса. Для этого необходимо напаять к плате парочку штырьков [[amp>product/pin-headers?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&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>.

==== Разъём питания JST PH-2 ====

Разъём служит для подключения внешнего источника напряжения для питания светодиодной матрицы. Воспользуйтесь одним из вариантов:
  * [[amp>product/battery-holder-3aa?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Батарейный отсек]] с [[amp>product/connector-jst-ph-2-pin?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|разъёмом JST PH-2]] и [[amp>product/battery-aa-duracell?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|элементами питания AA.]]
  * [[amp>product/microbit-power?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Модуль питания micro:bit]] с [[amp>product/power-supply-adapter-robiton-tn1000s?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|сетевым адаптером]].

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

Входное напряжение от [[#разъём_питания_jst_ph-2|разъёма JST PH-2]] поступает на понижающий регулятор напряжения, которое преобразуется до точных 3,3 вольт.

==== Контакты подключения BBC micro:bit ====

Светодиодная матрица Kitronik ZIP Tile содержит контакты подключения в виде 5 отверстий для коммуникации с платами BBC micro:bit. Возможно подключение двумя способами:

  * Видимое подключение — плата micro:bit прикручивается к винтовым площадкам ZIP Tile и выглядывает из-за светодиодной панели.
  * Потайное подключение — когда micro:bit прикручивается к ZIP Tile таким образом, что плата прячется за светодиодной панелью.

==== Разъёмы расширения матрицы ====

Контактные площадки слева, справа и сверху модуля позволяют собрать дисплей из нескольких панелей. Подробности читайте {{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-datasheet.pdf |в официальной документации от производителя}}.
===== Габаритный чертёж =====
[[this>_media/products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-dimensions.pdf|{{:products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-dimensions.png}}]]

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

  * Модель: Kitronik ZIP Tile (SKU 5645)
  * Совместимость: микрокомпьютеры BBC micro:bit
  * Аппаратный интерфейс: контактные площадки под micro:bit
  * Светодиоды: цветные адресные LED WS2812B
  * Количество светодиодов: 64
  * Количество уровней яркости: 256
  * Разъём питания: JST PH-2
  * Напряжение питания: 3,3–5 В
  * Ток потребления: до 2,73 А (по 41 мА на светодиод)
  * Размеры: 71×58,4×9,7 мм
===== Ресурсы =====
  * [[amp>product/microbit-kitronik-zip-tile?utm_source=man&utm_campaign=microbit-kitronik-zip-tile&utm_medium=wiki|Kitronik ZIP Tile]] в магазине.
  * [[https://github.com/amperka/hardware-drawings/blob/master/microbit-kitronik-zip-tile.svg|Векторное изображение модуля]]
  * [[https://makecode.microbit.org/|Облачная среда MakeCode]]
  * [[https://github.com/KitronikLtd/pxt-kitronik-zip-tile|Библиотека для MakeCode]]
  * {{ :products:microbit-kitronik-zip-tile:microbit-kitronik-zip-tile-datasheet.pdf |Документация на Kitronik ZIP Tile от производителя}}