1.. _mikroe_weather_click:
2
3MikroElektronika Weather Click
4##############################
5
6Overview
7********
8
9The MikroElektronika `Weather Click`_ features the `BME280`_ integrated
10environmental sensor in a `mikroBUS`_ |trade| form factor. The sensor can
11measure relative humidity, barometric pressure, and ambient temperature.
12
13.. figure:: weather-click.webp
14   :align: center
15   :alt: MikroElektronika Weather Click
16
17   MikroElektronika Weather Click (Credit: MikroElektronika)
18
19Requirements
20************
21
22This shield can only be used with a board that provides a mikroBUS |trade|
23socket and defines a ``mikrobus_i2c`` node label for the mikroBUS |trade| I2C
24interface or a ``mikrobus_spi`` node label for the mikroBUS |trade| SPI
25interface (see :ref:`shields` for more details).
26
27.. note::
28
29   By default the Weather Click is configured to use the I2C interface. In
30   order to use the SPI interface the jumper settings must be changed. See
31   the `Weather Click Schematic`_ for further details.
32
33For more information about the BME280 and the Weather Click, see the following
34documentation:
35
36- `Weather Click`_
37- `Weather Click Schematic`_
38- `BME280`_
39- `BME280 Datasheet`_
40
41Programming
42***********
43
44Set ``--shield mikroe_weather_click_i2c`` or
45``--shield mikroe_weather_click_spi`` when you invoke ``west build``. For
46example:
47
48.. zephyr-app-commands::
49   :zephyr-app: samples/sensor/bme280
50   :board: lpcxpresso55s16
51   :shield: [mikroe_weather_click_i2c | mikroe_weather_click_spi]
52   :goals: build
53
54.. _Weather Click:
55   https://www.mikroe.com/weather-click
56
57.. _Weather Click Schematic:
58   https://download.mikroe.com/documents/add-on-boards/click/weather/weather-click-schematic-v101.pdf
59
60.. _BME280:
61   https://www.bosch-sensortec.com/products/environmental-sensors/humidity-sensors-bme280/
62
63.. _BME280 Datasheet:
64   https://www.bosch-sensortec.com/media/boschsensortec/downloads/datasheets/bst-bme280-ds002.pdf
65
66.. _mikroBUS:
67   https://www.mikroe.com/mikrobus
68