<commit_before># lib_BL999

Arduino library for **BL999** remote Temperature/Humidity sensor

## Table of Contents

  1. [Sensor description](#sensor-description)
  1. [Protocol description](#protocol-description)
  1. [Structure of data bits in a message](#structure-of-data-bits-in-a-message)
  1. [Bits purpose](#bits-purpose)
  1. [Library usage](#library-usage)
  1. [API description](#api-description)

## Sensor description
  * BL999 sensor working frequency is 433 Mhz
  * Max distance: 30 m
  * Temperature range -40 +50 Celsius
  * Humidity 1-99%

## Protocol description
  * BL999 uses PWM to send it's data.
  * BL999 message packet consists of `one` start bit and `36` value bits divided by PWM high pulses
  * BL999 repeats same message `4` times during one data sending session. 
  * Usual PWM oscillogram looks like:
  
```
  ___         ___     ___  ___
  | |         | |     | |  | |<commit_msg>readme update<commit_after># lib_BL999

Arduino library for **BL999** remote Temperature/Humidity sensor<br/>
It supports both **BL999** sensor types: with humidity and temperature-only

## Table of Contents

  1. [Sensor description](#sensor-description)
  1. [Protocol description](#protocol-description)
  1. [Structure of data bits in a message](#structure-of-data-bits-in-a-message)
  1. [Bits purpose](#bits-purpose)
  1. [Library usage](#library-usage)
  1. [API description](#api-description)

## Sensor description
  * BL999 sensor working frequency is 433 Mhz
  * Max distance: 30 m
  * Temperature range -40 +50 Celsius
  * Humidity 1-99%

## Protocol description
  * BL999 uses PWM to send it's data.
  * BL999 message packet consists of `one` start bit and `36` value bits divided by PWM high pulses
  * BL999 repeats same message `4` times during one data sending session. 
  * Usual PWM oscillogram looks like:
  
```
  ___         ___     ___  ___
  | |         | |     | |  | |
{'fraction_non_alphanumeric': 0.10540115364446775, 'fraction_numerical': 0.042475091767173574, 'mean_word_length': 3.4166666666666665, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 4, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2508448', 'n_tokens_mistral': 652, 'n_tokens_neox': 566, 'n_words': 205}