Skip to content

Commit

Permalink
autoformat
Browse files Browse the repository at this point in the history
  • Loading branch information
Schluggi committed Apr 23, 2023
1 parent 5f1e1a5 commit df19f22
Show file tree
Hide file tree
Showing 3 changed files with 72 additions and 31 deletions.
Binary file added bom/v2.1.x.ods
Binary file not shown.
Binary file added bom/v2.1.x.pdf
Binary file not shown.
103 changes: 72 additions & 31 deletions docs/sensors.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,28 @@
# Sensors

The AIOsense PCB support and hand full of modular sensors. Chose any sensor you want but notice the compatibility.
The AIOsense PCB support and hand full of modular sensors. Chose any sensor you
want but notice the compatibility.

<hr>

## 🌡️Temperature, Humidity, Pressure & Air Quality

For these measurements we recommend the industrial sensors BME680/BME688 or the BME280 (cheaper but without air
For these measurements we recommend the industrial sensors BME680/BME688 or the
BME280 (cheaper but without air
quality).

Please notice that you can either use the BME280 **or** the BME680 out of the box (there have the same I²C address).
Please notice that you can either use the BME280 **or** the BME680 out of the
box (there have the same I²C address).

If you can solder SMD components you can solder them directly onto the PCB. Please notice that you will need and solder
these three more components: 2x 4K7 resistor (THT), 1x 100nF capacitor (also SMD). Also important to know: It's not
recommended to solder the BME680 with hot air because this can damage the air quality sensor. Use a hotplate instead.
If you can solder SMD components you can solder them directly onto the PCB.
Please notice that you will need and solder
these three more components: 2x 4K7 resistor (THT), 1x 100nF capacitor (also
SMD). Also important to know: It's not
recommended to solder the BME680 with hot air because this can damage the air
quality sensor. Use a hotplate instead.

Related to [#7](https://github.com/Schluggi/AIOsense/issues/7) sometimes SMD soldering can be inaccessible or difficult.
Related to [#7](https://github.com/Schluggi/AIOsense/issues/7) sometimes SMD
soldering can be inaccessible or difficult.
You can use a BME PCB module instead.

### Where to buy?
Expand All @@ -29,15 +36,17 @@ You can use a BME PCB module instead.

### Compatibility

This sensor is fully compatible with any other sensor or module. You can only choose _one_ BME module and loses one
This sensor is fully compatible with any other sensor or module. You can only
choose _one_ BME module and loses one
generic I²C port if you choose an PCB module.


<hr>

## 💡Illuminance (Light)

You want to turn the light on by motion but only when it's necessary? So you want to know, how bright it is? We
You want to turn the light on by motion but only when it's necessary? So you
want to know, how bright it is? We
recommend the really cheap GY-302 BH1750 PCB.

### Where to buy?
Expand All @@ -48,24 +57,31 @@ recommend the really cheap GY-302 BH1750 PCB.

### Compatibility

This sensor is fully compatible with any other sensor or module but uses one of the two generic I²C slots. If you want
This sensor is fully compatible with any other sensor or module but uses one of
the two generic I²C slots. If you want
to use the official 3D printed case you have to connect it to the lower slot.

<hr>

## 🎙️Microphone

> **WARNING**: Not supported yet! The mic uses some SPI pins. If you want to use the mic you **can not** use any
> generic device connected to the these IO-header pins: CS, SCK, MISO as well as any SPI based sensor at all.
> **WARNING**: Not supported yet! The mic uses some SPI pins. If you want to use
> the mic you **can not** use any
> generic device connected to the these IO-header pins: CS, SCK, MISO as well as
> any SPI based sensor at all.
We designed the board while having the future in mind. So the idea to have a microphone in each room for a voice
We designed the board while having the future in mind. So the idea to have a
microphone in each room for a voice
assistant would be awesome. Unfortunately, ESPHome does not support this
yet ([ESPHome feature request](https://github.com/esphome/feature-requests/issues/1254)). This in mind we can't test
yet ([ESPHome feature request](https://github.com/esphome/feature-requests/issues/1254)).
This in mind we can't test
this at all but Open Home (the company behind ESPHome and Home Assisant)
just [release there plans](https://www.youtube.com/watch?v=D936T1Ze8-4) for 2023 and mention that there is hope this
just [release there plans](https://www.youtube.com/watch?v=D936T1Ze8-4) for 2023
and mention that there is hope this
will be implemented in the upcoming year.

The AIOsense PCB is designed to work only with INMP441-modules which are known for their high quality digital audio.
The AIOsense PCB is designed to work only with INMP441-modules which are known
for their high quality digital audio.

### Where to buy?

Expand All @@ -82,40 +98,47 @@ The AIOsense PCB is designed to work only with INMP441-modules which are known f

## 🧍Presence (mmWave/radar)

Never heard before? It's a fancy technology to recognize the smallest movements (like a motion sensor/PIR but really
sensitive). This is useful in situations you want to track if someone is present even if the person is not really moving
Never heard before? It's a fancy technology to recognize the smallest
movements (like a motion sensor/PIR but really
sensitive). This is useful in situations you want to track if someone is present
even if the person is not really moving
for example while watching TV or sleeping.

The board is mainly made for the
SEN0395 [datasheet](https://wiki.dfrobot.com/mmWave_Radar_Human_Presence_Detection_SKU_SEN0395). There are two sockets
for this sensor. Feel free to choose yourself which one do you prefer. It's just the orientation. There is no difference
SEN0395 [datasheet](https://wiki.dfrobot.com/mmWave_Radar_Human_Presence_Detection_SKU_SEN0395).
There are two sockets
for this sensor. Feel free to choose yourself which one do you prefer. It's just
the orientation. There is no difference
between these two, and you can't use both sockets at the same time.

Shortly before release of V2.0 someone asked to support the much cheaper module
HLK-LD2410 [datasheet](https://drive.google.com/drive/folders/1p4dhbEJA3YubyIjIIC7wwVsSo8x29Fq-?spm=a2g0o.detail.1000023.17.6dfa18b2xYoafU).
So I added a socket. This module is also supported in ESPHome but currently there is no demo config available from our
So I added a socket. This module is also supported in ESPHome but currently
there is no demo config available from our
side. So [build it yourself](https://esphome.io/components/sensor/ld2410.html).

### Where to buy?

| Part | Shops |
|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| SEN0395 (recommended) | [Mouser](https://www.mouser.de/ProductDetail/DFRobot/SEN0395?qs=ljCeji4nMDmvEgq75EdCVA%3D%3D), [Farnell](https://de.farnell.com/en-DE/dfrobot/sen0395/mmwave-radar-board-arduino-board/dp/3879712), [Digi-Key](https://www.digikey.de/de/products/detail/dfrobot/SEN0395/14322660?s=N4IgTCBcDaIMoFEByAGAzATgKwgLoF8g) |
| HLK-LD2410 | [AliExpress](https://de.aliexpress.com/item/1005004351593073.html?spm=a2g0o.productlist.main.1.7d99569bRHd5zt&algo_pvid=26f5f6c1-cfdd-4c3c-b186-566c2cfb3ed3&algo_exp_id=26f5f6c1-cfdd-4c3c-b186-566c2cfb3ed3-0&pdp_ext_f=%7B%22sku_id%22%3A%2212000028862626467%22%7D&pdp_npi=2%40dis%21EUR%214.18%213.97%21%21%211.91%21%21%400b0a558a16695823917665301d0702%2112000028862626467%21sea&curPageLogUid=bucRiwoGGyws) |

> **Note:** The HLK-LD2410C (with an C at the end) is correctly not supported.
| Part | Shops |
|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| SEN0395 (recommended) | [Mouser](https://www.mouser.de/ProductDetail/DFRobot/SEN0395?qs=ljCeji4nMDmvEgq75EdCVA%3D%3D), [Farnell](https://de.farnell.com/en-DE/dfrobot/sen0395/mmwave-radar-board-arduino-board/dp/3879712), [Digi-Key](https://www.digikey.de/de/products/detail/dfrobot/SEN0395/14322660?s=N4IgTCBcDaIMoFEByAGAzATgKwgLoF8g) |
| HLK-LD2410 | [AliExpress](https://de.aliexpress.com/item/1005004351593073.html) |
| HLK-LD2410C | [AliExpress](https://de.aliexpress.com/item/1005005047841163.html) |

### Compatibility

This sensor is fully compatible with any other sensor or module, but you can only use one of them so choose wisely.
This sensor is fully compatible with any other sensor or module, but you can
only use one of them so choose wisely.

<hr>

## 🚶Motion Sensor (PIR)

You want a classic motion sensor? No problem. We support an industrial standard
EKMC1603111 ([Datasheet](https://www3.panasonic.biz/ac/ae/search_num/index.jsp?c=detail&part_no=EKMC1603111)). Every
other 3V PIR sensor with an TO-5 3-pin socket should work as well (but is untested).
EKMC1603111 ([Datasheet](https://www3.panasonic.biz/ac/ae/search_num/index.jsp?c=detail&part_no=EKMC1603111)).
Every
other 3V PIR sensor with an TO-5 3-pin socket should work as well (but is
untested).
Please notice that you will need an TO-5 3-pin socket as well (in any case)!

### Where to buy?
Expand All @@ -127,7 +150,25 @@ Please notice that you will need an TO-5 3-pin socket as well (in any case)!

### Compatibility

This sensor is fully compatible with any other sensor or module.
This sensor is fully compatible with any other sensor or module.

## 🔊 Piezo Buzzers

This is a passive buzzer which can create music in different frequencies.

### Where to buy?

| Part | Shops |
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------|
| Piezo Buzzer | [Amazon DE³](https://amzn.to/3n0aFza), [Mouser](https://www.mouser.de/ProductDetail/CUI-Devices/CEM-120342?qs=WyjlAZoYn50KzVdoYfaqpA%3D%3D) |

> Please notice the pinout of 6.5mm and a max height of 8.5mm. Otherwise, the
> buzzer will not fit
### Compatibility

This module is fully compatible with any other sensor or module besides
HLK-LD2410. The HLK-LD2410C however will work fine.

<hr>
³ Affiliate link

0 comments on commit df19f22

Please sign in to comment.