Add batteryMask for iBeacons

[PeteBa]

Describe the change
Some iBeacons provide battery level information in the major/minor fields. This PR adds a batteryMask option to identify the battery level and, if present, create a new sensor entity so that the information can be sent to, for example, Home Assistant. The mask operates on a 32bit field using major as the high two bytes and minor as the low two bytes.

So, for example, with some Jaylee beacons that provide 0-100 value in the high byte of the minor field, you can use batteryMask: "0x0000FF00" to extract the information. You can add the option at the BLE module or beacon level (via tagOverride).

Let me know if this is useful and I can adjust docs/test as needed.

Checklist
If you changed code:

• Tests run locally and pass (npm test)
• Code has correct format (npm run format)

If you added a new integration:

• Documentation page added in docs/integrations/
• Page linked in docs/.vuepress/config.js and docs/integrations/README.md

Additional information
Partially addresses #160

[codecov]

Codecov Report

Merging #337 (a03c205) into master (526edf8) will increase coverage by 0.14%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #337      +/-   ##
==========================================
+ Coverage   91.65%   91.80%   +0.14%     
==========================================
  Files          86       86              
  Lines        1846     1879      +33     
  Branches      227      236       +9     
==========================================
+ Hits         1692     1725      +33     
  Misses        151      151              
  Partials        3        3              

Flag	Coverage Δ
unittests	91.80% <100.00%> (+0.14%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...ons/bluetooth-classic/bluetooth-classic.service.ts	97.79% <100.00%> (ø)
...low-energy/bluetooth-low-energy-presence.sensor.ts	100.00% <100.00%> (ø)
...luetooth-low-energy/bluetooth-low-energy.config.ts	100.00% <100.00%> (ø)
...uetooth-low-energy/bluetooth-low-energy.service.ts	100.00% <100.00%> (ø)
src/integrations/bluetooth-low-energy/i-beacon.ts	100.00% <100.00%> (ø)
...rations/bluetooth-low-energy/new-distance.event.ts	100.00% <100.00%> (ø)
.../integrations/room-presence/room-presence.proxy.ts	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 526edf8...a03c205. Read the comment docs.

[mKeRix]

Cool addition! This complements your major/minor mask feature well. In addition to the comments on the current code it would also be great if you could write some tests for the new functionality and add the batteryMask option to the relevant tables in bluetooth-low-energy.md.

[mKeRix]

Looks good! I will get this merged and released soon, just want to put one more thing into the release as well.

[github-actions]

🎉 This PR is included in version 2.12.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[liamstears]

Hey PeyeBa, where did you get the Jaylee beacons you mention? I would like to buy the same beacons so I know they will work correctly and do what I need to do...

[PeteBa]

The ones I have were distributed by Ankhmaway and Jaalee. I bought mine many years ago from a UK based retailer ibeaconzone. I went with the IB001M for my keyring as it is pretty small and a bunch of IB004N that are a bit bigger but with longer range for the visitors/cleaner/gardener/... Looks like the seller has some stock (IB004N) but out-of-stock (IB001M). A quick google shows sporadic hits (alibaba, etc) so may be difficult to source locally. I do see there is a Jaalee store that has similar for sale here.