====== Плата мониторинга окружающей среды enviro:bit: подключение, настройка и начало работы ======

Используйте [[amp>product/pimoroni-microbit-envirobit?utm_source=man&utm_campaign=pimoroni-microbit-envirobit&utm_medium=wiki|enviro:bit]] для мониторинга окружающей среды. Плата выполнена специально для контроллеров [[amp>product/bbc-microbit?utm_source=man&utm_campaign=pimoroni-microbit-envirobit&utm_medium=wiki|BBC micro:bit]] и готова работать прямо из коробки.

{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit.2.jpg?nolink |}}

На плате расположено три датчика:

  * Метеодатчик: измерит атмосферное давление, температуру и влажность окружающей среды
  * Датчик света и цвета: оценит общую освещённость и поможет выделить уровни хроматических составляющих RGB в падающем свете.
  * Микрофон: выступит в роли сенсора шума.
===== Подключение и настройка =====

Для старта необходимо выполнить аппаратную и программную настройку.
==== Аппаратная часть ====

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

  - Установите плату enviro:bit в соответствующий разъём на плате micro:bit.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-hardware.1.jpg?nolink&600 |}}
  - Подключите micro:bit к компьютеру по USB.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-hardware.2.jpg?nolink&600 |}}
==== Программная часть ====

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


==== Вывод температуры ====

Выведем температуру окружающей среды в консоль.

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

  - Добавьте блок вывода данных в консоль.
    - Зайдите в меню:<span menu>
<span menu-item>Последовательный порт</span>
</span> и выберите блок <span menu><span menu-item>Последовательный порт записать линию</span></span>. 
    - Добавьте выбранный блок в цикл блока <span menu><span menu-item>Постоянно</span></span>.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.1.gif?nolink |}}
  - Добавьте блок паузы для читабельности будущих данных.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Основное</span>
</span> и выберите блок <span menu><span menu-item>пауза (мс)</span></span>. 
    - Добавьте выбранный блок в цикл <span menu><span menu-item>При начале</span></span>. Значения оставьте <span menu><span menu-item>100</span></span> по умолчанию.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.2.gif?nolink |}}
  - Добавьте блок считывания данных температуры окружающей среды.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Enviro:Bit</span>
<span menu-item>Air & Weather</span>
</span> и выберите блок <span menu><span menu-item>Get temperature</span></span>. 
    - Добавьте выбранный блок в блок <span menu><span menu-item>Последовательный порт записать линию</span></span>.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.3.gif?nolink |}}
  - Блоки управления готовы, нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.4.png?nolink |}}
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте метеодатчик на изменение температуры, например подышите на него.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.5.png?nolink |}}

=== Пример для JavaScript ===
  - Переключите в среде MakeCode визуальный режим на текстовый редактор JavaScript.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-js.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript example-read-temperature-js.js>
basic.forever(function () {
  serial.writeLine("" + envirobit.getTemperature());
  basic.pause(100);
});

</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте метеодатчик на изменение температуры, например подышите на него.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.5.png?nolink |}}

=== Пример для Python ===
  - Переключите в среде MakeCode визуальный режим на текстовый редактор Python.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-py.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python example-read-temperature-py.py>
def on_forever():
    serial.write_line("" + str((envirobit.get_temperature())))
    basic.pause(100)
basic.forever(on_forever)
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте метеодатчик на изменение температуры, например подышите на него.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-temperature-blocks.5.png?nolink |}}

==== Вывод освещенности ====

Выведем освещенность окружающей среды в консоль.

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

  - Добавьте блок вывода данных в консоль.
    - Зайдите в меню:<span menu>
<span menu-item>Последовательный порт</span>
</span> и выберите блок <span menu><span menu-item>Последовательный порт записать линию</span></span>. 
    - Добавьте выбранный блок в цикл блока <span menu><span menu-item>Постоянно</span></span>.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.1.gif?nolink |}}
  - Добавьте блок паузы для читабельности будущих данных.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Основное</span>
</span> и выберите блок <span menu><span menu-item>пауза (мс)</span></span>. 
    - Добавьте выбранный блок в цикл <span menu><span menu-item>При начале</span></span>. Значения оставьте <span menu><span menu-item>100</span></span> по умолчанию.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.2.gif?nolink |}}
  - Добавьте блок считывания данных температуры окружающей среды.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Enviro:Bit</span>
