Espruino:Справочник по API/Класс Puck/magOn(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[https://www.espruino.com/Reference#l_Puck_magOn www.espruino.com - Puck.magOn(samplerate)]</ref>=
=Функция Puck.magOn()<ref>[https://www.espruino.com/Reference#l_Puck_magOn www.espruino.com - Puck.magOn(samplerate)]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
Puck.magOn(samplerate)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


 
* '''samplerate''' – частота считывания данных (в Гц) или undefined


==Возвращаемое значение==
==Возвращаемое значение==
Строка 21: Строка 21:
==Описание==
==Описание==


Включает магнетометр и запускает периодическое считывание данных с него. Каждое считывание данных будет генерировать на объекте Puck событие mag.
<syntaxhighlight lang="javascript" enclose="div">
Puck.magOn();
Puck.on('mag', function(xyz) {
  console.log(xyz);
  // {x:..., y:..., z:...}
});
// выключаем события при помощи Puck.magOff(); 
</syntaxhighlight>
 
Если считывание данных магнетометра уже включено, эта функция будет проигнорирована.
Если аргумент samplerate будет задан, то функция воспользуется значением, заданным в нем, а если нет, то частота считывания данных магнетометра будет выставлена на 0.63 Гц. В samplerate нужно задать одно из следующих значений (что повлияет и на энергопотребление):
*  80 Гц – 900 мкА
*  40 Гц – 550 мкА
*  20 Гц – 275 мкА
*  10 Гц – 137 мкА
*  5 Гц – 69 мкА
*  2.5 Гц – 34 мкА
*  1.25 Гц – 17 мкА
*  0.63 Гц – 8 мкА
*  0.31 Гц – 8 мкА
*  0.16 Гц – 8 мкА
*  0.08 Гц – 8 мкА 
Если заряд батареи упадет слишком низко, считывание данных магнетометра может остановиться без предупреждения – даже если другие функции Puck будут по-прежнему работать нормально.
Более подробно читайте в [http://www.espruino.com/Puck.js#on-board-peripherals этой статье].


'''Примечание:''' Эта функция доступна только для устройств Puck.js.


== Примеры ==
== Примеры ==

Версия от 22:03, 24 февраля 2021

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


Функция Puck.magOn()[1]

Синтаксис

Puck.magOn(samplerate)

Параметры

  • samplerate – частота считывания данных (в Гц) или undefined

Возвращаемое значение

Описание

Включает магнетометр и запускает периодическое считывание данных с него. Каждое считывание данных будет генерировать на объекте Puck событие mag.

Puck.magOn();
Puck.on('mag', function(xyz) {
  console.log(xyz);
  // {x:..., y:..., z:...}
});
// выключаем события при помощи Puck.magOff();

Если считывание данных магнетометра уже включено, эта функция будет проигнорирована.

Если аргумент samplerate будет задан, то функция воспользуется значением, заданным в нем, а если нет, то частота считывания данных магнетометра будет выставлена на 0.63 Гц. В samplerate нужно задать одно из следующих значений (что повлияет и на энергопотребление):

  • 80 Гц – 900 мкА
  • 40 Гц – 550 мкА
  • 20 Гц – 275 мкА
  • 10 Гц – 137 мкА
  • 5 Гц – 69 мкА
  • 2.5 Гц – 34 мкА
  • 1.25 Гц – 17 мкА
  • 0.63 Гц – 8 мкА
  • 0.31 Гц – 8 мкА
  • 0.16 Гц – 8 мкА
  • 0.08 Гц – 8 мкА

Если заряд батареи упадет слишком низко, считывание данных магнетометра может остановиться без предупреждения – даже если другие функции Puck будут по-прежнему работать нормально.

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

Примечание: Эта функция доступна только для устройств Puck.js.

Примеры

См.также

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