Espruino:Справочник по API/Класс Puck/magOn()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

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


Функция 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.

Примеры

См.также

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