BH1750FVI старый пакет программного обеспечения

1 Введение

Старый пакет программного обеспечения BH1750FVI предоставляет основные функции для использования датчика освещённости BH1750FVI, а также дополнительную функцию программного усредняющего фильтра. В этой статье описываются основные функции пакета и команды тестирования Finsh/MSH.

Основные функции определяются датчиком BH1750FVI: при входном напряжении от 2,4 до 3,6 В диапазон измерения освещённости составляет:

Разрешение и время измерения BH1750FVI зависят от режима измерения, как показано в таблице ниже:

1.1 Структура каталога

1.2 Лицензия

Пакет программного обеспечения BH1750FVI следует лицензии Apache-2.0, см. файл LICENSE.

1.3 Зависимости

Зависит от фреймворка RT-Thread I2C для устройств с интерфейсом I2C.

2 Получение старого пакета программного обеспечения

Чтобы использовать пакет программного обеспечения BH1750FVI в RT-Thread, выберите его в менеджере пакетов RT-Thread. Путь следующий:

RT-Thread online packages --->
    peripheral libraries and drivers --->
        sensors drivers --->
              [*]   bh1750 sensor driver package, support: ambient light.  --->
                   	Version (v1.0.0)  --->
        [*] Enable average filter by software                                    
        (10) The number of averaging
        (1000) Peroid of sampling data(unit ms) 

Каждый параметр конфигурации имеет следующее описание:

• Enable average filter by software: включить функцию усредняющего программного фильтра для измерения освещённости;
• The number of averaging: количество усреднений;
• Peroid of sampling data (unit ms): период сбора данных, единица измерения — миллисекунды;
• Version: версия пакета программного обеспечения, по умолчанию используется последняя версия.

Затем позвольте менеджеру пакетов RT-Thread автоматически обновить или используйте команду pkgs --update для обновления пакета в BSP.

3 Использование старого пакета BH1750FVI

После получения пакета программного обеспечения BH1750FVI можно использовать датчик bh1750 и команды Finsh/MSH для тестирования, как описано ниже.

3.1 API

3.1.1 Инициализация

bh1750_device_t bh1750_init(const char *i2c_bus_name)

Инициализирует соответствующее устройство bh1750 на основе имени шины I2C, возвращая объект устройства bh1750 или NULL в случае неудачи.

3.1.2 Деинициализация

void bh1750_deinit(bh1750_device_t dev)

Освобождает ресурсы, связанные с устройством bh1750, если оно больше не используется.

3.1.3 Чтение освещённости

float bh1750_read_light(bh1750_device_t dev)

Считывает значение освещённости, измеренное датчиком bh1750, и возвращает значение типа float.

3.2 Команды Finsh/MSH

BH1750FVI предлагает множество команд для тестирования. Чтобы использовать их, просто включите функцию Finsh/MSH на RT-Thread. Эти команды полезны при разработке и отладке приложений, использующих датчик BH1750FVI. Они позволяют точно считывать значения освещённости. Для просмотра полного списка команд введите bh1750:

msh />bh1750
Usage:
bh1750 probe <dev_name>   - probe sensor by given name
bh1750 read               - read sensor bh1750 data
msh />

3.2.1 Обнаружение датчика на указанной шине I2C

При первом использовании команды bh1750 введите bh1750 probe <dev_name>, где <dev_name> — имя шины I2C (например, i2c2). Если датчик присутствует на этой шине, ошибок не будет. Если датчик отсутствует, будет выведено сообщение об ошибке:

msh />bh1750 probe i2c2      #успешное обнаружение, без ошибок
msh />
msh />bh1750 probe i2c66     #обнаружение не удалось, сообщение об ошибке
[E/bh1750] can't find bh1750 device on 'i2c66'
msh />

3.2.2 Чтение данных

После успешного обнаружения можно использовать команду bh1750 read для чтения значений освещённости:

msh />bh1750 read
read bh1750 sensor intensity   : 00431.6 lx
msh />