Как создать и подключить свою библиотеку в Espruino Web IDE

Для упрощения работы в Espruino Web IDE со сложными математическими функциями, датчиками и исполнительными устройствами существуют специальные файлы — библиотеки. В них спрятаны всевозможные расчёты, функции для настройки и калибровки сенсоров, фильтры ошибочных значений и многое другое.

Если вы стали обладателям набора Йодо или платы Iskra JS и освоили программирование на JavaScript — в ваших силах написать свою библиотеку. В этой статье мы расскажем как написать её и подключить к Espruino Web IDE.

1. Для примера напишем библиотеку управления светодиодом. В библиотеку включим два метода:
   1. turnOn — включить светодиод;
   2. turnOff — выключить светодиод.

      my-led.js

      var MyLed = function(pin) {
        this._pin = pin;
      };
       
      MyLed.prototype.turnOn = function() {
        this._pin.write(true);
      };
       
      MyLed.prototype.turnOff = function() {
        this._pin.write(false);
      };
       
      exports.connect = function(pin) {
        return new MyLed(pin);
      };

2. Откройте среду Espruino Web IDE.
3. Укажите путь для хранения собственных библиотек. Для этого зайдите в настройки Espruino Web IDE: Settings Projects Select Directory for Sandbox и выберите папку. В качестве примера мы выбрали:

   C:\myModules

   

4. В созданной директории появится список вложенных папок. Найдите в этом списке папку modules и зайдите в неё.
5. Скопируйте файл библиотеки в папку modules.

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

1. Подключите светодиод «Пиранья» (Troyka-модуль) или светодиод 5 мм (Troyka-модуль) к пину P1
2. Вспомните код из первого эксперимента из набора Йодо:

   lamp.js

   var myCoolLamp = require('@amperka/led').connect(P1);
   myCoolLamp.turnOn();

   Модифицируем его с использованием новой библиотеки my-led. Изменим путь к модулям, на название нашей библиотеки.

   1. Заменим строку

      '@amperka/led'

      на

      'my-led'

3. Прошейте управляющую плату модифицируемой программой:

lamp2.js

var myCoolLamp = require('my-led').connect(P1);
myCoolLamp.turnOn();

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

Поздравляем, вы создали и использовали первую библиотеку для Espruino IDE.