Среда программирования Espruino Web IDE

Espruino Web IDE — это приложение для написания программы и загрузки её в плату. Утилита также содержит в себе консоль для наблюдения и отладки вывода консольных команд.

Видеобзор

Установка и настройка Espruino IDE

Шаг 1. Установка Espruino IDE

Espruino Web IDE поддерживает три типа инсталляции:

Если у вас операционная система Windows 7 или 8, то Espruino из магазина приложений Chrome и web-версия могут не видеть COM-порты. Используйте нативное приложение в этом случае.

Online приложение

Для старта, просто откройте Web-версию Espruino IDE.

Приложение из магазина Google Chrome

  1. Скачайте и установите браузер Google Chrome.
  2. Добавьте в Google Chrome приложение Espruino Web IDE.

Приложение для рабочего стола

Скачайте и установите самую последнюю десктопную версию версию Espruino Web IDE. Espruino.exe находится почти в самом конце списка.

Шаг 2. Добавление настроек Амперки

Добавьте в Espruino IDE поддержку платы Iskra JS и библиотек от Амперки в автоматическом или ручном режиме.

Автоматический режим

Если у вас версия от Google Chrome, просто кликните по текущей ссылке. Во всех остальных случаях настройки придётся вбить вручную.

Ручной режим

  1. Зайдите в настройки Espruino Web IDE: Settings Communications и найдите поле Module URL.
  2. Измените адрес:
    https://www.espruino.com/modules

    на

    http://js.amperka.ru/modules

  3. Перейдите в настройки Espruino Web IDE: Settings BOARD и найдите поле Board JSON URL.
  4. Измените адрес:
    https://www.espruino.com/json

    на

    http://js.amperka.ru/json

Шаг 3. Установка драйвера

Если у вас Windows, установите драйвер для USB-интерфейса микроконтроллера STM32. Для Mac OS и Linux драйвер не нужен.

Интерфейс среды

Окно среды состоит из двух основных частей: слева — окно консоли, справа — окно исходного кода.

Типовой сценарий работы:

  • вы пишите код в правой панели IDE;
  • загружаете его в плату кнопкой ;
  • наблюдаете за работой устройства и выводом отладочной информации в консоли.

Соединение с платой

Беспроводное подключение

Поддерживаемые устройства

Беспроводное подключение к среде Espruino Web IDE доступно только при наличии беспроводных приёмопередатчиков на обоих устройствах: Espruino и ПК.

  • На ПК должен быть включён модуль Bluetooth. Если он физически отсутствует, его можно приобрести отдельно.
  • Плата Espruino должна поддерживать соединение по протоколу BLE. Список поддерживаемых плат:

Для всех остальных случаев, используйте проводное соединение по последовательному интерфейсу UART.

Инструкция по подключению

  1. Подключите к плате Espruino питание и землю.
  2. В среде Espruino Web IDE в верхнем левом углу нажмите кнопку .
  3. Вам будет представлен список доступных портов плат в зависимости от OS и от типа подключения:
    • Выборка по типу подключения: проводной и беспроводной.
    • Выборка по OS: Windows: COMxxx, MacOS: /dev/tty.usbmodemxxx, Linux: /dev/ttyACMxxx.

      Выбирайте подключение через Web Bluetooth.

  4. Откроется окно поиска новых устройств.
  5. Выберите интересующее вас устройство и нажмите на кнопку «Подключить».
  6. После успешного подключения, вы увидите в консоли надпись «Connected». Фон кнопки изменит цвет на зелёный и в нижнем правом углу всплывёт окошко с уведомлением, что плата успешно подключена к компьютеру.

Проводное подключение

  1. Подключите плату к компьютеру по USB.
  2. В среде Espruino Web IDE в верхнем левом углу нажмите кнопку .
  3. Вам будет представлен список доступных портов плат в зависимости от OS и от типа подключения:
    • Выборка по типу подключения: проводной и беспроводной.
    • Выборка по OS: Windows: COMxxx, MacOS: /dev/tty.usbmodemxxx, Linux: /dev/ttyACMxxx.

      Найдите среди них свою плату простым перебором.

  4. После успешного подключения, вы увидите в консоли надпись «Connected». Фон кнопки изменит цвет на зелёный и в нижнем правом углу всплывёт окошко с уведомлением, что плата успешно подключена к компьютеру.

Тестирование подключения

Проверим корректное соединения с платформой.

Программная перезагрузка

В чёрном окне консоли наберите команду:

reset();

Плата перезагрузится, а в консоли отобразиться баннер платы.

Обратите внимание на версию интерпретатора JS (2v01.49) в примере. Если плата работает не корректно, обновите прошивку платформы до самой свежей.

Консольные команды

Через консоль можно работать с подключённой платой «налету»: исполнять выражения, вызывать функции, просматривать значения переменных и т.д. Попробуйте, например, ввести в консоль 6 + 8 и нажать Enter. Плата выполнит команду и вернёт результат 14.

Что-то пошло не так?

Загрузка первой программы

Среда настроена, плата подключена. Прошейте управляющую плату, программой приведённой ниже. Светодиод «LED1» на плате будет загораться и гаснуть каждые 500 миллисекунд.

blink.js
var  on = false;
setInterval(function() {
  on = !on;
  LED1.write(on);
}, 500);

Немного модифицируем код, чтобы изменить частоту мигания светодиода.

Замените значение 500 на 100 и перепрошейте плату.

blink2.js
var  on = false;
setInterval(function() {
  on = !on;
  LED1.write(on);
}, 100);

Теперь светодиод «LED1» будет загораться и гаснуть каждые 100 миллисекунд — в 5 раз быстрее исходной версии.

В примере используется объект LED1 который установлен на платформе Iskra JS. Если вы используете другую платформу с интерпретатором JavaScript, имена объектов и пинов могут отличатся.

Загрузка программы c использованием библиотек Амперки

Проверим плату на первом эксперименте из набора Йодо.

  1. Прошейте управляющую плату следующей программой:
lamp-on.js
var myCoolLamp = require('@amperka/led').connect(P1);
myCoolLamp.turnOn();

В консольном окне появится сообщение об успешной прошивке, а в правом нижнем углу среды — всплывающее окно об успешном подключении библиотеки. Светодиод на пине P1 загорится.

В примере используется пин P1 который установлен на платформе Iskra JS. Если вы используете другую платформу с интерпретатором JavaScript, имена объектов и пинов могут отличатся.

Поздравляем, вы полностью настроили железо со средой Espruino IDE. Можете смело переходить к изучению всех возможностей программирования микроконтроллеров на JavaScript.

Что-то пошло не так?

Обновление прошивки

Если у вас перестала работать плата или вы хотите обновить интерпретатор JS до самой актуальной версии, прошейте контроллер на плате через DFU-режим.

Список поддерживаемых плат