Espruino:Примеры/Часто задаваемые вопросы: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Строка 67: Строка 67:
После выполнения команды [[Espruino]] печатает =, а затем возвращаемое значение. Например:
После выполнения команды [[Espruino]] печатает =, а затем возвращаемое значение. Например:


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
>1+2
>1+2
=3
=3
Строка 76: Строка 76:
Но если вызвать функцию, которая ничего не возвращает, она вернёт [[undefined]] – это именно то, что вы видите у себя:
Но если вызвать функцию, которая ничего не возвращает, она вернёт [[undefined]] – это именно то, что вы видите у себя:


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
>digitalWrite(D0,1)
>digitalWrite(D0,1)
=undefined
=undefined
Строка 103: Строка 103:
Чтобы вы примерно понимали скорость работы [[Espruino]], вот этот код создаёт квадратную волну с частотой 1.5 КГц.
Чтобы вы примерно понимали скорость работы [[Espruino]], вот этот код создаёт квадратную волну с частотой 1.5 КГц.


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
setInterval("digitalWrite(LED1,l=!l)",1000/3000);
setInterval("digitalWrite(LED1,l=!l)",1000/3000);
</syntaxhighlight>
</syntaxhighlight>

Версия от 18:24, 14 мая 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Часто задаваемые вопросы[1]

Что такое Espruino?

Espruino – это JavaScript-интерпретатор для микроконтроллеров, заметно упрощающий разработку встроенного ПО. Интерпретатор Espruino – это прошивка с открытым кодом, запускаемая на множестве различных микроконтроллеров. Кроме того, в продаже есть платы Espruino, где этот интерпретатор уже предустановлен по умолчанию, что облегчает первые этапы работы с ними.

Но Espruino – это не только интерпретатор и платы, но и Web IDE, инструменты командной строки, документация, руководства и модули, вместе составляющие оптимальное решение для разработки встроенного ПО.

Возникли проблемы с платой Espruino?

Ознакомьтесь с этой статьёй. Если там нет решения вашей проблемы, обратитесь на форум.

Я подключил Espruino к ПК/Mac – что делать дальше?

Загляните на страницу «быстрого старта», выберите там своё устройство и следуйте пошаговым инструкциям – они объяснят вам, что делать.

Есть ли форум, где я могу попросить помощи?

Да! Вот он.

Espruino имеет какое-нибудь отношение к ESP8266/ESP32/Espressif?

Общие буквы «esp» – это просто совпадение. ESP8266 была выпущена в 2014 году, а сайт espruino.com был создан в 2012 году.

У прошивки Espruino есть порты, которые можно запускать на чипах ESP8266 и ESP32, но эти порты – плод работы комьюнити. Во-первых, Espressif никак не поддерживает Espruino, и во-вторых, ни одна из официальных плат Espruino не использует ESP8266/ESP32 как платформу.

Espruino – это проект с открытым кодом?

Да! И он весь есть на GitHub. Главная прошивка распространяется по лицензии MPLv2. Если вы планируете использовать Espruino в коммерческих целях, разработчики просят связаться с ними для взаимовыгодного сотрудничества.

Почему JavaScript?

Нам нужен был язык программирования, который:

  • Имеет ту же базовую форму, что и C, благодаря чему простой код похож на Arduino-код.
  • Подталкивает к событийному программированию (для снижения энергопотребления).
  • Широко используется и у которого много обучающих онлайн-руководств.
  • Интерпретируется и позволяет модифицировать функции при запущенном интерпретаторе (в отличие от некоторых других языков, JavaScript воспринимает функции как переменные).

Я сделал кое-что крутое при помощи Espruino, хотите взглянуть?

Разработчики посмотрят с удовольствием! Показать свой проект можно в этом разделе форума.

Как Espruino отличается от Arduino / Raspberry Pi / встраиваемых Linux-плат?

