Espruino Web IDE — это среда разработки для написания и загрузки программ в контроллеры с загрузчиком Espruino. В ней есть удобный редактор кода, консоль для отладки и инструменты управления платой.

• Контроллеры Espruino
• Iskra JS
• Iskra JS Mini
• BBC micro:bit
• STM32 Nucleo
• Wi-Fi Slot
• ESP32 WROOM DevKit v1

Espruino Web IDE можно использовать с операционными системами Windows, macOS и Linux.

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

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

Откройте Web-версию Espruino IDE.

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

Добавьте в Espruino IDE поддержку библиотек от Амперки.

1. Зайдите в настройки Espruino Web IDE: Settings Communications и найдите поле Module URL.
2. Добавьте к основному адресу модулей Espruino альтернативный путь модулей Amperka через знак |. Было:

   https://www.espruino.com/modules

   Стало:

   https://www.espruino.com/modules | https://js.amperka.ru/modules

   

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

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

1. Пишите программу в поле для кода
2. Загружаете программу в плату кнопкой
3. Наблюдаете за работой устройства и выводом отладочной информации в консоли

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

• По беспроводному протоколу BLE
• По проводному последовательному интерфейсу UART

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

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

1. Подключите питание к плате Espruino. Для Puck.js вставьте элемент питания в батарейный отсек.
2. В среде Espruino Web IDE в верхнем левом углу нажмите кнопку .
3. Появится всплывающее окно со списком доступных портов плат, в зависимости от операционной системы и метода подключения.:

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

   

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

1. Подключите контроллер Iskra JS к компьютеру по USB.
2. В среде Espruino Web IDE в верхнем левом углу нажмите кнопку .
3. Будет представлен список доступных портов плат в зависимости от OS и метода подключения.

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

   

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

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

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

reset();

Контроллер перезагрузится, а в консоли отобразиться баннер платы. В нашем случае баннер контроллера Iskra JS.

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

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

blink.js

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

Немного модифицируем код, чтобы изменить частоту мигания светодиода. Замените значение 500 на 100 и перепрошейте плату.

blink-fast.js

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

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

Espruino поддерживает библиотеки в виде модулей, которые содержат фрагменты кода для упрощения работы с различными устройствами и программными задачами. Модули делают основную программу проще, предоставляя готовые функции для взаимодействия с оборудованием.

Чтобы использовать модуль, нужно подключить его с помощью команды require().

В качестве примера возьмём модуль Storage, который позволяет сохранять и читать данные из памяти платы. Запишем в память сообщение, а затем прочитаем его.

espruino-modules-storage.js

// Подключаем модуль Storage
var data = require('Storage');
// Записываем сообщение в память
data.write("message", "Hello, Espruino!");
// Читаем и выводим сообщение
print(data.read("message"));

После прошивки платы, вы должны увидеть в консоли Espruino приветственную надпись: Hello, Espruino!.

Стандартные библиотеки Espruino не всегда могут покрыть все потребности пользователей. Мы в компании Амперка разработали дополнительные программные модули, которые расширяют список доступных функций и железа. Каждая из библиотек сопровождается подробной документацией на русском языке.

Для примера используем модуль led, который упрощает управление миганием светодиода, избавляя от необходимости писать сложный код.

amperka-modules-led.js

// Подключаем модуль для работы со светодиодом
// В параметрах передаём объект втроенного светодиода на плате
var myLed = require('@amperka/led').connect(LED1);
// Мигаем светодиом в темпе: 0.9 сек — включен, 0.1 сек — выключен
myLed.blink(0.9, 0.1);

После прошивки платы, светодиод будет мигать с частотой: 0,9 сек — включён и 0,1 сек — выключён.

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

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

Рекомендуем также ознакомиться со статьями, документацией и другими полезными материалами по платформе Espruino Web IDE.

• Что такое Espruino: история возникновения, теория и практика
• Cправочные материалы по JavaScript в микроконтроллере
• Обновление прошивки плат Espruino и Iskra JS в DFU-режиме
• Переход от Arduino на C++ к Espruino на JavaScript
• Технический FAQ по Espruino и Iskra JS

• Список библиотек от Espruino
• Список библиотек от Амперки
• Создание и подключение своей библиотеки
• Использование библиотек Амперки без интернета

• Драйвер USB ST-LINK для STM32
• Полный список драйверов и утилит для STM32