<span menu-item>Color & Light</span>
</span> и выберите блок <span menu><span menu-item>Get light</span></span>. 
    - Добавьте выбранный блок в блок <span menu><span menu-item>Последовательный порт записать линию</span></span>.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.3.gif?nolink |}}
  - Блоки управления готовы, нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.4.png?nolink |}}
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте датчик света на изменение освещенности, например посветите на него фонариком.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.5.png?nolink |}}

=== Пример для JavaScript ===
  - Переключите в среде MakeCode визуальный режим на текстовый редактор JavaScript.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-js.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript example-read-light-js.js>
basic.forever(function () {
  serial.writeLine("" + envirobit.getLight());
  basic.pause(100);
});
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте датчик света на изменение освещенности, например посветите на него фонариком.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.5.png?nolink |}}

=== Пример для Python ===
  - Переключите в среде MakeCode визуальный режим на текстовый редактор Python.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-py.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python example-read-light-py.py>
def on_forever():
    serial.write_line("" + str((envirobit.get_light())))
    basic.pause(100)
basic.forever(on_forever)
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте датчик света на изменение освещенности, например посветите на него фонариком.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-light-blocks.5.png?nolink |}}

==== Вывод уровня шума ====

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

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

  - Добавьте блок вывода данных в консоль.
    - Зайдите в меню:<span menu>
<span menu-item>Последовательный порт</span>
</span> и выберите блок <span menu><span menu-item>Последовательный порт записать линию</span></span>. 
    - Добавьте выбранный блок в цикл блока <span menu><span menu-item>Постоянно</span></span>.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.1.gif?nolink |}}
  - Добавьте блок паузы для читабельности будущих данных.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Основное</span>
</span> и выберите блок <span menu><span menu-item>пауза (мс)</span></span>. 
    - Добавьте выбранный блок в цикл <span menu><span menu-item>При начале</span></span>. Значения оставьте <span menu><span menu-item>100</span></span> по умолчанию.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.2.gif?nolink |}}
  - Добавьте блок считывания данных температуры окружающей среды.
    - Зайдите в меню:<span menu>
<span menu-item>Окно компонентов</span>
<span menu-item>Enviro:Bit</span>
<span menu-item>Color & Light</span>
</span> и выберите блок <span menu><span menu-item>Get light</span></span>. 
    - Добавьте выбранный блок в блок <span menu><span menu-item>Последовательный порт записать линию</span></span>.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.3.gif?nolink |}}
  - Блоки управления готовы, нажмите на иконку со значком USB для загрузки программы в плату micro:bit.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.4.png?nolink |}}
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте микрофон на изменение уровня шума, например хлопните два раза в ладоши.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.5.png?nolink |}}

=== Пример для JavaScript ===
  - Переключите в среде MakeCode визуальный режим на текстовый редактор JavaScript.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-js.1.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code javascript example-read-noise-js.js>
basic.forever(function () {
  serial.writeLine("" + envirobit.getNoiseLevel());
  basic.pause(100);
});
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте микрофон на изменение уровня шума, например хлопните два раза в ладоши.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.5.png?nolink |}}

=== Пример для Python ===
  - Переключите в среде MakeCode визуальный режим на текстовый редактор Python.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-py.gif?nolink |}}
  - Прошейте платформу кодом приведённым ниже.<code python example-read-noise-py.py>
def on_forever():
    serial.write_line("" + str((envirobit.get_noise_level())))
    basic.pause(100)
basic.forever(on_forever)
</code>
  - После прошивки micro:bit, откройте монитор последовательного порта и протестируйте микрофон на изменение уровня шума, например хлопните два раза в ладоши.{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-example-read-noise-blocks.5.png?nolink |}}

===== Элементы платы =====
{{ :products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-annotation.png?nolink |}}
==== Метеодатчик BME280 ====

