unleashed-firmware/wiki/fw/Application-examples.md

27 lines
1.0 KiB
Markdown
Raw Normal View History

2020-08-26 08:59:27 +03:00
In this article we create few application, interact between apps, use OS functions and interact with HAL.
2020-08-26 11:49:39 +03:00
# General agreements
2020-08-26 08:59:27 +03:00
Flipper application is just a function:
```C
void application_name(void* p) {
// Setup
while(1) {
// Loop
}
}
```
1. `void* p` is arbitrary pointer that may be used for pass parameters to application at launch (like argc/argv in POSIX).
2. Application must never attempt to return or exit from their implementing function.
3. Avoid long cycles without any "waits" or "blocking" like `delay` or `xQueueReceive`, otherwise your app will blocking overall Flipper work.
4. Do not create static variables inside function or global variables. Use only local variables. We plan to add virual in-RAM filesystem to save any persistent data.
# Application examples
* **[Blink](Blink-app)** show how to create app and control GPIO
* **[UART write](UART-write)** operate with FURI pipe and print some messages
* **[Inter-process communication](IPC-example)** describes how to interact between application through FURI