Espruino:Примеры/Библиотека UART.js: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= <syntaxhighligh...»)
 
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[ www.espruino.com - ]</ref>=
=Библиотека UART.js<ref>[https://www.espruino.com/UART.js www.espruino.com - UART.js Library]</ref>=


Эта библиотека была создана с целью сделать согласованный и упорядоченный API для доступа к последовательным и [[Bluetooth-устройства]]м в сети при помощи [https://codelabs.developers.google.com/codelabs/web-serial/#0 Web Serial] и [https://web.dev/bluetooth/ Web Bluetooth].


<syntaxhighlight lang="javascript" enclose="div">
Она в целом похожа на [http://www.espruino.com/Web+Bluetooth библиотеку Puck.js], но в неё также добавлена поддержка устройств '''Web Serial'''.


Её необходимо запускать с вебсайта, обслуживаемого с помощью [[HTTPS]] (не [[HTTP]]). Вы можете настроить такой сайт сами с помощью [https://letsencrypt.org/ Let’s Encrypt], но здесь мы это описывать не будем. Здесь мы воспользуемся [https://pages.github.com/ GitHub Pages].
* Залогиньтесь или создайте аккаунт в [https://github.com/ GitHub.com].
* Кликните по вкладке '''Repositories''', а затем на '''New'''.
* Назовите новый репозиторий '''«UARTTest»''', поставьте галочку рядом с пунктом '''Add a README file''' в меню '''Initialize this repository with''', а затем кликните на '''Create''' (если этого не сделать, для создания нового файла придётся использовать инструменты командной строки).
* Клините на вкладку '''Settings''' справа вверху.
* Пролистайте до меню '''GitHub Pages''', в подменю '''Source''' выберите пункт '''main''' и кликните на '''Save'''.
* Вернитесь на вкладку '''Code''', справа вверху нажмите на '''Add file''', а затем на '''Create new file'''.
* Назовите файл '''«test.html»'''.
* Теперь скопируйте и вставьте код ниже в поле на вкладке '''Edit new file''', а затем кликните на кнопку '''Commit new file''' внизу.
<syntaxhighlight lang="html5" enclose="div">
<html>
<head>
</head>
<body>
  <script src="https://www.espruino.com/js/uart.js"></script>
  <button onclick="UART.write('LED1.set();\n');">LED On!</button>
  <button onclick="UART.write('LED1.reset();\n');">LED Off!</button>
</body>
</html>
</syntaxhighlight>
Теперь у вас есть собственная страница по адресу https://ваш_никнейм.github.io/UARTTest/test.html.
Вы всегда можете просто кликнуть на кнопку '''«Попробуй!»''' выше.
Если функция UART.write() используется для отправки данных, то для их считывания – функция UART.eval().
<syntaxhighlight lang="html5" enclose="div">
<html>
<head>
</head>
<body>
  <script src="https://www.espruino.com/js/uart.js"></script>
  <script>
  function getTemperature() {
    UART.eval('E.getTemperature()', function(t) {
      document.getElementById("result").innerHTML = t;
    });
  }
  </script>
  <button onclick="getTemperature()">Get Temperature</button>
  <span id="result"></span>
</body>
</html>
</syntaxhighlight>
</syntaxhighlight>



Версия от 18:50, 4 марта 2021

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


Библиотека UART.js[1]

Эта библиотека была создана с целью сделать согласованный и упорядоченный API для доступа к последовательным и Bluetooth-устройствам в сети при помощи Web Serial и Web Bluetooth.

Она в целом похожа на библиотеку Puck.js, но в неё также добавлена поддержка устройств Web Serial.

Её необходимо запускать с вебсайта, обслуживаемого с помощью HTTPS (не HTTP). Вы можете настроить такой сайт сами с помощью Let’s Encrypt, но здесь мы это описывать не будем. Здесь мы воспользуемся GitHub Pages.

  • Залогиньтесь или создайте аккаунт в GitHub.com.
  • Кликните по вкладке Repositories, а затем на New.
  • Назовите новый репозиторий «UARTTest», поставьте галочку рядом с пунктом Add a README file в меню Initialize this repository with, а затем кликните на Create (если этого не сделать, для создания нового файла придётся использовать инструменты командной строки).
  • Клините на вкладку Settings справа вверху.
  • Пролистайте до меню GitHub Pages, в подменю Source выберите пункт main и кликните на Save.
  • Вернитесь на вкладку Code, справа вверху нажмите на Add file, а затем на Create new file.
  • Назовите файл «test.html».
  • Теперь скопируйте и вставьте код ниже в поле на вкладке Edit new file, а затем кликните на кнопку Commit new file внизу.
<html>
 <head>
 </head>
 <body>
  <script src="https://www.espruino.com/js/uart.js"></script>
  <button onclick="UART.write('LED1.set();\n');">LED On!</button>
  <button onclick="UART.write('LED1.reset();\n');">LED Off!</button>
 </body>
</html>

Теперь у вас есть собственная страница по адресу https://ваш_никнейм.github.io/UARTTest/test.html.

Вы всегда можете просто кликнуть на кнопку «Попробуй!» выше.

Если функция UART.write() используется для отправки данных, то для их считывания – функция UART.eval().

<html>
 <head>
 </head>
 <body>
  <script src="https://www.espruino.com/js/uart.js"></script>
  <script>
  function getTemperature() {
    UART.eval('E.getTemperature()', function(t) {
      document.getElementById("result").innerHTML = t;
    });
  }
  </script>
  <button onclick="getTemperature()">Get Temperature</button>
  <span id="result"></span>
 </body>
</html>

См.также

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