Espruino vs Raspberry Pi / встраиваемые Linux-платы

  • Raspberry Pi – это очень мощные и гибкие платы, но в состоянии покоя потребляющие относительно много электричества, из-за чего их проблематично питать от батареи. В режиме покоя Raspberry Pi потребляет минимум около 50 мА, а Puck.js – 0.003 мА.
  • На Raspberry Pi ненадёжная планировка действий в реальном времени, из-за чего синхронизация особой точностью не отличается.
  • Raspberry Pi хорошо подходит для работы с видео, тогда как Espruino недостаточно мощна для этого.
  • Espruino работает на JavaScript. Это делает эту платформу более доступной и лёгкой для использования для начинающих. С другой стороны, Raspberry Pi даёт больше выбора в языках, что хорошее качество, но может отпугнуть некоторых пользователей.
  • У Raspberry Pi нет аналогового ввода/вывода, а у Espruino есть.
  • Для Raspberry Pi нужна SD-карта, содержащая операционную систему (для Espruino – нет).

Espruino vs Arduino

  • Espruino меньше, чем большинство Arduino, и гораздо дружелюбнее для начинающих.
  • На ПК или Mac необязательно предустанавливать какое-либо ПО.
  • Хотя Arduino потребляет меньше электричества, платы Espruino разработаны с прицелом на энергоэффективность и потребляют более чем в 10 раз меньше в режиме сна.
  • Использование JavaScript-интерпретатора означает, что вам не придётся выполнять сброс Espruino после внесения изменений в код, но это также значит, что скорость выполнения будет чуть ниже.

Когда я печатаю команду, почему Espruino пишет =undefined?

После выполнения команды Espruino печатает =, а затем возвращаемое значение. Например: 

>1+2
=3
>analogRead(A0)
=0.0324

Но если вызвать функцию, которая ничего не возвращает, она вернёт undefined – это именно то, что вы видите у себя: 

>digitalWrite(D0,1)
=undefined

Примечание: Начиная с версии 1v99 =undefined уже не печатается.

Когда я печатаю функцию, почему Espruino печатает =function ...?

Смотрите ответ в предыдущем вопросе – когда вы задаёте функцию, Espruino также возвращает саму эту функцию в качестве значения. Она печатает её в консоль аналогично всем прочим командам, которые вы печатаете.

Мой код стёрся, когда я отключил питание от Espruino. Что можно сделать?

Чтобы более надёжно сохранить код, просто впишите save() в левой части Web IDE. Когда питание снова будет подключено, Espruino восстановится в том же состоянии, которое было сохранено при использовании save(), запомнив таймеры, прерывания и даже состояния контактов. Наличие какого-то работающего кода с самого запуска Espruino может пригодиться, например, если вам нужно инициализировать какие-то подключенные к Espruino устройства вроде дисплеев. В этом случае вы просто можете добавить функцию onInit() – она будет выполняться при каждом запуске Espruino. Более подробно читайте в этой статье.

Могу ли я использовать Espruino для управления устройствами при помощи программы на ПК?

Да! Если у вас есть возможность отправлять данные по последовательному порту с ПК на Espruino, то делается это очень просто. Всё, что вам нужно – это отправить команду echo(0). Она останавливает работу, назовём это так, «пользовательского интерфейса» Espruino. После этого вы сможете отправлять и получать данные при помощи команд вроде print(analogRead(A0)).

Более подробно читайте в этой статье.

Насколько быстро работает Espruino?

Espruino достаточно быстро работает для всего, что касается взаимодействия с реальным миром (серводвигатели, моторы, светильники и так далее). События вроде setWatch имеют временную отметку, благодаря чему вы можете измерить продолжительность импульса с точностью до одной микросекунды (1 / 1.000.000 секунды).

Чтобы вы примерно понимали скорость работы Espruino, вот этот код создаёт квадратную волну с частотой 1.5 КГц. 

setInterval("digitalWrite(LED1,l=!l)",1000/3000);

То есть он выполняется 3000 раз в секунду, в то же время позволяя фоном выполнять и какие-то другие задачи. Но вы можете генерировать и ещё более высокочастотные квадратные волны при помощи ШИМ-функционала Espruino. Более подробно читайте в этой статье.