Метеосенсор выполнен на чипе {{ :products:pimoroni-microbit-envirobit:bme280-datasheet.pdf |BME280}}, который измеряет атмосферное давление, а также температуру и влажность окружающей среды. Сенсор BME280 общается с контроллером BBC micro:bit по интерфейсу I²C с адресом ''0x76''. Для связи c датчиком используйте [[https://github.com/pimoroni/pxt-envirobit|библиотеку Envirobit для MakeCode от производителя]].
==== Датчик света и цвета TCS34725 ====

Сенсор света и цвета выполнен на чипе {{ :products:pimoroni-microbit-envirobit:tcs34725-datasheet.pdf |TCS34725}}, который измеряет уровень освещенности и помогает выделить уровни хроматических составляющих RGB в падающем свете. Сенсор TCS34725 общается с контроллером BBC micro:bit по интерфейсу I²C с адресом ''0x29''. Для связи c датчиком используйте [[https://github.com/pimoroni/pxt-envirobit|библиотеку Envirobit для MakeCode от производителя]].

==== Микрофон SPU0410HR5H-PB ====

На плате Enviro расположен микрофон MEMS {{ :products:pimoroni-microbit-envirobit:spu0410hr5h-pb-datasheet.pdf |SPU0410HR5H-PB}}, который позволяет определять звук и уровень шума. Микрофон SPU0410HR5H-PB общается с контроллером BBC micro:bit по аналоговому сигналу. Для связи c датчиком используйте [[https://github.com/pimoroni/pxt-envirobit|библиотеку Envirobit для MakeCode от производителя]].
==== Гнездо под краевой разъём BBC micro:bit ====

Плата мониторинга окружающей среды enviro:bit содержит гнездо {{ :products:pimoroni-microbit-envirobit:microbit-connector-cylconn-90degree.pdf |Cylconn 90 Degree Connector}} для подключения платы BBC micro:bit через краевой разъём. Никаких проводов и тем более пайки не понадобится.
===== Габаритный чертёж =====
[[this>_media/products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-dimensions.pdf|{{:products:pimoroni-microbit-envirobit:pimoroni-microbit-envirobit-dimensions.png}}]]

===== Характеристики =====
  * Модель: Pimoroni enviro:bit
  * Совместимость: микрокомпьютеры BBC micro:bit
  * Аппаратный интерфейс: гнездо под краевой разъём BBC micro:bit
  * Встроенные сенсоры:
    * Датчик климата: BME280
    * Датчик света и цвета: TCS3472
    * Микрофон: SiSonic SPU0410HR5H-PB
  * Напряжение питания: 3,3 В
  * Размеры: 66×28×11,6 мм

==== Датчик климата ====
  * Модель: Bosch Sensortec BME280
  * Программный интерфейс: I²C
  * Адрес: 0x76
  * Диапазон измерения температуры: −40…+85 °С
  * Диапазон измерения влажности: 0–100% Rh
  * Диапазон измерения давления: 300–1100 гПа

==== Датчик цвета и света ====
  * Модель: AMS TCS34725
  * Программный интерфейс: I²C
  * Адрес: 0x29
  * Детектируемые цвета: RGB и общая освещённость
==== Микрофон ====
  * Модель: SiSonic SPU0410HR5H-PB
  * Программный интерфейс: аналоговый
  * Чувствительность: −42 дБ
  * Отношение сигнал/шум: 59 дБ
  * Частотный диапазон: от 100 Гц до 10 кГц
  * Тип: всенаправленный
===== Ресурсы =====
  * [[amp>product/pimoroni-microbit-envirobit?utm_source=man&utm_campaign=pimoroni-microbit-envirobit&utm_medium=wiki|Плата мониторинга окружающей среды enviro:bit]] в магазине.
  * [[https://github.com/amperka/hardware-drawings/blob/master/pimoroni-microbit-envirobit.svg|Векторное изображение модуля]]
  * [[https://makecode.microbit.org/|Облачная среда MakeCode]]
  * [[https://github.com/pimoroni/pxt-envirobit|Библиотека для MakeCode]]
  * {{ :products:pimoroni-microbit-envirobit:bme280-datasheet.pdf |Datasheet на метеодатчик BME280}}
  * {{ :products:pimoroni-microbit-envirobit:tcs34725-datasheet.pdf |Datasheet на датчик цвета и света TCS34725}}
  * {{ :products:pimoroni-microbit-envirobit:spu0410hr5h-pb-datasheet.pdf |Datasheet на микрофон SPU0410HR5H-PB}}