Espruino:Справочник по API/Класс Puck/magOn(): различия между версиями
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) |
||
(не показаны 3 промежуточные версии 2 участников) | |||
Строка 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 | <syntaxhighlight lang="javascript"> | ||
Puck.magOn(samplerate) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==Параметры== | ==Параметры== | ||
* '''samplerate''' – частота считывания данных (в Гц) или undefined | |||
==Возвращаемое значение== | ==Возвращаемое значение== | ||
Строка 21: | Строка 21: | ||
==Описание== | ==Описание== | ||
Включает магнетометр и запускает периодическое считывание данных с него. Каждое считывание данных будет генерировать на объекте Puck событие mag. | |||
<syntaxhighlight lang="javascript"> | |||
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 этой статье]. | |||
{{Примечание1|Эта функция доступна только для устройств Puck.js.}} | |||
== Примеры == | == Примеры == | ||
Строка 29: | Строка 59: | ||
=См.также= | =См.также= | ||
=Внешние ссылки= | =Внешние ссылки= | ||
Строка 35: | Строка 65: | ||
<references /> | <references /> | ||
{{Навигационная таблица/Espruino | {{Навигационная таблица/Портал/Espruino}} | ||
Текущая версия от 22:36, 22 июня 2023
Функция 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 будут по-прежнему работать нормально.
Более подробно читайте в этой статье.
Примеры
См.также
Внешние ссылки