А есть вещи, для которых Espruino не подходит? Да – рендеринг/обработка видео и анализ данных большого размера. Впрочем, если вам нужно, чтобы какая-то часть вашего проекта работала очень быстро, вы всегда можете воспользоваться ассемблерной вставкой, C-вставкой и предварительно скомпилированным C-кодом.

Насколько энергоэффективен язык Espruino?

Очень. Espruino – это событийный язык программирования, и поэтому интерпретатор Espruino может переходить в режим сна, если будет знать, что ему не нужно выполнять никаких действий.

Это значит, что код на Espruino будет гораздо более энергоэффективным, чем тот же код на C, разве что в этом C-коде не задан явно переход в более энергоэффективный режим сна. Энергопотребление зависит от используемой платы, но для устройств вроде Puck.js энергопотребление в состоянии покоя может составлять всего 3 мкА (0.000003 А).

Как много питания могут давать контакты Espruino?

См. таблицу ниже:

Тип платы Сила тока на одном IO-контакте Суммарная сила тока на всех IO-контактах
Original 25 мА 120 мА
Pico
WiFi
 20 мА 120 мА
Puck.js
Pixl.js
MDBT42Q
 15 мА 15 мА (см. тут)

Язык Espruino на 100% совместим с JavaScript?

В Espruino реализована (значительная) часть спецификации JavaScript, но не 100%. По словам разработчиков, они стараются делать так, чтобы функционал Espruino максимально соответствовал стандартам JavaScript.

Список функций языка JavaScript, поддерживаемых в Espruino, смотрите тут.

Наименее используемые части JavaScript в Espruino не вошли, потому что для них не хватает памяти. Справочник по Espruino можно найти тут.

Но, по сути, если вы будете программировать обычным JavaScript-кодом, то вряд ли заметите какую-нибудь разницу между Espruino и обычным JavaScript. Если у вас возникли какие-нибудь проблемы, то можете описать их на форуме (но не забудьте приложить проблемный фрагмент кода) – разработчики пишут, что постараются исправить этот баг, а если окажется, что это какая-то интересная функция, то попробуют сделать так, чтобы её смогли использовать другие люди.

Будет ли Espruino работать на моей плате?

Если она есть в этом списке, то да. Если нет, но если она оснащена похожим процессором с таким же (или похожим) количеством RAM- и flash-памяти, то не факт, но попробовать всё равно можно – инструкции по сборке смотрите на GitHub.

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

Примечание: Из-за большого количества поддерживаемых плат (более 50) разработчики уже не могут добавлять поддержку новых плат в главную кодовую базу Espruino. Но вы всегда можете разработать и поддерживать такой форк сами или же мы можем заняться поддержкой вашей платы за небольшую месячную плату.

См.также

Партнерские ресурсы
Криптовалюты
Магазины
Хостинг
Разное

Внешние ссылки

  1. ↑ www.espruino.com - Frequently Asked Questions
