mirror of
https://github.com/DarkFlippers/unleashed-firmware.git
synced 2024-12-24 22:07:14 +03:00
ecab4d53d2
* Add doxygen and doxygen-awesome css, cleanup docs files * Ignore more libraries and remove leftover local variables * Create an actual intro page * .md files linting * Add doxygen action * Fix Doxygen path * Fix doxyfile path * Try to upload * Change docs branch * Add submudules checkout * Disable doxygen on PR * Mention the firmware docs in the readme * More dev docs mentions in the readme * Fix runner group, add tags * Test dev in PR * Disable running on PR * Fix a typo in the doxyfile * Try upload to S3 * Fix local path * Fix S3 ACL * Add delete flag, unifying dev and tags * Update ignored directories * More ignored directories * Even more ignored directories * Fix submodule * Change S3 uploader * Change S3 uploader version * Fix aws sync flags * Fix ACL * Disable ACL * Improve ignores, add WiFi devboard docs * TEMP: generate dev docs * TEMP: generate 0.89.0 docs * Disabling PR trigger * Enable submodules and test build * Enable test build * Disable test build * Change docs directory structure * Fix accidentally committed submodule * Fix submodules * Update links to the developer documentation * Markdown linting * Update workflow, enable test build * Fix doxygen dir path * Update Doxyfile-awesome.cfg * Change paths * Fix upload docs path * Disable pull_request debug trigger * Disable tags building * Remove autolinks and namespaces * Establish basic documentation structure * Add missing changes * Improve stylesheet, move some files * Improve examples * Improve the main page * Improve application dev docs * Improve system programming docs * Improve development tools docs * Improve other docs * Improve application examples * Fix formatting * Fix PVS-studio warnings * Improve visuals * Fix doxygen syntax warnings * Fix broken links * Update doxygen action Co-authored-by: DrunkBatya <drunkbatya.js@gmail.com> Co-authored-by: あく <alleteam@gmail.com> Co-authored-by: Georgii Surkov <georgii.surkov@outlook.com> Co-authored-by: Georgii Surkov <37121527+gsurkov@users.noreply.github.com>
53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
# 1-Wire Thermometer {#example_thermo}
|
|
|
|
This example application demonstrates the use of the 1-Wire library with a DS18B20 thermometer.
|
|
It also covers basic GUI, input handling, threads and localisation.
|
|
|
|
## Source code
|
|
|
|
Source code for this example can be found [here](https://github.com/flipperdevices/flipperzero-firmware/tree/dev/applications/examples/example_thermo).
|
|
|
|
## Electrical connections
|
|
|
|
Before launching the application, connect the sensor to Flipper's external GPIO according to the table below:
|
|
| DS18B20 | Flipper |
|
|
| :-----: | :-----: |
|
|
| VDD | 9 |
|
|
| GND | 18 |
|
|
| DQ | 17 |
|
|
|
|
*NOTE 1*: GND is also available on pins 8 and 11.
|
|
|
|
*NOTE 2*: For any other pin than 17, connect an external 4.7k pull-up resistor to pin 9.
|
|
|
|
## Launching the application
|
|
|
|
In order to launch this demo, follow the steps below:
|
|
1. Make sure your Flipper has an SD card installed.
|
|
2. Connect your Flipper to the computer via a USB cable.
|
|
3. Run `./fbt launch APPSRC=example_thermo` in your terminal emulator of choice.
|
|
|
|
## Changing the data pin
|
|
|
|
It is possible to use other GPIO pin as a 1-Wire data pin. In order to change it, set the `THERMO_GPIO_PIN` macro to any of the options listed below:
|
|
|
|
```c
|
|
/* Possible GPIO pin choices:
|
|
- gpio_ext_pc0
|
|
- gpio_ext_pc1
|
|
- gpio_ext_pc3
|
|
- gpio_ext_pb2
|
|
- gpio_ext_pb3
|
|
- gpio_ext_pa4
|
|
- gpio_ext_pa6
|
|
- gpio_ext_pa7
|
|
- gpio_ibutton
|
|
*/
|
|
|
|
#define THERMO_GPIO_PIN (gpio_ibutton)
|
|
```
|
|
Do not forget about the external pull-up resistor as these pins do not have one built-in.
|
|
|
|
With the changes been made, recompile and launch the application again.
|
|
The on-screen text should reflect it by asking to connect the thermometer to another pin.
|