Skip to content

Commit

Permalink
[DOCS] Typo fixes (#1688)
Browse files Browse the repository at this point in the history
  • Loading branch information
DigiH committed Jun 16, 2023
1 parent a5549ee commit 561de90
Show file tree
Hide file tree
Showing 6 changed files with 13 additions and 13 deletions.
2 changes: 1 addition & 1 deletion docs/integrate/aws_iot.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ With PlatformIO you can directly leverage the environment `esp32dev-ble-aws`

## Build and upload

## Connect to a wifi Access point [see portal](../upload/portal)
## Connect to a WiFi Access point [see portal](../upload/portal)
Enter your credentials and verify that Secure connection is marked.

## Verify that you receive data in AWS
Expand Down
2 changes: 1 addition & 1 deletion docs/integrate/home_assistant.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ OMG will use the auto discovery functionality of home assistant to create gatewa
The Bluetooth and the RTL_433 gateway will create automatically devices and entities, the RF gateway will create DeviceTrigger.
The OpenMQTTGateway will also be available as a device to monitor its parameters and control it. The sensors (DHT for example) and actuators (relays) are attached to the gateway.

30 minutes after its activation the auto discovery will be automaticaly deactivated, you can reactivate it from the gateway controls.
30 minutes after its activation the auto discovery will be automatically deactivated, you can reactivate it from the gateway controls.
Some devices may require a button push or motion/contact event to trigger a message and generate the auto discovery.
:::

Expand Down
4 changes: 2 additions & 2 deletions docs/upload/troubleshoot.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ If you see a green badge this means that the code compilation is OK with the con
Check your IDE environment version, boards version, libraries version before submitting an issue or a question.
Verify especially that the libraries provided into the [release page](https://github.com/1technophile/OpenMQTTGateway/releases) are located into your "sketchbook folder"/libraries if your are using the Arduino IDE.

## ESP32 compilation errors related to wifi
## ESP32 compilation errors related to WiFi
If you get one or several of the following errors:

`error: 'WIFI_STA' was not declared in this scope`
Expand All @@ -15,7 +15,7 @@ If you get one or several of the following errors:

`error: no matching function for call to 'WiFiClass::macAddress()`

You have a conflict between Arduino default wifi library and ESP32 one. So as to resolve this issue you should move or remove the Arduino wifi library (Arduino Sketchbook folder\libraries\WiFi) in order to enable the IDE to take the one from ESP32 (Arduino Sketchbook folder\hardware\espressif\arduino-esp32\libraries\WiFi)
You have a conflict between Arduino default WiFi library and ESP32 one. So as to resolve this issue you should move or remove the Arduino WiFi library (Arduino Sketchbook folder\libraries\WiFi) in order to enable the IDE to take the one from ESP32 (Arduino Sketchbook folder\hardware\espressif\arduino-esp32\libraries\WiFi)
More info on [this topic](https://community.openmqttgateway.com/t/esp32-compilation-error/144/5?u=1technophile)

## Not able to send or receive RF or IR
Expand Down
2 changes: 1 addition & 1 deletion docs/upload/web-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ You can upload the firmware to your ESP device directly from here.
2. Select the firmware in the box below.
3. Click the install button and choose the port that the ESP is connected to.
4. Wait until the process is complete.
5. Once completed you can configure your [Wifi and MQTT credentials](portal.md)
5. Once completed you can configure your [WiFi and MQTT credentials](portal.md)

<web-uploader/>

Expand Down
4 changes: 2 additions & 2 deletions docs/use/ble.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,8 @@ Once the data has been transmitted to the MQTT broker, it can be easily integrat
Examples of compatible sensors among [our list](https://decoder.theengs.io/devices/devices_by_brand.html: Mi Flora, Mi jia, LYWDS02, LYWSD03MMC, ClearGrass, Mi scale, iBBQ, TPMS

## Receiving signals from BLE tracker devices for Presence detection
The gateway can detect the BLE trackers from Tile, NUT, TAGIT, ITAG, MiBand, Amazfit and RuuviTag and create automaticaly a device tracker entity following the Home Assistant discovery convention (if the auto discovery is activated).
To do this activate the "BT: Publish HASS presence" switch in your controller or send the followng MQTT command to your broker:
The gateway can detect the BLE trackers from Tile, NUT, TAGIT, ITAG, MiBand, Amazfit and RuuviTag and create automatically a device tracker entity following the Home Assistant discovery convention (if the auto discovery is activated).
To do this activate the "BT: Publish HASS presence" switch in your controller or send the following MQTT command to your broker:
`mosquitto_pub -t home/OpenMQTTGateway/commands/MQTTtoBT/config -m '{"hasspresence":true}'`

The entity created can be attached to a person to leverage presence detection. The `away` or `not home` state is triggered if the BLE tracker is not detected during the timer defined by `presenceawaytimer`.
Expand Down
12 changes: 6 additions & 6 deletions docs/use/boards.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ On M5Stack boards you may do a long press to these buttons in low power mode 0 (

You can also do a long press when powering the board to reset it, this press must be done during the first 5 seconds after the start.

### Wifi interference on ESP32 ###
Certain sensors like HC-SR501 is prone to generate false signals / triggers when used on a ESP32 with Wifi enabled. To reduce or elimate the effect the board must be put into Wifi B/G with lower TX power.
### WiFi interference on ESP32 ###
Certain sensors like HC-SR501 is prone to generate false signals / triggers when used on a ESP32 with WiFi enabled. To reduce or eliminate the effect the board must be put into WiFi B/G with lower TX power.

This can be achieved with the following macro, `WifiGMode` defined true and `WifiPower` to e.g. WIFI_POWER_11dBm.

Expand All @@ -37,7 +37,7 @@ The interval between the ESP32 wake up is defined at build time by the macro `Ti

::: tip
When coming back from mode 2 to mode 0 you may publish the command with a retain flag so as to enable the gateway to retrieve it when reconnecting.
A low power mode switch is automatically created by discovery with Home Assistant, you may experience a delay between the command and the state update due to the fact that the update will be revceived and acknowledged when the device woke up.
A low power mode switch is automatically created by discovery with Home Assistant, you may experience a delay between the command and the state update due to the fact that the update will be received and acknowledged when the device woke up.
In low power mode you should use ESPWifiManualSetup so as to rely on the credentials entered into User_config.h.
So as to do that uncomment the line below in User_config.h
``` c
Expand All @@ -54,7 +54,7 @@ If you change the default low power mode in config_BT.h to 2 and your credential

### Behaviour

If the connection of the board to WIFI and MQTT is successful you will see the logo with text like below:
If the connection of the board to WiFi and MQTT is successful you will see the logo with text like below:

![boards](../img/OpenMQTTgateway_M5_Stack_Board_Display_Text.png)

Expand Down Expand Up @@ -93,7 +93,7 @@ The low power mode can be changed also with a push to button B when the board is
If you are already in low power mode 1 or 2 with M5Stack you can wake up the board by pressing the red button.

### Low power mode (deepSleep) for ESP8266 & ESP32 boards
In certain use cases where power is severly limited you can use the ESP8266 or ESP32 deep sleep capability.
In certain use cases where power is severely limited you can use the ESP8266 or ESP32 deep sleep capability.

* e.g. measuring a pool temperature every 5 minutes using an ESP8266 and DS18B20 probe where the ESP8266 is powered by very limited battery backed solar power.
* e.g. as a water/leak detector which wake-up based on sensor state an ESP32 and C-37 YL-83 HM-RD sensor where the ESP32 is powered by very limited battery power.
Expand All @@ -110,4 +110,4 @@ For an ESP8266 a hardware jumper is required connecting RST to a GPIO (not to CH

On an ESP32 we can also use an external sensor state to wake-up the ESP and this is defined by macro `ESP32_EXT0_WAKE_PIN` and which state it must toggle to by macro `ESP32_EXT0_WAKE_PIN_STATE` defaulted to 1 (high).

And the sensor code must set variable `ready_to_sleep` to true after publishing the measurement to MQTT and the main loop will then enter deep sleep.
And the sensor code must set variable `ready_to_sleep` to true after publishing the measurement to MQTT and the main loop will then enter deep sleep.

0 comments on commit 561de90

Please sign in to comment.