Справочник по API Espruino
Глобальные методы, переменные и объекты • acceleration() • analogRead() • analogWrite() • arguments • atob() • Объект Bluetooth • btoa() • changeInterval() • clearInterval() • clearTimeout() • clearWatch() • compass() • decodeURIComponent() • digitalPulse() • digitalRead() • digitalWrite() • dump() • echo() • edit() • encodeURIComponent() • eval() • FET • getPinMode() • getSerial() • getTime() • global • HIGH • Объект I2C1 • Объект I2C2 • Объект I2C3 • Infinity • isFinite() • isNaN() • load() • Объект LoopBackA • Объект LoopBackB • LOW • NaN • parseFloat() • parseInt() • peek16() • peek32() • peek8() • pinMode() • poke16() • poke32() • poke8() • print() • require() • reset() • save() • SCL • SDA • Объект Serial1 • Объект Serial2 • Объект Serial3 • Объект Serial4 • Объект Serial5 • Объект Serial6 • setBusyIndicator() • setDeepSleep() • setInterval() • setSleepIndicator() • setTime() • setTimeout() • setWatch() • shiftOut() • show() • Объект SPI1 • Объект SPI2 • Объект SPI3 • Объект Telnet • Объект Terminal • trace() • Объект USB • VIBRATE
Класс AES • decrypt() • encrypt()
Класс Array • Array() • concat() • every() • fill() • filter() • find() • findIndex() • forEach() • includes() • indexOf() • isArray() • join() • length • map() • pop() • push() • reduce() • reverse() • shift() • slice() • some() • sort() • splice() • toString() • unshift()
Класс ArrayBuffer • ArrayBuffer() • byteLength
Класс ArrayBufferView • buffer • byteLength • byteOffset • fill() • filter() • find() • findIndex() • forEach() • includes() • indexOf() • join() • map() • reduce() • reverse() • set() • slice() • sort()
Класс Bangle • accel • accelRd() • accelWr() • aiGesture • beep() • buzz() • charging • compassWr() • dbg() • drawWidgets() • F_BEEPSET • faceUp • gesture • getAccel() • getCompass() • getLCDMode() • getLogo() • GPS • GPS-raw • HRM • ioWr() • isCharging() • isLCDOn() • lcdPower • lcdWr() • loadWidgets() • mag • off() • project() • setCompassPower() • setGPSPower() • setHRMPower() • setLCDBrightness() • setLCDMode() • setLCDOffset() • setLCDPower() • setLCDTimeout() • setOptions() • setPollInterval() • showLauncher() • step • swipe • touch • twist
Класс BluetoothDevice • connected • gatt • gattserverdisconnected • passkey • passkeyRequest • rssi • sendPasskey()
Класс BluetoothRemoteGATTCharacteristic • characteristicvaluechanged • readValue() • startNotifications() • stopNotifications() • writeValue()
Класс BluetoothRemoteGATTServer • connect() • disconnect() • getPrimaryService() • getPrimaryServices() • getSecurityStatus() • setRSSIHandler() • startBonding()
Класс BluetoothRemoteGATTService • getCharacteristic() • getCharacteristics()
Класс Boolean • Boolean()
Библиотека CC3000 • connect()
Класс Console • log()
Библиотека crypto • AES • PBKDF2() • SHA1() • SHA224() • SHA256() • SHA384() • SHA512()
Класс DataView • DavaView() • getFloat32() • getFloat64() • getInt16() • getInt32() • getInt8() • getUint16() • getUint32() • getUint8() • setFloat32() • setFloat64() • setInt16() • setInt32() • setInt8() • setUint16() • setUint32() • setUint8()
Класс Date • Date() • getDate() • getDay() • getFullYear() • getHours() • getMilliseconds() • getMinutes() • getMonth() • getSeconds() • getTime() • getTimezoneOffset() • now() • parse() • setDate() • setFullYear() • setHours() • setMilliseconds() • setMinutes() • setMonth() • setSeconds() • setTime() • toISOString() • toJSON() • toString() • toUTCString() • valueOf()
Библиотека dgram • createSocket()
Класс dgramSocket • addMembership() • bind() • Функция close() • Событие close() • message • send()
Класс E • asm() • clip() • compiledC() • connectSDCard() • convolve() • CRC32() • defrag() • dumpFragmentation() • dumpFreeList() • dumpLockedVars() • dumpStr() • dumpTimers() • dumpVariables() • enableWatchdog() • errorFlag • FFT() • flashFatFS() • getAddressOf() • getAnalogVRef() • getBattery() • getConsole() • getErrorFlags() • getFlags() • getRTCPrescaler() • getSizeOf() • getTemperature() • HSBtoRGB() • hwRand() • init • kickWatchdog() • kill • lockConsole() • lookupNoCase() • mapInPlace() • memoryArea() • memoryMap() • nativeCall() • openFile() • pipe() • reboot() • reverseByte() • sendUSBHID() • setBootCode() • setClock() • setConsole() • setFlags() • setPassword() • setRTCPrescaler() • setTimeZone() • setUSBHID() • showAlert() • showMenu() • showMessage() • showPrompt() • srand() • sum() • toArrayBuffer() • toJS() • toString() • toUint8Array() • unmountSD() • variance()
Класс Error • Error() • toString()
Библиотека ESP8266 • crc32() • deepSleep() • dumpSocketInfo() • getFreeFlash() • getResetInfo() • getState() • logDebug() • neopixelWrite() • ping() • printLog() • readLog() • reboot() • setCPUFreq() • setLog()
Класс Ethernet • getHostname() • getIP() • getStatus() • setHostname() • setIP()
Класс File • close() • pipe() • read() • seek() • skip() • write()
Библиотека Flash • erasePage() • getFree() • getPage() • read() • write()
Класс Float32Array • Float32Array()
Класс Float64Array • Float64Array()
Библиотека fs • appendFile() • appendFileSync() • mkdir() • mkdirSync() • pipe() • readdir() • readdirSync() • readFile() • readFileSync() • statSync() • unlink() • unlinkSync() • writeFile() • writeFileSync()
Класс Function • apply() • bind() • call() • Function() • replaceWith()
Класс Graphics • asBMP() • asImage() • asURL() • buffer • clear() • clearRect() • createArrayBuffer() • createCallback() • createImage() • createSDL() • drawCircle() • drawEllipse() • drawImage() • drawImages() • drawLine() • drawLineAA() • drawPoly() • drawPolyAA() • drawRect() • drawString() • dump() • fillCircle() • fillEllipse() • fillPoly() • fillRect() • flip() • getBgColor() • getColor() • getFont() • getFontHeight() • getFonts() • getHeight() • getInstance() • getModified() • getPixel() • getWidth() • lineTo() • moveTo() • quadraticBezier() • reset() • scroll() • setBgColor() • setClipRect() • setColor() • setFont() • setFontAlign() • setFontBitmap() • setFontCustom() • setFontVector() • setPixel() • setRotation() • stringWidth() • toColor() • transformVertices()
Библиотека heatshrink • compress() • decompress()
Библиотека http • createServer() • get() • request()
Класс httpCRq • drain • end() • error • write()
Класс httpCRs • available() • close • data • error • headers • httpVersion • pipe() • read() • statusCode • statusMessage
Класс httpSRq • available() • close • data • headers • method • pipe() • read() • url
Класс httpSRs • close • drain • end() • headers • setHeader() • write() • writeHead()
Класс httpSrv • close() • listen()
Класс I2C • find() • I2C() • readFrom() • setup() • writeTo()
Класс Int16Array • Int16Array()
Класс Int32Array • Int32Array()
Класс Int8Array • Int8Array()
Класс InternalError • InternalError() • toString()
Класс JSON • parse() • stringify()
Класс Math • abs() • acos() • asin() • atan() • atan2() • ceil() • clip() • cos() • E • exp() • floor() • LN10 • LN2 • log() • LOG10E • LOG2E • max() • min() • PI • pow() • random() • round() • sin() • sqrt() • SQRT1_2 • SQRT2 • tan() • wrap()
Класс Microbit • accel() • accelOff() • accelOn() • accelWr() • gesture • mag() • MIC • MIC_ENABLE • play() • record() • SPEAKER
Класс Modules • addCached() • getCached() • removeAllCached() • removeCached()
Библиотека neopixel • write()
Библиотека net • connect() • createServer()
Библиотека NetworkJS • create()
Класс NodeMCU • A0 • D0 • D1 • D2 • D3 • D4 • D5 • D6 • D7 • D8 • D9 • D10
Класс NRF • characteristicsDiscover • connect • connect() • disconnect • disconnect() • filterDevices() • findDevices() • getAddress() • getAdvertisingData() • getBattery() • getSecurityStatus() • HID • nfcAndroidApp() • NFCoff • NFCon • nfcPair() • nfcRaw() • NFCrx • nfcSend() • nfcStart() • nfcStop() • nfcURL() • requestDevice() • restart() • security • sendHIDReport() • servicesDiscover • setAddress() • setAdvertising() • setConnectionInterval() • setLowPowerConnection() • setRSSIHandler() • setScan() • setScanResponse() • setSecurity() • setServices() • setTxPower() • setWhitelist() • sleep() • updateServices() • wake()
Класс Nucleo • A0 • A1 • A2 • A3 • A4 • A5 • D0 • D1 • D2 • D3 • D4 • D5 • D6 • D7 • D8 • D9 • D10 • D11 • D12 • D13 • D14 • D15
Класс Number • MAX_VALUE • MIN_VALUE • NaN • NEGATIVE_INFINITY • Number() • POSITIVE_INFINITY • toFixed()
Класс Object • assign() • clone() • create() • defineProperties() • defineProperty() • emit() • getOwnPropertyDescriptor() • getOwnPropertyNames() • getPrototypeOf() • hasOwnProperty() • keys() • length • Object() • on() • removeAllListeners() • removeListener() • setPrototypeOf() • toString() • valueOf()
Класс OneWire • OneWire() • read() • reset() • search() • select() • skip() • write()
Класс Pin • getInfo() • getMode() • mode() • Pin() • read() • reset() • set() • toggle() • write() • writeAtTime()
Класс Pixl • getBatteryPercentage() • lcdw() • menu() • setContrast() • setLCDPower()
Класс process • env • memory() • uncaughtException • version
Класс Promise • all() • catch() • Promise() • reject() • resolve() • then()
Класс Puck • accel • accel() • accelOff() • accelOn() • accelRd() • accelWr() • capSense() • getBatteryPercentage() • getTemperature() • IR() • light() • mag() • mag • magOff() • magOn() • magRd() • magTemp() • magWr() • selfTest()
Класс ReferenceError • ReferenceError() • toString()
Класс RegExp • exec() • RegExp() • test()
Класс Serial • available() • data • find() • framing • inject() • parity • pipe() • print() • println() • read() • Serial() • setConsole() • setup() • unsetup() • write()
Класс Server • close() • listen()
Класс Socket • available() • close • data • drain • end() • error • pipe() • read() • write()
Класс SPI • find() • send() • send4bit() • send8bit() • setup() • SPI() • write()
Библиотека Storage • compact() • debug() • erase() • eraseAll() • getFree() • list() • open() • read() • readArrayBuffer() • readJSON() • write() • writeJSON()
Класс StorageFile • erase() • getLength() • read() • readLine() • write()
Класс String • charAt() • charCodeAt() • endsWith() • fromCharCode() • includes() • indexOf() • lastIndexOf() • length • match() • padEnd() • padStart() • repeat() • replace() • slice() • split() • startsWith() • String() • substr() • substring() • toLowerCase() • toUpperCase() • trim()
Класс SyntaxError • SyntaxError() • toString()
Библиотека TelnetServer • setOptions()
Библиотека tensorflow • create()
Класс TFMicroInterpreter • getInput() • getOutput() • invoke()
Библиотека tls • connect()
Библиотека tv • setup()
Класс TypeError • toString() • TypeError()
Класс Uint16Array • Uint16Array()
Класс Uint24Array • Uint24Array()
Класс Uint32Array • Uint32Array()
Класс Uint8Array • Uint8Array()
Класс Uint8ClampedArray • Uint8ClampedArray()
Класс url • parse()
Класс Waveform • startInput() • startOutput() • stop() • Waveform()
Библиотека WiFi • associated • auth_change • connect() • connected • dhcp_timeout • disconnect() • disconnected • getAPDetails() • getAPIP() • getDetails() • getHostByName() • getHostname() • getIP() • getStatus() • ping() • probe_recv • restore() • save() • scan() • setAPIP() • setConfig() • setIP() • setSNTP() • sta_joined • sta_left • startAP() • stopAP() • turbo()
Класс WioLTE • A4 • A6 • D20 • D38 • I2C • LED() • setGrovePower() • setLEDPower() • UART
Библиотека WIZnet • connect()
Класс WLAN • connect() • disconnect() • getIP() • reconnect() • setIP()

Источник — http://wikihandbk.com/ruwiki/index.php?title=Espruino:Примеры/Часто_задаваемые_вопросы&oldid=7673898