|`UQCOqcnYkvzOZUV_9bPE_8oTbOrOF03MnF-VcJyjisTZmsxa`|
#### Thanks to our sponsors who supported project in the past and special thanks to sponsors who supports us on regular basis:
@mishamyte, ClaraCrazy, Pathfinder [Count Zero cDc], callmezimbra, Quen0n, MERRON, grvpvl (lvpvrg), art_col, ThurstonWaffles, Moneron, UterGrooll, LUCFER, Northpirate, zloepuzo, T.Rat, Alexey B., ionelife, ...
diff --git a/ReadMe.md b/ReadMe.md
index 7eb98aeed3..b2911d14d8 100644
--- a/ReadMe.md
+++ b/ReadMe.md
@@ -139,21 +139,21 @@ Our team is small and the guys are working on this project as much as they can s
The amount of work done on this project is huge and we need your support, no matter how large or small. Even if you just say, "Thank you Unleashed firmware developers!" somewhere. Doing so will help us continue our work and will help drive us to make the firmware better every time.
Also, regarding our releases, every build has and always will be free and open-source. There will be no paywall releases or closed-source apps within the firmware. As long as I am working on this project it will never happen.
You can support us by using links or addresses below:
-|Service|Remark|Link/Wallet|
-|-|-|-|
-|**Patreon**||https://patreon.com/mmxdev|
-|**Boosty**|patreon alternative|https://boosty.to/mmxdev|
-|cloudtips|only RU payments accepted|https://pay.cloudtips.ru/p/7b3e9d65|
-|YooMoney|only RU payments accepted|https://yoomoney.ru/fundraise/XA49mgQLPA0.221209|
-|USDT|(TRC20)|`TSXcitMSnWXUFqiUfEXrTVpVewXy2cYhrs`|
-|ETH|(BSC/ERC20-Tokens)|`darkflippers.eth` (or `0xFebF1bBc8229418FF2408C07AF6Afa49152fEc6a`)|
-|BTC||`bc1q0np836jk9jwr4dd7p6qv66d04vamtqkxrecck9`|
-|SOL|(Solana/Tokens)|`DSgwouAEgu8iP5yr7EHHDqMNYWZxAqXWsTEeqCAXGLj8`|
-|DOGE||`D6R6gYgBn5LwTNmPyvAQR6bZ9EtGgFCpvv`|
-|LTC||`ltc1q3ex4ejkl0xpx3znwrmth4lyuadr5qgv8tmq8z9`|
-|BCH||`qquxfyzntuqufy2dx0hrfr4sndp0tucvky4sw8qyu3`|
-|XMR|(Monero)| `41xUz92suUu1u5Mu4qkrcs52gtfpu9rnZRdBpCJ244KRHf6xXSvVFevdf2cnjS7RAeYr5hn9MsEfxKoFDRSctFjG5fv1Mhn`|
-|TON||`UQCOqcnYkvzOZUV_9bPE_8oTbOrOF03MnF-VcJyjisTZmsxa`|
+|Service|Remark|QR Code|Link/Wallet|
+|-|-|-|-|
+|**Patreon**||
|`UQCOqcnYkvzOZUV_9bPE_8oTbOrOF03MnF-VcJyjisTZmsxa`|
## Community apps included
From 23903e7e8da6ed9acf74ba5a89fd38868a7d5e96 Mon Sep 17 00:00:00 2001
From: DerSkythe
Date: Wed, 24 Jul 2024 17:56:25 +0400
Subject: [PATCH 02/52] feat: Refactor frequency analyzer code for better
readability
Refactor to improve structure and readability of the frequency analyzer code. This includes added comments, updating variable names, and reorganizing the frequency list for clarity. The changes also address initialization issues and clean up repetitive code blocks.
---
.../subghz/views/subghz_frequency_analyzer.c | 214 ++++++++++--------
1 file changed, 117 insertions(+), 97 deletions(-)
diff --git a/applications/main/subghz/views/subghz_frequency_analyzer.c b/applications/main/subghz/views/subghz_frequency_analyzer.c
index 1bb2f044fe..fde3a1f613 100644
--- a/applications/main/subghz/views/subghz_frequency_analyzer.c
+++ b/applications/main/subghz/views/subghz_frequency_analyzer.c
@@ -1,7 +1,6 @@
#include "subghz_frequency_analyzer.h"
#include
-#include
#include
#include
#include
@@ -12,20 +11,79 @@
#define TAG "frequency_analyzer"
-#define RSSI_MIN -97
-#define RSSI_MAX -60
-#define RSSI_SCALE 2.3
+#define RSSI_MIN (-97.0f)
+#define RSSI_MAX (-60.0f)
+#define RSSI_SCALE 2.3f
#define TRIGGER_STEP 1
#define MAX_HISTORY 4
+#ifndef ARRAY_SIZE
+#define ARRAY_SIZE(x) (sizeof(x) / sizeof(x[0]))
+#endif
static const uint32_t subghz_frequency_list[] = {
- 300000000, 302757000, 303875000, 303900000, 304250000, 307000000, 307500000, 307800000,
- 309000000, 310000000, 312000000, 312100000, 313000000, 313850000, 314000000, 314350000,
- 314980000, 315000000, 318000000, 330000000, 345000000, 348000000, 350000000, 387000000,
- 390000000, 418000000, 430000000, 431000000, 431500000, 433075000, 433220000, 433420000,
- 433657070, 433889000, 433920000, 434075000, 434176948, 434390000, 434420000, 434775000,
- 438900000, 440175000, 464000000, 779000000, 868350000, 868400000, 868800000, 868950000,
- 906400000, 915000000, 925000000, 928000000};
+ /* 300 - 348 */
+ 300000000,
+ 302757000,
+ 303875000,
+ 303900000,
+ 304250000,
+ 307000000,
+ 307500000,
+ 307800000,
+ 309000000,
+ 310000000,
+ 312000000,
+ 312100000,
+ 312200000,
+ 313000000,
+ 313850000,
+ 314000000,
+ 314350000,
+ 314980000,
+ 315000000,
+ 318000000,
+ 330000000,
+ 345000000,
+ 348000000,
+ 350000000,
+
+ /* 387 - 464 */
+ 387000000,
+ 390000000,
+ 418000000,
+ 430000000,
+ 430500000,
+ 431000000,
+ 431500000,
+ 433075000, /* LPD433 first */
+ 433220000,
+ 433420000,
+ 433657070,
+ 433889000,
+ 433920000, /* LPD433 mid */
+ 434075000,
+ 434176948,
+ 434190000,
+ 434390000,
+ 434420000,
+ 434620000,
+ 434775000, /* LPD433 last channels */
+ 438900000,
+ 440175000,
+ 464000000,
+ 467750000,
+
+ /* 779 - 928 */
+ 779000000,
+ 868350000,
+ 868400000,
+ 868800000,
+ 868950000,
+ 906400000,
+ 915000000,
+ 925000000,
+ 928000000,
+};
typedef enum {
SubGhzFrequencyAnalyzerStatusIDLE,
@@ -80,7 +138,7 @@ void subghz_frequency_analyzer_draw_rssi(
uint8_t x,
uint8_t y) {
// Current RSSI
- if(rssi) {
+ if(!float_is_equal(rssi, 0.f)) {
if(rssi > RSSI_MAX) {
rssi = RSSI_MAX;
}
@@ -95,7 +153,7 @@ void subghz_frequency_analyzer_draw_rssi(
}
// Last RSSI
- if(rssi_last) {
+ if(!float_is_equal(rssi_last, 0.f)) {
if(rssi_last > RSSI_MAX) {
rssi_last = RSSI_MAX;
}
@@ -108,7 +166,7 @@ void subghz_frequency_analyzer_draw_rssi(
// Trigger cursor
trigger = (trigger - RSSI_MIN) / RSSI_SCALE;
- uint8_t tr_x = x + 2 * trigger;
+ uint8_t tr_x = (uint8_t)((float)x + (2 * trigger));
canvas_draw_dot(canvas, tr_x, y + 4);
canvas_draw_line(canvas, tr_x - 1, y + 5, tr_x + 1, y + 5);
@@ -118,7 +176,7 @@ void subghz_frequency_analyzer_draw_rssi(
static void subghz_frequency_analyzer_history_frequency_draw(
Canvas* canvas,
SubGhzFrequencyAnalyzerModel* model) {
- char buffer[64];
+ char buffer[64] = {0};
const uint8_t x1 = 2;
const uint8_t x2 = 66;
const uint8_t y = 37;
@@ -161,7 +219,7 @@ static void subghz_frequency_analyzer_history_frequency_draw(
}
void subghz_frequency_analyzer_draw(Canvas* canvas, SubGhzFrequencyAnalyzerModel* model) {
- char buffer[64];
+ char buffer[64] = {0};
// Title
canvas_set_color(canvas, ColorBlack);
@@ -190,9 +248,7 @@ void subghz_frequency_analyzer_draw(Canvas* canvas, SubGhzFrequencyAnalyzerModel
canvas_draw_box(canvas, 4, 10, 121, 19);
canvas_set_color(canvas, ColorWhite);
} else {
- // TODO: Disable this
- //canvas_draw_box(canvas, 4, 11, 121, 19);
- //canvas_set_color(canvas, ColorWhite);
+ canvas_set_color(canvas, ColorBlack);
}
canvas_draw_str(canvas, 8, 26, buffer);
@@ -224,11 +280,14 @@ void subghz_frequency_analyzer_draw(Canvas* canvas, SubGhzFrequencyAnalyzerModel
uint32_t subghz_frequency_find_correct(uint32_t input) {
uint32_t prev_freq = 0;
- uint32_t current = 0;
uint32_t result = 0;
+ uint32_t current;
- for(size_t i = 0; i < sizeof(subghz_frequency_list); i++) {
+ for(size_t i = 0; i < ARRAY_SIZE(subghz_frequency_list) - 1; i++) {
current = subghz_frequency_list[i];
+ if(current == 0) {
+ continue;
+ }
if(current == input) {
result = current;
break;
@@ -249,47 +308,40 @@ uint32_t subghz_frequency_find_correct(uint32_t input) {
bool subghz_frequency_analyzer_input(InputEvent* event, void* context) {
furi_assert(context);
- SubGhzFrequencyAnalyzer* instance = context;
+ SubGhzFrequencyAnalyzer* instance = (SubGhzFrequencyAnalyzer*)context;
bool need_redraw = false;
-
if(event->key == InputKeyBack) {
- return false;
+ return need_redraw;
}
- if(((event->type == InputTypePress) || (event->type == InputTypeRepeat)) &&
- ((event->key == InputKeyLeft) || (event->key == InputKeyRight))) {
+ bool is_press_or_repeat = (event->type == InputTypePress) || (event->type == InputTypeRepeat);
+ if(is_press_or_repeat && (event->key == InputKeyLeft || event->key == InputKeyRight)) {
// Trigger setup
float trigger_level = subghz_frequency_analyzer_worker_get_trigger_level(instance->worker);
- switch(event->key) {
- case InputKeyLeft:
+ if(event->key == InputKeyLeft) {
trigger_level -= TRIGGER_STEP;
if(trigger_level < RSSI_MIN) {
trigger_level = RSSI_MIN;
}
- break;
- default:
- case InputKeyRight:
+ } else {
trigger_level += TRIGGER_STEP;
if(trigger_level > RSSI_MAX) {
trigger_level = RSSI_MAX;
}
- break;
}
subghz_frequency_analyzer_worker_set_trigger_level(instance->worker, trigger_level);
FURI_LOG_D(TAG, "trigger = %.1f", (double)trigger_level);
need_redraw = true;
} else if(event->type == InputTypePress && event->key == InputKeyUp) {
- if(instance->feedback_level == 0) {
- instance->feedback_level = 2;
+ if(instance->feedback_level == SubGHzFrequencyAnalyzerFeedbackLevelAll) {
+ instance->feedback_level = SubGHzFrequencyAnalyzerFeedbackLevelMute;
} else {
instance->feedback_level--;
}
need_redraw = true;
- } else if(
- ((event->type == InputTypePress) || (event->type == InputTypeRepeat)) &&
- event->key == InputKeyDown) {
+ } else if(is_press_or_repeat && event->key == InputKeyDown) {
instance->show_frame = instance->max_index > 0;
if(instance->show_frame) {
instance->selected_index = (instance->selected_index + 1) % instance->max_index;
@@ -298,63 +350,32 @@ bool subghz_frequency_analyzer_input(InputEvent* event, void* context) {
} else if(event->key == InputKeyOk) {
need_redraw = true;
bool updated = false;
- uint32_t frequency_to_save = 0;
+ uint32_t frequency_to_save;
with_view_model(
instance->view,
SubGhzFrequencyAnalyzerModel * model,
{
frequency_to_save = model->frequency_to_save;
+ uint32_t prev_freq_to_save = model->frequency_to_save;
+ uint32_t frequency_candidate = 0;
+
if(model->show_frame && !model->signal) {
- uint32_t prev_freq_to_save = model->frequency_to_save;
- uint32_t frequency_candidate = model->history_frequency[model->selected_index];
- if(frequency_candidate == 0 ||
- // !furi_hal_subghz_is_frequency_valid(frequency_candidate) ||
- !subghz_txrx_radio_device_is_frequency_valid(
- instance->txrx, frequency_candidate) ||
- prev_freq_to_save == frequency_candidate) {
- frequency_candidate = 0;
- } else {
- frequency_candidate = subghz_frequency_find_correct(frequency_candidate);
- }
- if(frequency_candidate > 0 &&
- frequency_candidate != model->frequency_to_save) {
- model->frequency_to_save = frequency_candidate;
- updated = true;
- }
- } else if(model->show_frame && model->signal) {
- uint32_t prev_freq_to_save = model->frequency_to_save;
- uint32_t frequency_candidate = subghz_frequency_find_correct(model->frequency);
- if(frequency_candidate == 0 ||
- // !furi_hal_subghz_is_frequency_valid(frequency_candidate) ||
- !subghz_txrx_radio_device_is_frequency_valid(
- instance->txrx, frequency_candidate) ||
- prev_freq_to_save == frequency_candidate) {
- frequency_candidate = 0;
- } else {
- frequency_candidate = subghz_frequency_find_correct(frequency_candidate);
- }
- if(frequency_candidate > 0 &&
- frequency_candidate != model->frequency_to_save) {
- model->frequency_to_save = frequency_candidate;
- updated = true;
- }
- } else if(!model->show_frame && model->signal) {
- uint32_t prev_freq_to_save = model->frequency_to_save;
- uint32_t frequency_candidate = subghz_frequency_find_correct(model->frequency);
- if(frequency_candidate == 0 ||
- // !furi_hal_subghz_is_frequency_valid(frequency_candidate) ||
- !subghz_txrx_radio_device_is_frequency_valid(
- instance->txrx, frequency_candidate) ||
- prev_freq_to_save == frequency_candidate) {
- frequency_candidate = 0;
- } else {
- frequency_candidate = subghz_frequency_find_correct(frequency_candidate);
- }
- if(frequency_candidate > 0 &&
- frequency_candidate != model->frequency_to_save) {
- model->frequency_to_save = frequency_candidate;
- updated = true;
- }
+ frequency_candidate = model->history_frequency[model->selected_index];
+ } else if(
+ (model->show_frame && model->signal) ||
+ (!model->show_frame && model->signal)) {
+ frequency_candidate = subghz_frequency_find_correct(model->frequency);
+ }
+
+ frequency_candidate = frequency_candidate == 0 ||
+ !subghz_txrx_radio_device_is_frequency_valid(
+ instance->txrx, frequency_candidate) ||
+ prev_freq_to_save == frequency_candidate ?
+ 0 :
+ subghz_frequency_find_correct(frequency_candidate);
+ if(frequency_candidate > 0 && frequency_candidate != model->frequency_to_save) {
+ model->frequency_to_save = frequency_candidate;
+ updated = true;
}
},
true);
@@ -363,7 +384,7 @@ bool subghz_frequency_analyzer_input(InputEvent* event, void* context) {
instance->callback(SubGhzCustomEventViewFreqAnalOkShort, instance->context);
}
- // First device receive short, then when user release button we get long
+ // First the device receives short, then when user release button we get long
if(event->type == InputTypeLong && frequency_to_save > 0) {
// Stop worker
if(subghz_frequency_analyzer_worker_is_running(instance->worker)) {
@@ -375,7 +396,6 @@ bool subghz_frequency_analyzer_input(InputEvent* event, void* context) {
}
if(need_redraw) {
- SubGhzFrequencyAnalyzer* instance = context;
with_view_model(
instance->view,
SubGhzFrequencyAnalyzerModel * model,
@@ -412,7 +432,7 @@ void subghz_frequency_analyzer_pair_callback(
uint32_t frequency,
float rssi,
bool signal) {
- SubGhzFrequencyAnalyzer* instance = context;
+ SubGhzFrequencyAnalyzer* instance = (SubGhzFrequencyAnalyzer*)context;
if(float_is_equal(rssi, 0.f) && instance->locked) {
if(instance->callback) {
instance->callback(SubGhzCustomEventSceneAnalyzerUnlock, instance->context);
@@ -477,7 +497,7 @@ void subghz_frequency_analyzer_pair_callback(
},
false);
instance->max_index = max_index;
- } else if((rssi != 0.f) && (!instance->locked)) {
+ } else if(!float_is_equal(rssi, 0.f) && !instance->locked) {
// There is some signal
FURI_LOG_I(TAG, "rssi = %.2f, frequency = %ld Hz", (double)rssi, frequency);
frequency = round_int(frequency, 3); // Round 299999990Hz to 300000000Hz
@@ -490,11 +510,11 @@ void subghz_frequency_analyzer_pair_callback(
}
// Update values
- if(rssi >= instance->rssi_last && (frequency != 0)) {
+ if(rssi >= instance->rssi_last && frequency != 0) {
instance->rssi_last = rssi;
}
- instance->locked = (rssi != 0.f);
+ instance->locked = !float_is_equal(rssi, 0.f);
with_view_model(
instance->view,
SubGhzFrequencyAnalyzerModel * model,
@@ -514,7 +534,7 @@ void subghz_frequency_analyzer_pair_callback(
void subghz_frequency_analyzer_enter(void* context) {
furi_assert(context);
- SubGhzFrequencyAnalyzer* instance = context;
+ SubGhzFrequencyAnalyzer* instance = (SubGhzFrequencyAnalyzer*)context;
//Start worker
instance->worker = subghz_frequency_analyzer_worker_alloc(instance->context);
@@ -560,7 +580,7 @@ void subghz_frequency_analyzer_enter(void* context) {
void subghz_frequency_analyzer_exit(void* context) {
furi_assert(context);
- SubGhzFrequencyAnalyzer* instance = context;
+ SubGhzFrequencyAnalyzer* instance = (SubGhzFrequencyAnalyzer*)context;
// Stop worker
if(subghz_frequency_analyzer_worker_is_running(instance->worker)) {
@@ -574,7 +594,7 @@ void subghz_frequency_analyzer_exit(void* context) {
SubGhzFrequencyAnalyzer* subghz_frequency_analyzer_alloc(SubGhzTxRx* txrx) {
SubGhzFrequencyAnalyzer* instance = malloc(sizeof(SubGhzFrequencyAnalyzer));
- instance->feedback_level = 2;
+ instance->feedback_level = SubGHzFrequencyAnalyzerFeedbackLevelMute;
// View allocation and configuration
instance->view = view_alloc();
From 4ed19b518bd5d70fb1c2aeeaae9e0b080a3a148e Mon Sep 17 00:00:00 2001
From: DerSkythe
Date: Wed, 24 Jul 2024 18:39:47 +0400
Subject: [PATCH 03/52] fix: remove not printable symbols and update FAQ and
BadUSB documentation links for clarity
This commit improves the documentation by converting raw URLs into descriptive text links in the FAQ and BadUSB documentation. This enhances readability and navigation for users looking for specific information. Additionally, minor formatting adjustments were made for better consistency and clarity.
---
documentation/AppManifests.md | 31 ++-
documentation/BarcodeGenerator.md | 15 +-
documentation/FAQ.md | 236 +++++++++--------
documentation/FuriHalBus.md | 135 +++++-----
documentation/HowToBuild.md | 19 +-
.../Firmware update on Developer Board.md | 51 ++--
.../Get started with the Dev Board.md | 94 +++----
.../Reading logs via the Dev Board.md | 76 +++---
documentation/fbt.md | 2 +-
.../file_formats/BadUsbScriptFormat.md | 241 ++++++++++--------
10 files changed, 465 insertions(+), 435 deletions(-)
diff --git a/documentation/AppManifests.md b/documentation/AppManifests.md
index 98a38ffd85..493c9253bb 100644
--- a/documentation/AppManifests.md
+++ b/documentation/AppManifests.md
@@ -16,18 +16,18 @@ Only two parameters are mandatory: **appid** and **apptype**. Others are optiona
- **apptype**: member of FlipperAppType.\* enumeration. Valid values are:
-| Enum member | Firmware component type |
-| ----------- | ------------------------------------------------------------------------------------------- |
-| SERVICE | System service, created at early startup |
-| SYSTEM | Application is not being shown in any menus. It can be started by other apps or from CLI |
-| APP | Regular application for the main menu |
-| PLUGIN | Application to be built as a part of the firmware and to be placed in the Plugins menu |
-| DEBUG | Application only visible in Debug menu with debug mode enabled |
-| ARCHIVE | One and only Archive app |
-| SETTINGS | Application to be placed in the system settings menu |
-| STARTUP | Callback function to run at system startup. Does not define a separate app |
-| EXTERNAL | Application to be built as `.fap` plugin |
-| METAPACKAGE | Does not define any code to be run, used for declaring dependencies and application bundles |
+| Enum member | Firmware component type |
+|:----------------|--------------------------------------------------------------------------------------------------|
+| SERVICE | System service, created at early startup |
+| SYSTEM | Application is not being shown in any menus. It can be started by other apps or from CLI |
+| APP | Regular application for the main menu |
+| PLUGIN | Application to be built as a part of the firmware and to be placed in the Plugins menu |
+| DEBUG | Application only visible in Debug menu with debug mode enabled |
+| ARCHIVE | One and only Archive app |
+| SETTINGS | Application to be placed in the system settings menu |
+| STARTUP | Callback function to run at system startup. Does not define a separate app |
+| EXTERNAL | Application to be built as `.fap` plugin |
+| METAPACKAGE | Does not define any code to be run, used for declaring dependencies and application bundles |
- **name**: name displayed in menus.
- **entry_point**: C function to be used as the application's entry point. Note that C++ function names are mangled, so you need to wrap them in `extern "C"` to use them as entry points.
@@ -43,7 +43,7 @@ Only two parameters are mandatory: **appid** and **apptype**. Others are optiona
- **targets**: list of strings and target names with which this application is compatible. If not specified, the application is built for all targets. The default value is `["all"]`.
- **resources**: name of a folder within the application's source folder to be used for packacking SD card resources for this application. They will only be used if application is included in build configuration. The default value is `""`, meaning no resources are packaged.
-#### Parameters for external applications
+### Parameters for external applications
The following parameters are used only for [FAPs](./AppsOnSDCard.md):
@@ -59,7 +59,10 @@ The following parameters are used only for [FAPs](./AppsOnSDCard.md):
- **fap_extbuild**: provides support for parts of application sources to be built by external tools. Contains a list of `ExtFile(path="file name", command="shell command")` definitions. `fbt` will run the specified command for each file in the list.
- **fal_embedded**: boolean, default `False`. Applies only to PLUGIN type. If `True`, the plugin will be embedded into host application's .fap file as a resource and extracted to `apps_assets/APPID` folder on its start. This allows plugins to be distributed as a part of the host application.
-Note that commands are executed at the firmware root folder, and all intermediate files must be placed in an application's temporary build folder. For that, you can use pattern expansion by `fbt`: `${FAP_WORK_DIR}` will be replaced with the path to the application's temporary build folder, and `${FAP_SRC_DIR}` will be replaced with the path to the application's source folder. You can also use other variables defined internally by `fbt`.
+> [!NOTE]
+> These commands are executed at the firmware root folder, and all intermediate files must be placed in an application's temporary build folder.
+> For that, you can use pattern expansion by `fbt`: `${FAP_WORK_DIR}` will be replaced with the path to the application's temporary build folder,
+> and `${FAP_SRC_DIR}` will be replaced with the path to the application's source folder. You can also use other variables defined internally by `fbt`.
Example for building an app from Rust sources:
diff --git a/documentation/BarcodeGenerator.md b/documentation/BarcodeGenerator.md
index f2b5b2213b..0f429fda16 100644
--- a/documentation/BarcodeGenerator.md
+++ b/documentation/BarcodeGenerator.md
@@ -1,15 +1,16 @@
# This is a UPC-A Barcode Generator for the Flipper Zero hardware.
-## Author: [McAzzaMan](https://github.com/McAzzaMan/flipperzero-firmware/tree/UPC-A_Barcode_Generator/applications/barcode_generator)
+> Author: [McAzzaMan](https://github.com/McAzzaMan/flipperzero-firmware/tree/UPC-A_Barcode_Generator/applications/barcode_generator)
-
+
It will eventually be expanded into other barcode types. It currently only generates UPC-A type barcodes.
-
+
- -Controls-
-Hitting the centre button on the Flipper toggles edit mode.
-When in edit mode, left and right will change the digit to be changed, and up and down will adjust the digit value.
+## Controls
-
+Hitting the `centre` button on the Flipper toggles edit mode.
+When in edit mode, `Left` and `Right` will change the digit to be changed, and up and down will adjust the digit value.
+
+
diff --git a/documentation/FAQ.md b/documentation/FAQ.md
index 8f912c517f..96b11aca53 100644
--- a/documentation/FAQ.md
+++ b/documentation/FAQ.md
@@ -1,41 +1,47 @@
# FAQ
## I bought Flipper Zero and I don't know what I can do with it, pls help
-- Start with reading official main page: https://flipperzero.one/
-- Then check out official docs where you can find answers to most questions: https://docs.flipper.net/
+
+- Start with reading [official main page](https://flipperzero.one/)
+- Then check out official docs where you can find answers to [most questions](https://docs.flipper.net/)
## How do I install Unleashed firmware?
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/HowToInstall.md
-### What version I should install? What do letters `e`, `r`, `c`... mean?
-Follow this link for details:
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/CHANGELOG.md#recommended-update-option---web-updater
+See [this](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/HowToInstall.md)
+
+## What version I should install? What do letters `e`, `r`, `c`... mean?
+
+Follow this link for [details](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/CHANGELOG.md#recommended-update-option---web-updater).
+
+## INSTALLED UNLEASHED AND NOW BACKLIGHT DOESNT WORK?
-**INSTALLED UNLEASHED AND NOW BACKLIGHT DOESNT WORK?**
-You’ve installed a version made for custom RGB modded flippers. The version ending in `“r”` is specifically for “RGB” modded flippers.
-Please do not use that version if your flipper isn’t modded!
+You’ve installed a version made for custom RGB modded flippers. The version ending in `“r”` is specifically for “RGB” modded flippers.
+
+Please, do not use that version if your flipper isn’t modded!
## What apps (plugins) are included with Unleashed FW?
-See default pack and extra pack (for `e` build) list here:
-https://github.com/xMasterX/all-the-plugins/tree/dev
+
+See default pack and extra pack (for `e` build) list [here](https://github.com/xMasterX/all-the-plugins/tree/dev).
+
## Where I can find differences between original (official) firmware and Unleashed firmware?
-Right here:
-https://github.com/DarkFlippers/unleashed-firmware#whats-changed
+
+[Right here](https://github.com/DarkFlippers/unleashed-firmware#whats-changed)
## How to use SubGHz Remote app?
+
1. Open app, press Back button, select New map file
2. Configure signal files and their names for every button (also you can add only one signal and make other buttons empty - just don't select any files for them in config)
3. Save new map file
4. Open map file and select your previously created file
5. Use buttons to send subghz signal files that you selected in map config at step 2
-
## How to build (compile) firmware?
-Follow this link:
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/HowToBuild.md#how-to-build-by-yourself
+
+Follow this [link](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/HowToBuild.md#how-to-build-by-yourself).
## I installed Unleashed firmware and now my mobile app doesn't connect to flipper ( OR I changed flipper device name and my mobile app now doesn't connect to flipper )
+
1. Click Forget flipper in mobile app
2. Open your phone settings - bluetooth, find flipper - if it present here - open its options and click forget device
3. On flipper itself open Settings -> Bluetooth -> Forget all devices -> and confirm
@@ -43,173 +49,185 @@ https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/HowToB
5. Done
## My desktop (pin, favourites, etc..) (or other) settings was reset to default after update, what to do?
+
Just configure that settings again, all is fine, and make sure you seen changelogs for the releases that came out after your previous version, when settings struct is changed, settings file are reset after update, this happens only when struct changes is required, so don't assume that settings will be reset in every release, this will happen only in specific ones
-## Why is flipper not connecting to chrome?
-The most common cause of the flipper not connecting to google chrome is having qFlipper open while trying to connect your flipper. Or having second flipper lab page open at same time.
+## Why is flipper not connecting to Chrome?
+
+The most common cause of the flipper not connecting to google chrome is having qFlipper open while trying to connect your flipper.
+
+Or having second flipper lab page open at same time.
You must close qFlipper (or other flipper lab web pages) before attempting to connect your flipper to chrome.
## Flipper doesn't work! How to restore firmware???
-Follow this guide:
-https://docs.flipper.net/basics/firmware-update/firmware-recovery
+Follow this [guide](https://docs.flipper.net/basics/firmware-update/firmware-recovery)
## Useful links and files
-Flipper Awesome - place where you can find almost all links that you might need:
-https://github.com/djsime1/awesome-flipperzero
-
-Dict files for iButton Fuzzer and RFID Fuzzer:
-https://t.me/flipperzero_unofficial_ru/37058
-https://t.me/flipperzero_unofficial_ru/37072
-UL Releases in Telegram:
-https://t.me/unleashed_fw
-UL Dev Builds in Telegram:
-https://t.me/kotnehleb
-
-Our Discord:
-https://discord.unleashedflip.com
+Flipper Awesome - place where you can find almost all links that you might need:
+* [Awesome-FlipperZero](https://github.com/djsime1/awesome-flipperzero)
+* Dict files for iButton Fuzzer and RFID Fuzzer:
+https://t.me/flipperzero_unofficial_ru/37058
+https://t.me/flipperzero_unofficial_ru/37072
+* UL Releases in [Telegram](https://t.me/unleashed_fw)
+* UL Dev Builds in [Telegram](https://t.me/kotnehleb)
+* Our [Discord](https://discord.unleashedflip.com)
## How to change flipper name?
+
All is simple:
-1. Open Settings -> Desktop -> Change Flipper Name
+1. Open `Settings -> Desktop -> Change Flipper Name`
2. Enter new name and click Save
3. Exit from settings - Flipper will automatically reboot
4. Done, you have custom name which will stay until you reset it to default or replace with new one
-How to reset name to default:
-1. Open Settings -> Desktop -> Change Flipper Name
+## How to reset name to default?
+
+1. Open `Settings -> Desktop -> Change Flipper Name`
2. Do not enter anything, just click Save
3. Exit from settings - Flipper will automatically reboot
4. Done, name is reset to original one.
-## How do I copy files from Github to my Flipper Zero?
-Follow this detailed guide:
-https://github.com/wrenchathome/flipperfiles/blob/main/_Guides/How2Flipper.pdf
+## How do I copy files from GitHub to my Flipper Zero?
+Follow this detailed [guide](https://github.com/wrenchathome/flipperfiles/blob/main/_Guides/How2Flipper.pdf).
## Where can I find “This file” or “That file” for my flipper?
-These 2 repos will cover most(99.9%) of your needs:
-https://github.com/UberGuidoZ/Flipper/tree/main
-
-https://github.com/UberGuidoZ/Flipper-IRDB/tree/main
+These 2 repos will cover most (99.9%) of your needs:
+* https://github.com/UberGuidoZ/Flipper/tree/main
+* https://github.com/UberGuidoZ/Flipper-IRDB/tree/main
## How can I support Unleashed firmware project?
-https://github.com/DarkFlippers/unleashed-firmware#please-support-development-of-the-project
+
+Please follow this [link](https://github.com/DarkFlippers/unleashed-firmware#please-support-development-of-the-project).
## What are the dev builds? Where I can get latest build for dev branch?
-This is an automatic assembly of the latest commits from the repository that have not yet been released, the previous build is deleted when a new one is uploaded and old remains only as file in the telegram channel
-Be aware that this is not release ready builds! They may have bugs and issues, if you are using dev build and found issue, report it! In github issues
-
-Dev builds is available in Discord, in channel - `unleashed-development`
-Builds also can be found here - https://t.me/kotnehleb
-And here - https://dev.unleashedflip.com/
+This is an automatic assembly of the latest commits from the repository that have not yet been released, the previous build is deleted when a new one is uploaded and old remains only as file in the telegram channel
+Be aware that this is not release ready builds! They may have bugs and issues, if you are using dev build and found issue, report it! In GitHub issues
+
+
+Dev builds is available in Discord, Win channel - `unleashed-development`
+Builds also can be found [here](https://t.me/kotnehleb).
+And [here](https://dev.unleashedflip.com/)
## What is the update server?
-We have our own update server https://up.unleashedflip.com/directory.json
-It is identical to the official one, it is impossible to change it in applications without rebuilding the application, it is hardcoded there
-If you want to use it, you need to patch or build your own build of the application you are interested in
-Also you can use it with uFBT to build apps for UL SDK, uFBT will accept that link as one of args
+We have our own update server https://up.unleashedflip.com/directory.json
+It is identical to the official one, it is impossible to change it in applications without rebuilding the application, it is hardcoded there
+If you want to use it, you need to patch or build your own build of the application you are interested in
+
+Also you can use it with uFBT to build apps for UL SDK, uFBT will accept that link as one of args
The server will remain active and will be automatically updated
## External Radio: How to connect CC1101 module
-https://github.com/quen0n/flipperzero-ext-cc1101
+
+[Guide](https://github.com/quen0n/flipperzero-ext-cc1101)
## How to add extra Sub-GHz frequencies
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/SubGHzSettings.md
+
+[Guide](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/SubGHzSettings.md)
## How to use Flipper as new remote (Nice FlorS, BFT Mitto, Somfy Telis, Aprimatic, AN-Motors, etc..)
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/SubGHzRemoteProg.md
+
+[Guide](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/SubGHzRemoteProg.md)
## How Can I Unlock/Remove SubGHz restriction?
+
If you are using Unleashed firmware - **all region locks are removed by default**!
-Also there is a way to go outside of frequencies stated in CC1101 datasheet, but transmission on those frequencies may cause chip damage, make sure you know what you are doing! Do not edit this settings to bypass region lock since there is no region locks in unleashed, all chip supported frequencies will work without any extra steps.
-But, if you know that you need to bypass subghz chip safety restriction you can unlock the safety restriction which will allow you to go outside the chips supported frequency.
-This covers how to do it and information regarding the risks of damage to the flipper by doing so
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/DangerousSettings.md
+Also, there is a way to go outside of frequencies stated in CC1101 datasheet, but transmission on those frequencies may cause chip damage, make sure you know what you are doing! Do not edit this settings to bypass region lock since there is no region locks in unleashed, all chip supported frequencies will work without any extra steps.
+But, if you know that you need to bypass subghz chip safety restriction you can unlock the safety restriction which will allow you to go outside the chips supported frequency.
+This covers how to do it and information regarding the risks of damage to the flipper by doing so. Please read [this](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/DangerousSettings.md) before.
## Can I clone a car key fob for my own car to use flipper as a key?
+
No, and trying to do so with Read RAW will lead to key desync or unpair with blacklist which means re-pair is very hard and requires service tools
## Will Unleashed FW support car keyfobs decoding, cloning, emulating?
+
No, never
## Where can I find jamming files?
+
Nowhere, this is illegal in almost every country in the world
-## I saw something on tiktok and want to ask how to do it, I just wanna be like real hacker
-And you might be banned for that in our communities, since 99% of that content is fake, or showing illegal actions, and we don't like tiktok related questions
+## I saw something on TikTok and want to ask how to do it, I just wanna be like real hacker
+
+And you might be banned for that in our communities, since 99% of that content is fake, or showing illegal actions, and we don't like TikTok related questions.
+
+## I was banned in Unleashed Discord/Telegram/etc.. How to remove ban? I created GitHub issue and it was removed too!
-## I was banned in Unleashed Discord/Telegram/etc.. How to remove ban? I created github issue and it was removed too!
Not possible, rules is rules, read them before sending messages in our communities
## How to clean .DS_Store and other dot files left from macOS
+
`sudo dot_clean -mn /Volumes/Flipper\ SD` -> `Flipper\ SD` may be named differently for you, replace with your microSD card name
-## How to sort files on flipper microSD on macOS/Linux
-`will make sorting faster, and will work for OFW`
-1. `brew install fatsort` -> Install fatsort using brew.sh (only on macOS)
+## How to sort files on flipper microSD on macOS/Linux?
+
+Will make sorting faster, and will work for OFW
+1. `brew install fatsort` -> Install fatsort using `brew.sh` (only on macOS)
2. `diskutil list` -> Find your disk name for flipper microSD
3. `diskutil unmount /Volumes/Flipper\ SD`
4. `sudo fatsort -n /dev/disk4s1` -> Replace `disk4s1` with your microSD id found on step 2
-
## Your Flipper feels slow and unresponsive?
-1. Make sure you using good microSD card from known brand, flipper works with microSD via SPI that means not any microSD will work good even if it works ok with other devices
+
+1. Make sure you using good microSD card from known brand, flipper works with microSD via SPI that means not any microSD will work good even if it works ok with other devices.
2. Go into **Settings -> System** and make sure that you have
-`Log Level = None`
-`Debug = OFF`
-`Heap Trace = None`
-If some of that settings is set to something different - change it to `None` / `OFF`
-3. Make sure your battery is charged, that can affect performance too
+ ```text
+ Log Level = None
+ Debug = OFF
+ Heap Trace = None
+ ```
+3. If some of that settings is set to something different - change it to `None` / `OFF`
+4. Make sure your battery is charged, that can affect performance too
+
+## Flipper crashed, stuck, frozen?
-## Flipper crashed, stuck, frozen ?
Reboot it by holding Left + Back buttons
-
## How to reset forgotten Flipper pin code?
**Disconnect USB Cable if it was connected**
1. Turn off the device - hold back button -> Turn Off
**If you can't turn it off, try next step but hold buttons for 30-40 seconds)**
-2. Hold Up + Back for ~5 sec -> You will see reset screen -> Hold Right to reset (and down arrow to exit if you don't want to reset pin code)
+2. Hold `Up` + `Back` for `~5 sec` -> You will see reset screen -> Hold `Right` to reset (and `Down` arrow to exit if you don't want to reset pin code)
3. Done, internal memory (dolphin level, settings, pin code, is erased to default settings)
## What are the differences between x, y and z firmware?
-If you just got your flipper and not sure what will work better for you, start with original official firmware, if you think you need more features or want to remove subghz region locks then
-Try installing Unleashed firmware, which is fork of official firmware with many new features and preinstalled plugins (check out `e` build)
-In other case If you want to experiment more with UI and other things look for existing forks of Unleashed firmware
-Or create your own fork with your own customisations
-Also before reporting any found issue make sure you are in correct repo, if you are using not Unleashed but different fork or original firmware, do not report issue in Unleashed firmware repo or UL communities (telegram, discord, etc..)
+If you just got your flipper and not sure what will work better for you, start with original official firmware, if you think you need more features or want to remove subghz region locks then:
+* Try installing **Unleashed firmware**, which is fork of official firmware with many new features and preinstalled plugins (check out `e` build).
+* In other case, If you want to experiment more with UI and other things look for existing forks of Unleashed firmware.
+* Or, create your own fork with your own customisations
+* Also, before reporting any found issue make sure you are in correct repo, if you are using not **Unleashed**, but different fork or original firmware, do not report issue in **Unleashed firmware** repo or UL communities (Telegram, Discord, etc..)
## Is there a correct way to capturing Infrared signals?
There is indeed especially with AC units, a new documentation has been released with some notes and steps on capturing infrared signals correctly along with some example data so you are able to understand the difference visually between the two.
-https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/InfraredCaptures.md
+[More info](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/InfraredCaptures.md)
+## NFC / RFID FAQ
-# NFC/RFID FAQ
-From our good friend `@Equip` and `@np0`
-**------------------------------------------------------**
+From our good friend `@Equip` and `@np0`
### MIFARE Ultralight
-- Scan the card, hold the Flipper Zero up to the reader to get the password to unlock the rest of the sectors, then scan the card again.
+Scan the card, hold the Flipper Zero up to the reader to get the password to unlock the rest of the sectors, then scan the card again.
-### MIFARE DESFire/MIFARE Ultralight C
+### MIFARE DESFire / MIFARE Ultralight C
-- The Flipper Zero has no available attacks for this card currently.
+The Flipper Zero has no available attacks for this card currently.
### Bank cards
@@ -224,17 +242,17 @@ From our good friend `@Equip` and `@np0`
### HID/iClass
-- Picopass iClass can be read using the Picopass reader plugin
+- `Picopass` iClass can be read using the `Picopass` reader plugin
- 26bit Picopass can be downgraded to H10301 RFID credentials (note, it is not guaranteed to work if the reader is not configured to read low frequency)
- Readers will need to be configured and have an LF RFID antenna in order to be read. Certain iClass readers are HF only, and do not have the ability to have LF configured
-- **Emulation for Picopass** was added on July 26th, and the updated version can be found in latest releases of Unleashed firmware with apps preinstalled, or in official Apps Hub via Flipper Mobile app
+- **Emulation for Picopass** was added on July 26th, and the updated version can be found in latest releases of **Unleashed** firmware with apps preinstalled, or in official Apps Hub via Flipper Mobile app
- Write support for personalization mode cards is doable with app
-- The Seader app and a SAM expansion board < https://www.redteamtools.com/nard-sam-expansion-board-for-flipper-zero-with-hid-seos-iclass-sam/ > will allow reading more secure HID cards, which may be helpful in downgrade attacks
+- The Seader app and a [SAM expansion board](https://www.redteamtools.com/nard-sam-expansion-board-for-flipper-zero-with-hid-seos-iclass-sam/) will allow reading more secure HID cards, which may be helpful in downgrade attacks
### LF-RFID
-If you're wanting to make clones of low frequency RFID chips you need to write to T5577's. "Blanks" do not exist. All of the chips the Flipper Zero can interact with are read-only and cannot be overwritten or purchased blank.
-T5577s are multiemulator chips that the Flipper Zero can program to be other tags
+If you're wanting to make clones of low frequency RFID chips you need to write to T5577's. `Blanks` do not exist. All of the chips the Flipper Zero can interact with are read-only and cannot be overwritten or purchased blank.
+T5577s are multi-emulator chips that the Flipper Zero can program to be other tags
### Unknown Card/Fob
@@ -244,11 +262,11 @@ If you have exhausted all options of scanning via NFC/RFID/PICOPASS then take a
- The reader you use with the credential
- If your credential is a card, hold it up to a very bright light source e.g. a lightbulb and take a photo of the exposed antenna. This is useful for identification, post it for us to identify!
-**------------------------------------------------------**
-
## How do I access the CLI/Logs?
+
+To access the Serial CLI, click one of the following based on your platform.
+
- To access the Serial CLI, click one of the following based on your platform.
Desktop web browser**Chromium browsers only, such as: Google Chrome, Microsoft Edge, Opera/Opera GX, Brave, and Vivaldi.
@@ -262,6 +280,8 @@ If you have exhausted all options of scanning via NFC/RFID/PICOPASS then take a
Done!
+
+
Windows
@@ -280,6 +300,8 @@ If you have exhausted all options of scanning via NFC/RFID/PICOPASS then take a
If you get an "Access Denied" error, make sure qFlipper isn't running!
+
+
MacOS/LinuxNote: I'm a filthy Windows user without any way to verify this procedure. Let me know if it's wrong!
@@ -295,6 +317,8 @@ If you have exhausted all options of scanning via NFC/RFID/PICOPASS then take a
Done!
+
+
Android
@@ -308,16 +332,20 @@ If you have exhausted all options of scanning via NFC/RFID/PICOPASS then take a
Note: To exit log mode, you'll have to disconnect and reconnect using the icon.
+
+
iPhone
- Unfortunately, iOS is incapable of accessing a serial terminal over USB; try one of the other methods.
-
- On the Flipper, open the settings, go to System, and set Log Level to Debug. (You can keep Debug set to off unless someone asks you to turn it on)
- Once you have the CLI open, type log and press enter to start watching logs. Press Ctrl-C or Cmd-C to exit log mode.
+ Unfortunately, iOS is incapable of accessing a serial terminal over USB; try one of the other methods
+
+
On the Flipper, open the settings, go to System, and set Log Level to Debug. (You can keep Debug set to off unless someone asks you to turn it on)
+
Once you have the CLI open, type log and press enter to start watching logs. Press Ctrl-C or Cmd-C to exit log mode.
+
+
-
-
+
+
-**CLI FAQ Source + Check out this FAQ for more info:**
+**CLI FAQ Source + Check out this FAQ for more info:**
https://github.com/djsime1/awesome-flipperzero/blob/main/FAQ.md
diff --git a/documentation/FuriHalBus.md b/documentation/FuriHalBus.md
index 12c5a70ece..248699d778 100644
--- a/documentation/FuriHalBus.md
+++ b/documentation/FuriHalBus.md
@@ -3,15 +3,19 @@
## Basic info
On system startup, most of the peripheral devices are under reset and not clocked by default. This is done to reduce power consumption and to guarantee that the device will always be in the same state before use.
+
Some crucial peripherals are enabled right away by the system, others must be explicitly enabled by the user code.
-**NOTE:** Here and afterwards the word *"system"* refers to any code belonging to the operating system, hardware drivers or built-in applications.
+> [!NOTE] Here and afterwards the word `system` refers to any code belonging to the operating system,
+> hardware drivers or built-in applications.
-To **ENABLE** a peripheral, call `furi_hal_bus_enable()`. At the time of the call, the peripheral in question MUST be disabled, otherwise a crash will occur to indicate improper use. This means that any given peripheral cannot be enabled twice or more without disabling it first.
+To **ENABLE** a peripheral, call `furi_hal_bus_enable()`. At the time of the call, the peripheral in question **MUST** be disabled;
+otherwise a crash will occur to indicate improper use. This means that any given peripheral cannot be enabled twice or more without disabling it first.
-To **DISABLE** a peripheral, call `furi_hal_bus_disable()`. Likewise, the peripheral in question MUST be enabled, otherwise a crash will occur.
+To **DISABLE** a peripheral, call `furi_hal_bus_disable()`. Likewise, the peripheral in question **MUST** be enabled, otherwise a crash will occur.
-To **RESET** a peripheral, call `furi_hal_bus_reset()`. The peripheral in question MUST be enabled, otherwise a crash will occur. This method is used whenever it is necessary to reset all the peripheral's registers to their initial states without disabling it.
+To **RESET** a peripheral, call `furi_hal_bus_reset()`. The peripheral in question MUST be enabled, otherwise a crash will occur.
+This method is used whenever it is necessary to reset all the peripheral's registers to their initial states without disabling it.
## Peripherals
@@ -22,26 +26,28 @@ Built-in peripherals are divided into three categories:
### Always-on peripherals
-Below is the list of peripherals that are enabled by the system. The user code must NEVER attempt to disable them. If a corresponding API is provided, the user code must employ it in order to access the peripheral.
+Below is the list of peripherals that are enabled by the system. The user code must **NEVER** attempt to disable them.
+
+If a corresponding API is provided, the user code must employ it in order to access the peripheral.
*Table 1* - Peripherals enabled by the system
-| Peripheral | Enabled at |
-| :-----------: | :-----------------------: |
-| DMA1 | `furi_hal_dma.c` |
-| DMA2 | -- |
-| DMAMUX | -- |
-| GPIOA | `furi_hal_resources.c` |
-| GPIOB | -- |
-| GPIOC | -- |
-| GPIOD | -- |
-| GPIOE | -- |
-| GPIOH | -- |
-| PKA | `furi_hal_bt.c` |
-| AES2 | -- |
-| HSEM | -- |
-| IPCC | -- |
-| FLASH | enabled by hardware |
+| Peripheral | Enabled at |
+|:-------------:|:---------------------------:|
+| DMA1 | `furi_hal_dma.c` |
+| DMA2 | -- |
+| DMAMUX | -- |
+| GPIOA | `furi_hal_resources.c` |
+| GPIOB | -- |
+| GPIOC | -- |
+| GPIOD | -- |
+| GPIOE | -- |
+| GPIOH | -- |
+| PKA | `furi_hal_bt.c` |
+| AES2 | -- |
+| HSEM | -- |
+| IPCC | -- |
+| FLASH | enabled by hardware |
### On-demand system peripherals
@@ -51,63 +57,64 @@ When not using the API, these peripherals MUST be enabled by the user code and t
*Table 2* - Peripherals enabled and disabled by the system
-| Peripheral | API header file |
-| :-----------: | :-------------------: |
-| RNG | `furi_hal_random.h` |
-| SPI1 | `furi_hal_spi.h` |
-| SPI2 | -- |
-| I2C1 | `furi_hal_i2c.h` |
-| I2C3 | -- |
-| USART1 | `furi_hal_serial.h` |
-| LPUART1 | -- |
-| USB | `furi_hal_usb.h` |
+| Peripheral | API header file |
+|:--------------:|:------------------------:|
+| RNG | `furi_hal_random.h` |
+| SPI1 | `furi_hal_spi.h` |
+| SPI2 | -- |
+| I2C1 | `furi_hal_i2c.h` |
+| I2C3 | -- |
+| USART1 | `furi_hal_serial.h` |
+| LPUART1 | -- |
+| USB | `furi_hal_usb.h` |
### On-demand shared peripherals
-Below is the list of peripherals that are not enabled by default and MUST be enabled by the user code each time it accesses them.
+Below is the list of peripherals that are not enabled by default and **MUST** be enabled by the user code each time it accesses them.
Note that some of these peripherals may also be used by the system to implement its certain features.
+
The system will take over any given peripheral only when the respective feature is in use.
*Table 3* - Peripherals enabled and disabled by user
-| Peripheral | System | Purpose |
-| :-----------: | :-------: | ------------------------------------- |
-| CRC | | |
-| TSC | | |
-| ADC | | |
-| QUADSPI | | |
-| TIM1 | yes | subghz, lfrfid, nfc, infrared, etc... |
-| TIM2 | yes | subghz, infrared, etc... |
-| TIM16 | yes | speaker |
-| TIM17 | yes | cc1101_ext |
-| LPTIM1 | yes | tickless idle timer |
-| LPTIM2 | yes | pwm |
-| SAI1 | | |
-| LCD | | |
-
+| Peripheral | System | Purpose |
+|:----------:|:------:|:----------------------------------------|
+| CRC | | |
+| TSC | | |
+| ADC | | |
+| QUADSPI | | |
+| TIM1 | yes | subghz, lfrfid, nfc, infrared, etc... |
+| TIM2 | yes | subghz, infrared, etc... |
+| TIM16 | yes | speaker |
+| TIM17 | yes | cc1101_ext |
+| LPTIM1 | yes | tickless idle timer |
+| LPTIM2 | yes | pwm |
+| SAI1 | | |
+| LCD | | |
## DMA
-The DMA1,2 peripherals are a special case in that they have multiple independent channels. Some of the channels may be in use by the system.
+The `DMA1`, `DMA2` peripherals are a special case in that they have multiple independent channels.
+Some channels may be in use by the system.
Below is the list of DMA channels and their usage by the system.
*Table 4* - DMA channels
-| DMA | Channel | System | Purpose |
-| :---: | :-------: | :-------: | ------------------------- |
-| DMA1 | 1 | yes | digital signal |
-| -- | 2 | yes | -- |
-| -- | 3 | | |
-| -- | 4 | yes | pulse reader |
-| -- | 5 | | |
-| -- | 6 | yes | USART_Rx |
-| -- | 7 | yes | LPUART_Rx |
-| DMA2 | 1 | yes | infrared, lfrfid, subghz, |
-| -- | 2 | yes | -- |
-| -- | 3 | yes | cc1101_ext |
-| -- | 4 | yes | cc1101_ext |
-| -- | 5 | yes | cc1101_ext |
-| -- | 6 | yes | SPI |
-| -- | 7 | yes | SPI |
+| DMA | Channel | System | Purpose |
+|:------:|:-------:|:------:|:-----------------------------|
+| DMA1 | 1 | yes | digital signal |
+| -- | 2 | yes | -- |
+| -- | 3 | | |
+| -- | 4 | yes | pulse reader |
+| -- | 5 | | |
+| -- | 6 | yes | USART_Rx |
+| -- | 7 | yes | LPUART_Rx |
+| DMA2 | 1 | yes | infrared, lfrfid, subghz, |
+| -- | 2 | yes | -- |
+| -- | 3 | yes | cc1101_ext |
+| -- | 4 | yes | cc1101_ext |
+| -- | 5 | yes | cc1101_ext |
+| -- | 6 | yes | SPI |
+| -- | 7 | yes | SPI |
diff --git a/documentation/HowToBuild.md b/documentation/HowToBuild.md
index ddf759f1b8..eec2e632a9 100644
--- a/documentation/HowToBuild.md
+++ b/documentation/HowToBuild.md
@@ -1,4 +1,3 @@
-
# How to Build by yourself:
## Install required software
@@ -15,9 +14,10 @@ You should clone with
```shell
$ git clone --recursive https://github.com/DarkFlippers/unleashed-firmware.git
```
+
## VSCode integration
-`fbt` includes basic development environment configuration for VS Code. Run `./fbt vscode_dist` to deploy it. That will copy the initial environment configuration to the `.vscode` folder. After that, you can use that configuration by starting VS Code and choosing the firmware root folder in the "File > Open Folder" menu.
+`fbt` includes basic development environment configuration for VSCode. Run `./fbt vscode_dist` to deploy it. That will copy the initial environment configuration to the `.vscode` folder. After that, you can use that configuration by starting VSCode and choosing the firmware root folder in the `File > Open Folder` menu.
# Build on Linux/macOS
@@ -31,7 +31,6 @@ Check out `documentation/fbt.md` for details on building and flashing firmware.
### Compile everything for development
-
```sh
./fbt updater_package
```
@@ -44,8 +43,7 @@ Check out `documentation/fbt.md` for details on building and flashing firmware.
Check `dist/` for build outputs.
-Use **`flipper-z-{target}-update-{suffix}.tgz`** to flash your device.
-
+Use `flipper-z-{target}-update-{suffix}.tgz` to flash your device.
# Build on Windows
@@ -53,23 +51,20 @@ Check out `documentation/fbt.md` for details on building and flashing firmware.
### Compile everything for development
-
-```sh
+```powershell
./fbt.cmd updater_package
```
### Compile everything for release + get updater package to update from microSD card
-```sh
+```powershell
./fbt.cmd COMPACT=1 DEBUG=0 updater_package
```
-**You may need to change** `/` **to** `\` **in front of fbt command (Only for Windows)!**
+**You may need to change `/` to `\` in front of fbt command (Only for Windows)!**
Check `dist/` for build outputs.
-Use **`flipper-z-{target}-update-{suffix}.tgz`** to flash your device.
-
-
+Use `flipper-z-{target}-update-{suffix}.tgz` to flash your device.
If compilation fails, make sure all submodules are all initialized. Either clone with `--recursive` or use `git submodule update --init --recursive`.
diff --git a/documentation/devboard/Firmware update on Developer Board.md b/documentation/devboard/Firmware update on Developer Board.md
index f6a81d97b6..1cd205023d 100644
--- a/documentation/devboard/Firmware update on Developer Board.md
+++ b/documentation/devboard/Firmware update on Developer Board.md
@@ -1,10 +1,13 @@
# Firmware update on Developer Board {#dev_board_fw_update}
-It's important to regularly update your Developer Board to ensure that you have access to the latest features and bug fixes. This tutorial will guide you through the necessary steps to update the firmware of your Developer Board.
+> [!IMPORTANT]
+>
+> It's important to regularly update your Developer Board to ensure that you have access to the latest features and bug fixes.
+> This tutorial will guide you through the necessary steps to update the firmware of your Developer Board.
-This tutorial assumes that you're familiar with the basics of the command line. If you’re not, please refer to the [Windows](https://www.digitalcitizen.life/command-prompt-how-use-basic-commands/) or [MacOS/Linux](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview) command line tutorials.
+This tutorial assumes that you're familiar with the basics of the command line.
-***
+If you’re not, please refer to the [Windows](https://www.digitalcitizen.life/command-prompt-how-use-basic-commands/) or [MacOS / Linux](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview) command line tutorials.
## Installing the micro Flipper Build Tool
@@ -14,20 +17,18 @@ Install uFBT on your computer by running the following command in the Terminal:
**For Linux & macOS:**
-```text
+```bash
python3 -m pip install --upgrade ufbt
```
**For Windows:**
-```text
-py -m pip install --upgrade ufbt
+```powershell
+python -m pip install --upgrade ufbt
```
If you want to learn more about uFBT, visit [the project's page](https://pypi.org/project/ufbt/).
-***
-
## Connecting the Developer Board to your computer
1. List all of the serial devices on your computer.
@@ -38,49 +39,38 @@ If you want to learn more about uFBT, visit [the project's page](https://pypi.or
**macOS**
- On macOS, you can run the following command in the Terminal:
-
- ```text
+ On macOS, you can run the following command in the Terminal:
+ ```bash
ls /dev/cu.*
```
**Linux**
- On Linux, you can run the following command in the Terminal:
-
+ On Linux, you can run the following command in the Terminal:
```text
ls /dev/tty*
```
-
View the devices in the list.
-
2. Connect the Developer Board to your computer using a USB-C cable.
-
3. Switch your Developer Board to Bootloader mode:
-
3.1. Press and hold the **BOOT** button.
-
3.2. Press the **RESET** button while holding the **BOOT** button.
-
- 3.3. Release the **BOOT** button.\
+ 3.3. Release the **BOOT** button.
-
4. Repeat Step 1 and view the name of your Developer Board that appeared in the list.
For example, on macOS:
- ```text
+ ```shell
/dev/cu.usbmodem01
```
-***
-
## Flashing the firmware
To flash the firmware onto your Developer Board, run the following command in the terminal:
-```text
+```shell
python3 -m ufbt devboard_flash
```
@@ -90,33 +80,26 @@ You should see the following message: `WiFi board flashed successfully`.
If you get an error message during the flashing process, such as this:
-```text
+```shell
A fatal error occurred: Serial data stream stopped: Possible serial noise or corruption.
```
Or this:
-```text
+```shell
FileNotFoundError: [Errno 2] No such file or directory: '/dev/cu.usbmodem01'
```
Try doing the following:
-
* Disconnect the Developer Board from your computer, then reconnect it.
-
* Use a different USB port on your computer.
-
* Use a different USB-C cable.
-***
-
## Finishing the installation
After flashing the firmware:
-
1. Reboot the Developer Board by pressing the **RESET** button.
-
2. Disconnect and reconnect the USB-C cable.
The Developer Board should appear as a serial device on your computer. Now, you can use it with the Black Magic Debug client of your choice.
diff --git a/documentation/devboard/Get started with the Dev Board.md b/documentation/devboard/Get started with the Dev Board.md
index 04fa9d3589..8747d126ee 100644
--- a/documentation/devboard/Get started with the Dev Board.md
+++ b/documentation/devboard/Get started with the Dev Board.md
@@ -2,35 +2,33 @@
The Wi-Fi Developer Board serves as a tool to debug the Flipper Zero firmware. To debug the firmware, the initial step involves compiling the firmware from its source code. This process enables the debugging functionality within the firmware and generates all the necessary files required for debugging purposes.
-> **NOTE:** Building and debugging the Flipper Zero firmware is fully supported on MacOS and Linux. Support for Windows is in beta test.
-
-***
+> [!IMPORTANT]
+> Building and debugging the Flipper Zero firmware is fully supported on MacOS and Linux.
+> Support for Windows is in beta test.
## Updating the firmware of your Developer Board
Update the firmware of your Developer Board before using it. For more information, visit [Firmware update on Developer Board](https://docs.flipperzero.one/development/hardware/wifi-debugger-module/update).
-***
-
## Installing Git
You'll need Git installed on your computer to clone the firmware repository. If you don't have Git, install it by doing the following:
-* **MacOS**
+### MacOS
- On MacOS, install the **Xcode Command Line Tools** package, which includes Git as one of the pre-installed command-line utilities, by running in the Terminal the following command:
+On MacOS, install the **Xcode Command Line Tools** package, which includes Git as one of the pre-installed command-line utilities, by running in the Terminal the following command:
- ```text
- xcode-select --install
- ```
+```bash
+xcode-select --install
+```
-* **Linux**
+### Linux
- On Linux, you can install Git using your package manager. For example, on Ubuntu, run in the Terminal the following command:
+On Linux, you can install Git using your package manager. For example, on Ubuntu, run in the Terminal the following command:
- ```text
- sudo apt install git
- ```
+```bash
+sudo apt install git
+```
For other distributions, refer to your package manager documentation.
@@ -40,14 +38,14 @@ For other distributions, refer to your package manager documentation.
First, clone the firmware repository:
-```text
+```bash
git clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git
cd flipperzero-firmware
```
Then, run the **Flipper Build Tool** (FBT) to build the firmware:
-```text
+```bash
./fbt
```
@@ -57,9 +55,10 @@ Then, run the **Flipper Build Tool** (FBT) to build the firmware:
The Developer Board can work in the **Wired** mode and two **Wireless** modes: **Wi-Fi access point (AP)** mode and **Wi-Fi client (STA)** mode. The Wired mode is the simplest to set up, but requires a USB Type-C cable. The Wireless modes are more complex to set up, but they allow you to debug your Flipper Zero wirelessly.
- > **NOTE:** Use the following credentials when connecting to the Developer Board in **Wi-Fi access point** mode:\n
- Name: **blackmagic**\n
- Password: **iamwitcher**
+> [!TIP]
+> Use the following credentials when connecting to the Developer Board in **Wi-Fi access point** mode:
+> Name: **blackmagic**
+> Password: **iamwitcher**
## Wired
@@ -71,27 +70,32 @@ To connect the Developer Board in **Wired** mode, do the following:
2. On your computer, open the **Terminal** and run the following:
- * **MacOS**
-
- ```text
- ls /dev/cu.*
- ```
-
- * **Linux**
-
- ```text
- ls /dev/tty*
- ```
-
- Note the list of devices.
+ ### MacOS
+
+ ```shell
+ ls /dev/cu.*
+ ```
+
+ ### Linux
+
+ ```bash
+ ls /dev/tty*
+ ```
+
+ Note the list of devices.
3. Connect the Developer Board to your computer via a USB-C cable.
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
- > **NOTE:** If the Developer Board doesn't appear in the list of devices, try using a different cable, USB port, or computer.
- >
- > **NOTE:** Flipper Zero logs can only be viewed when the Developer Board is connected via USB. The option to view logs over Wi-Fi will be added in future updates. For more information, visit [Reading logs via the Dev Board](https://docs.flipperzero.one/development/hardware/wifi-debugger-module/reading-logs).
+> [!NOTE]
+> If the Developer Board doesn't appear in the list of devices, try using a different cable, USB port, or computer.
+
+
+
+> [!IMPORTANT] Flipper Zero logs can only be viewed when the Developer Board is connected via USB.
+> The option to view logs over Wi-Fi will be added in future updates.
+> For more information, visit [Reading logs via the Dev Board](https://docs.flipperzero.one/development/hardware/wifi-debugger-module/reading-logs).
## Wireless
@@ -111,9 +115,8 @@ To connect the Developer Board in **Wi-Fi access point** mode, do the following:
3. Connect to the network:
- * Name: **blackmagic**
-
- * Password: **iamwitcher**
+ * Name: `blackmagic`
+ * Password: `iamwitcher`
4. To configure the Developer Board, open a browser and go to `http://192.168.4.1`.
@@ -135,9 +138,9 @@ To connect the Developer Board in **Wi-Fi client** mode, you need to configure i
-After rebooting, the Developer Board connects to your Wi-Fi network. You can connect to the device using the mDNS name **blackmagic.local** or the IP address it got from your router (you'll have to figure this out yourself, every router is different).
+After rebooting, the Developer Board connects to your Wi-Fi network. You can connect to the device using the mDNS name `blackmagic.local` or the IP address it got from your router (you'll have to figure this out yourself, every router is different).
-After connecting to your debugger via , you can find its IP address in the **SYS** tab. You can also change the debugger's mode to **AP** or **STA** there.
+After connecting to your debugger via [http://blackmagic.local](http://blackmagic.local), you can find its IP address in the **SYS** tab. You can also change the debugger's mode to **AP** or **STA** there.
@@ -145,9 +148,9 @@ After connecting to your debugger via , you can find it
## Debugging the firmware
-Open the **Terminal** in the **flipperzero-firmware** directory that you cloned earlier and run the following command:
+Open the **Terminal** in the `flipperzero-firmware` directory that you cloned earlier and run the following command:
-```text
+```bash
./fbt flash
```
@@ -155,11 +158,10 @@ This will upload the firmware you've just built to your Flipper Zero via the Dev
To debug in **VSCode**, do the following:
-1. In VSCode, open the **flipperzero-firmware** directory.
+1. In VSCode, open the `flipperzero-firmware` directory.
2. You should see a notification about recommended extensions. Install them.
-
- If there were no notifications, open the **Extensions** tab, enter `@recommended` in the search bar, and install the workspace recommendations.
+ > [!TIP] If there were no notifications, open the `Extensions` tab, enter `@recommended` in the search bar, and install the workspace recommendations.
3. In the **Terminal**, run the `./fbt vscode_dist` command. This will generate the VSCode configuration files needed for debugging.
diff --git a/documentation/devboard/Reading logs via the Dev Board.md b/documentation/devboard/Reading logs via the Dev Board.md
index e9fc0e2ca8..5cf35d99ee 100644
--- a/documentation/devboard/Reading logs via the Dev Board.md
+++ b/documentation/devboard/Reading logs via the Dev Board.md
@@ -2,13 +2,15 @@
The Developer Board allows you to read Flipper Zero logs via UART. Unlike reading logs via the command-line interface (CLI), the Developer Board enables you to collect logs from the device directly to a serial console independently from the operating system of Flipper Zero. It allows you to see the device's logs when it's loading, updating, or crashing. It's useful for debugging and troubleshooting during software development.
-> **NOTE:** Flipper Zero logs can only be viewed when the developer board is connected via USB. The option to view logs over Wi-Fi will be added in future updates.
+> [!NOTE]
+>
+> Flipper Zero logs can only be viewed when the developer board is connected via USB. The option to view logs over Wi-Fi will be added in future updates.
***
## Setting the log level
-Depending on your needs, you can set the log level by going to **Main Menu -> Settings -> Log Level**. To learn more about logging levels, visit [Settings](https://docs.flipperzero.one/basics/settings#d5TAt).
+Depending on your needs, you can set the log level by going to `Main Menu -> Settings -> Log Level`. To learn more about logging levels, visit [Settings](https://docs.flipperzero.one/basics/settings#d5TAt).
@@ -20,80 +22,74 @@ Depending on your operating system, you need to install an additional applicatio
### MacOS
-On MacOS, you need to install the **minicom** communication program by doing the following:
+On MacOS, you need to install the `minicom` communication program by doing the following:
1. [Install Homebrew](https://brew.sh/) by running the following command in the Terminal:
-
- ```text
- /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- ```
-
-2. After installation of Homebrew, run the following command to install minicom:
-
- ```text
+ ```bash
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+ ```
+2. After installation of Homebrew, run the following command to install `minicom`:
+ ```bash
brew install minicom
```
-After installation of minicom on your macOS computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:
+After installation of `minicom` on your macOS computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:
1. Cold-plug the Developer Board into your Flipper Zero by turning off the Flipper Zero, connecting the developer board, and then turning it back on.
-
2. On your computer, open the Terminal and run the following command:
- ```text
+ ```bash
ls /dev/cu.*
```
- Note the list of devices.
+ > [!NOTE] The list of devices.
3. Connect the developer board to your computer using a USB Type-C cable.
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
- ```text
+ ```bash
/dev/cu.usbmodemblackmagic1
```
- ```text
+ ```bash
/dev/cu.usbmodemblackmagic3
```
-
- Your Developer Board might have different names.
+ > [!NOTE] Your Developer Board might have different names.
5. Run the following command:
- ```text
- minicom -D /dev/ -b 230400
- ```
-
+ ```bash
+ minicom -D /dev/ -b 230400
+ ```
Where `` is the name of your device with a bigger number.
Example:
- ```text
+ ```bash
minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
```
6. View logs of your Flipper Zero in the Terminal.
-7. To quit, close the minicom window or quit via the minicom menu.
+7. To quit, close the `minicom` window or quit via the `minicom` menu.
### Linux
-On Linux, you need to install the **minicom** communication program. For example, on Ubuntu, run in the Terminal the following command:
+On Linux, you need to install the `minicom` communication program. For example, on Ubuntu, run in the Terminal the following command:
-```text
+```bash
sudo apt install minicom
- ```
+```
-After installation of minicom on your Linux computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:
+After installation of `minicom` on your Linux computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:
1. Cold-plug the Developer Board into your Flipper Zero by turning off the Flipper Zero, connecting the developer board, and then turning it back on.
2. On your computer, open the Terminal and run the following command:
- ```text
+ ```bash
ls /dev/tty*
```
@@ -104,19 +100,19 @@ After installation of minicom on your Linux computer, you can connect to the Dev
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
- ```text
+ ```bash
/dev/ttyACM0
```
- ```text
+ ```bash
/dev/ttyACM1
```
- Your Developer Board might have different names.
+ > [!NOTE] Your Developer Board might have different names.
5. Run the following command:
- ```text
+ ```bash
minicom -D /dev/ -b 230400
```
@@ -124,13 +120,13 @@ After installation of minicom on your Linux computer, you can connect to the Dev
Example:
- ```text
+ ```bash
minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
```
6. View logs of your Flipper Zero in the Terminal.
- **NOTE:** If no logs are shown in the Terminal, try running the command from Step 5 with another device name.
+ > [!NOTE] If no logs are shown in the Terminal, try running the command from Step 5 with another device name.
7. To quit, close the minicom window or quit via the minicom menu.
@@ -145,14 +141,14 @@ On Windows, do the following:
3. Connect the developer board to your computer using a USB Type-C cable.
-4. Find the serial port that the developer board is connected to by going to **Device Manager -> Ports (COM & LPT)** and looking for a new port that appears when you connect the Wi-Fi developer board.
+4. Find the serial port that the developer board is connected to by going to `Device Manager -> Ports (COM & LPT)` and looking for a new port that appears when you connect the Wi-Fi developer board.
-5. Run the PuTTY application and select **Serial** as the connection type.
+5. Run the `PuTTY` application and select `Serial` as the connection type.
-6. Enter the port number you found in the previous step into the **Serial line** field.
+6. Enter the port number you found in the previous step into the `Serial line` field.
-7. Set the **Speed** parameter to **230400** and click **Open**.
+7. Set the `Speed` parameter to `230400` and click `Open`.
8. View logs of your Flipper Zero in the PuTTY terminal window.
diff --git a/documentation/fbt.md b/documentation/fbt.md
index 8e083349f7..2538f23dc8 100644
--- a/documentation/fbt.md
+++ b/documentation/fbt.md
@@ -44,7 +44,7 @@ To run cleanup (think of `make clean`) for specified targets, add the `-c` optio
## VSCode integration
-`fbt` includes basic development environment configuration for VS Code. Run `./fbt vscode_dist` to deploy it. That will copy the initial environment configuration to the `.vscode` folder. After that, you can use that configuration by starting VS Code and choosing the firmware root folder in the "File > Open Folder" menu.
+`fbt` includes basic development environment configuration for VSCode. Run `./fbt vscode_dist` to deploy it. That will copy the initial environment configuration to the `.vscode` folder. After that, you can use that configuration by starting VSCode and choosing the firmware root folder in the "File > Open Folder" menu.
To use language servers other than the default VS Code C/C++ language server, use `./fbt vscode_dist LANG_SERVER=` instead. Currently `fbt` supports the default language server (`cpptools`) and `clangd`.
diff --git a/documentation/file_formats/BadUsbScriptFormat.md b/documentation/file_formats/BadUsbScriptFormat.md
index 1bac3c4aa4..8b0a449020 100644
--- a/documentation/file_formats/BadUsbScriptFormat.md
+++ b/documentation/file_formats/BadUsbScriptFormat.md
@@ -2,7 +2,10 @@
## Command syntax
-BadUsb app uses extended Duckyscript syntax. It is compatible with classic USB Rubber Ducky 1.0 scripts but provides some additional commands and features, such as custom USB ID, ALT+Numpad input method, SYSRQ command, and more functional keys.
+BadUsb app uses extended DuckyScript syntax.
+
+It is compatible with classic USB Rubber Ducky 1.0 scripts but provides some additional commands and features,
+such as custom USB ID, `ALT` + `Numpad` input method, `SYSRQ` command, and more functional keys.
## Script file format
@@ -12,168 +15,180 @@ BadUsb app can execute only text scripts from `.txt` files, no compilation is re
### Comment line
-Just a single comment line. The interpreter will ignore all text after the REM command.
-| Command | Parameters | Notes |
-| ------- | ------------ | ----- |
-| REM | Comment text | |
+Just a single comment line. The interpreter will ignore all text after the `REM` command.
+
+| Command | Parameters | Notes |
+|:---------|:--------------|:--------|
+| REM | Comment text | |
### Delay
Pause script execution by a defined time.
-| Command | Parameters | Notes |
-| ------------- | ----------------- | ----------------------------------- |
-| DELAY | Delay value in ms | Single delay |
-| DEFAULT_DELAY | Delay value in ms | Add delay before every next command |
-| DEFAULTDELAY | Delay value in ms | Same as DEFAULT_DELAY |
+
+| Command | Parameters | Notes |
+|:--------------|:--------------------------|:--------------------------------------|
+| DELAY | Delay value in ms | Single delay |
+| DEFAULT_DELAY | Delay value in ms | Add delay before every next command |
+| DEFAULTDELAY | Delay value in ms | Same as DEFAULT_DELAY |
### Special keys
-| Command | Notes |
-| ------------------ | ---------------- |
-| DOWNARROW / DOWN | |
-| LEFTARROW / LEFT | |
-| RIGHTARROW / RIGHT | |
-| UPARROW / UP | |
-| ENTER | |
-| DELETE | |
-| BACKSPACE | |
-| END | |
-| HOME | |
-| ESCAPE / ESC | |
-| INSERT | |
-| PAGEUP | |
-| PAGEDOWN | |
-| CAPSLOCK | |
-| NUMLOCK | |
-| SCROLLLOCK | |
-| PRINTSCREEN | |
-| BREAK | Pause/Break key |
-| PAUSE | Pause/Break key |
-| SPACE | |
-| TAB | |
-| MENU | Context menu key |
-| APP | Same as MENU |
-| Fx | F1-F12 keys |
+| Command | Notes |
+|:--------------------|:------------------|
+| DOWNARROW / DOWN | |
+| LEFTARROW / LEFT | |
+| RIGHTARROW / RIGHT | |
+| UPARROW / UP | |
+| ENTER | |
+| DELETE | |
+| BACKSPACE | |
+| END | |
+| HOME | |
+| ESCAPE / ESC | |
+| INSERT | |
+| PAGEUP | |
+| PAGEDOWN | |
+| CAPSLOCK | |
+| NUMLOCK | |
+| SCROLLLOCK | |
+| PRINTSCREEN | |
+| BREAK | Pause/Break key |
+| PAUSE | Pause/Break key |
+| SPACE | |
+| TAB | |
+| MENU | Context menu key |
+| APP | Same as MENU |
+| Fx | F1-F12 keys |
### Modifier keys
Can be combined with a special key command or a single character.
-| Command | Notes |
-| -------------- | ---------- |
-| CONTROL / CTRL | |
-| SHIFT | |
-| ALT | |
-| WINDOWS / GUI | |
-| CTRL-ALT | CTRL+ALT |
-| CTRL-SHIFT | CTRL+SHIFT |
-| ALT-SHIFT | ALT+SHIFT |
-| ALT-GUI | ALT+WIN |
-| GUI-SHIFT | WIN+SHIFT |
-| GUI-CTRL | WIN+CTRL |
+
+| Command | Notes |
+|:----------------|:-------------|
+| CONTROL / CTRL | |
+| SHIFT | |
+| ALT | |
+| WINDOWS / GUI | |
+| CTRL-ALT | CTRL+ALT |
+| CTRL-SHIFT | CTRL+SHIFT |
+| ALT-SHIFT | ALT+SHIFT |
+| ALT-GUI | ALT+WIN |
+| GUI-SHIFT | WIN+SHIFT |
+| GUI-CTRL | WIN+CTRL |
## Key hold and release
Up to 5 keys can be hold simultaneously.
-| Command | Parameters | Notes |
-| ------- | ------------------------------- | ---------------------------------------- |
-| HOLD | Special key or single character | Press and hold key until RELEASE command |
-| RELEASE | Special key or single character | Release key |
+
+| Command | Parameters | Notes |
+|:---------|:---------------------------------|:------------------------------------------|
+| HOLD | Special key or single character | Press and hold key until RELEASE command |
+| RELEASE | Special key or single character | Release key |
## String
-| Command | Parameters | Notes |
-| ------- | ----------- | ----------------- |
-| STRING | Text string | Print text string |
-| STRINGLN | Text string | Print text string and press enter after it |
+| Command | Parameters | Notes |
+|:----------|:-------------|:--------------------------------------------|
+| STRING | Text string | Print text string |
+| STRINGLN | Text string | Print text string and press enter after it |
## String delay
-Delay between keypresses.
-| Command | Parameters | Notes |
-| -------------------- | ----------------- | --------------------------------------------- |
-| STRING_DELAY | Delay value in ms | Applied once to next appearing STRING command |
-| STRINGDELAY | Delay value in ms | Same as STRING_DELAY |
-| DEFAULT_STRING_DELAY | Delay value in ms | Apply to every appearing STRING command |
-| DEFAULTSTRINGDELAY | Delay value in ms | Same as DEFAULT_STRING_DELAY |
+Delay between key presses.
+
+| Command | Parameters | Notes |
+|:----------------------|:-------------------|:-----------------------------------------------|
+| STRING_DELAY | Delay value in ms | Applied once to next appearing STRING command |
+| STRINGDELAY | Delay value in ms | Same as STRING_DELAY |
+| DEFAULT_STRING_DELAY | Delay value in ms | Apply to every appearing STRING command |
+| DEFAULTSTRINGDELAY | Delay value in ms | Same as DEFAULT_STRING_DELAY |
### Repeat
-| Command | Parameters | Notes |
-| ------- | ---------------------------- | ----------------------- |
-| REPEAT | Number of additional repeats | Repeat previous command |
+| Command | Parameters | Notes |
+|:---------|:------------------------------|:-------------------------|
+| REPEAT | Number of additional repeats | Repeat previous command |
### ALT+Numpad input
On Windows and some Linux systems, you can print characters by holding `ALT` key and entering its code on Numpad.
| Command | Parameters | Notes |
-| --------- | -------------- | --------------------------------------------------------------- |
+| :---------- | :--------------- | :--------------------------------------------------------------- |
| ALTCHAR | Character code | Print single character |
| ALTSTRING | Text string | Print text string using ALT+Numpad method |
-| ALTCODE | Text string | Same as ALTSTRING, presents in some Duckyscript implementations |
+| ALTCODE | Text string | Same as ALTSTRING, presents in some DuckyScript implementations |
### SysRq
Send [SysRq command](https://en.wikipedia.org/wiki/Magic_SysRq_key)
-| Command | Parameters | Notes |
-| ------- | ---------------- | ----- |
-| SYSRQ | Single character | |
+
+| Command | Parameters | Notes |
+|:---------|:------------------|:-------|
+| SYSRQ | Single character | |
## Media keys
-Some Media/Consumer Control keys can be pressed with "MEDIA" command
-
-| Command | Parameters | Notes |
-| ------- | ------------------------- | ----- |
-| MEDIA | Media key, see list below | |
-
-| Key name | Notes |
-| ----------------- | ----------------------------- |
-| POWER | |
-| REBOOT | |
-| SLEEP | |
-| LOGOFF | |
-| EXIT | |
-| HOME | |
-| BACK | |
-| FORWARD | |
-| REFRESH | |
-| SNAPSHOT | Take photo in a camera app |
-| PLAY | |
-| PAUSE | |
-| PLAY_PAUSE | |
-| NEXT_TRACK | |
-| PREV_TRACK | |
-| STOP | |
-| EJECT | |
-| MUTE | |
-| VOLUME_UP | |
-| VOLUME_DOWN | |
-| FN | Fn/Globe key on Mac keyboard |
-| BRIGHT_UP | Increase display brightness |
-| BRIGHT_DOWN | Decrease display brightness |
+Some Media/Consumer Control keys can be pressed with `MEDIA` command
+
+| Command | Parameters | Notes |
+|:---------|:---------------------------|:------|
+| MEDIA | Media key, see list below | |
+
+
+| Key name | Notes |
+|:-------------------|:-------------------------------|
+| POWER | |
+| REBOOT | |
+| SLEEP | |
+| LOGOFF | |
+| EXIT | |
+| HOME | |
+| BACK | |
+| FORWARD | |
+| REFRESH | |
+| SNAPSHOT | Take photo in a camera app |
+| PLAY | |
+| PAUSE | |
+| PLAY_PAUSE | |
+| NEXT_TRACK | |
+| PREV_TRACK | |
+| STOP | |
+| EJECT | |
+| MUTE | |
+| VOLUME_UP | |
+| VOLUME_DOWN | |
+| FN | Fn/Globe key on Mac keyboard |
+| BRIGHT_UP | Increase display brightness |
+| BRIGHT_DOWN | Decrease display brightness |
## Fn/Globe key commands (Mac/iPad)
-| Command | Parameters | Notes |
-| ------- | ------------------------------- | ----- |
-| GLOBE | Special key or single character | |
+| Command | Parameters | Notes |
+|:---------|:---------------------------------|:-------|
+| GLOBE | Special key or single character | |
## Wait for button press
Will wait indefinitely for a button to be pressed
-| Command | Parameters | Notes |
-| --------------------- | ------------ | --------------------------------------------------------------------- |
-| WAIT_FOR_BUTTON_PRESS | None | Will wait for the user to press a button to continue script execution |
+
+| Command | Parameters | Notes |
+|:----------------------|:-----------|:------------------------------------------------------------------------------|
+| WAIT_FOR_BUTTON_PRESS | None | Will wait for the user to press a button to continue script execution |
## USB device ID
You can set the custom ID of the Flipper USB HID device. ID command should be in the **first line** of script, it is executed before script run.
-| Command | Parameters | Notes |
-| ------- | ---------------------------- | ----- |
-| ID | VID:PID Manufacturer:Product | |
+| Command | Parameters | Notes |
+|:---------|:------------------------------|:-------|
+| ID | VID:PID Manufacturer:Product | |
Example:
-`ID 1234:abcd Flipper Devices:Flipper Zero`
+```text
+ID 1234:abcd Flipper Devices:Flipper Zero
+```
-VID and PID are hex codes and are mandatory. Manufacturer and Product are text strings and are optional.
+> [!ATTENTION]
+> VID and PID are hex codes and are mandatory.
+> Manufacturer and Product are text strings and are optional.
From 4b4e9cab8bccbe640f7f2c5dda0c7ff45555f083 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 18:47:36 +0400
Subject: [PATCH 04/52] Update Get started with the Dev Board.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
.../Get started with the Dev Board.md | 38 ++++++++-----------
1 file changed, 16 insertions(+), 22 deletions(-)
diff --git a/documentation/devboard/Get started with the Dev Board.md b/documentation/devboard/Get started with the Dev Board.md
index 8747d126ee..4a895f9993 100644
--- a/documentation/devboard/Get started with the Dev Board.md
+++ b/documentation/devboard/Get started with the Dev Board.md
@@ -2,7 +2,8 @@
The Wi-Fi Developer Board serves as a tool to debug the Flipper Zero firmware. To debug the firmware, the initial step involves compiling the firmware from its source code. This process enables the debugging functionality within the firmware and generates all the necessary files required for debugging purposes.
-> [!IMPORTANT]
+> [!IMPORTANT]
+>
> Building and debugging the Flipper Zero firmware is fully supported on MacOS and Linux.
> Support for Windows is in beta test.
@@ -55,7 +56,8 @@ Then, run the **Flipper Build Tool** (FBT) to build the firmware:
The Developer Board can work in the **Wired** mode and two **Wireless** modes: **Wi-Fi access point (AP)** mode and **Wi-Fi client (STA)** mode. The Wired mode is the simplest to set up, but requires a USB Type-C cable. The Wireless modes are more complex to set up, but they allow you to debug your Flipper Zero wirelessly.
-> [!TIP]
+> [!TIP]
+>
> Use the following credentials when connecting to the Developer Board in **Wi-Fi access point** mode:
> Name: **blackmagic**
> Password: **iamwitcher**
@@ -88,12 +90,15 @@ To connect the Developer Board in **Wired** mode, do the following:
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
-> [!NOTE]
+> [!NOTE]
+>
> If the Developer Board doesn't appear in the list of devices, try using a different cable, USB port, or computer.
-> [!IMPORTANT] Flipper Zero logs can only be viewed when the Developer Board is connected via USB.
+> [!IMPORTANT]
+>
+> Flipper Zero logs can only be viewed when the Developer Board is connected via USB.
> The option to view logs over Wi-Fi will be added in future updates.
> For more information, visit [Reading logs via the Dev Board](https://docs.flipperzero.one/development/hardware/wifi-debugger-module/reading-logs).
@@ -110,14 +115,10 @@ Out of the box, the Developer Board is configured to work as a **Wi-Fi access po
To connect the Developer Board in **Wi-Fi access point** mode, do the following:
1. Cold-plug the Developer Board by turning off your Flipper Zero and connecting the Developer Board, and then turning it back on.
-
2. Open Wi-Fi settings on your client device (phone, laptop, or other).
-
3. Connect to the network:
-
* Name: `blackmagic`
* Password: `iamwitcher`
-
4. To configure the Developer Board, open a browser and go to `http://192.168.4.1`.
### Wi-Fi client (STA) mode
@@ -127,13 +128,9 @@ To connect the Developer Board in **Wi-Fi access point** mode, do the following:
To connect the Developer Board in **Wi-Fi client** mode, you need to configure it to connect to your Wi-Fi network by doing the following:
1. Cold-plug the Developer Board by turning off your Flipper Zero and connecting the Developer Board, and then turning it back on.
-
2. Connect to the Developer Board in **Wi-Fi access point** mode.
-
3. In a browser, go to the configuration page on `http://192.168.4.1`.
-
4. Select the **STA** mode and enter your network's **SSID** (name) and **password**. For convenience, you can click the **+** button to see the list of nearby networks.
-
5. Save the configuration and reboot the Developer Board.
@@ -144,8 +141,6 @@ After connecting to your debugger via [http://blackmagic.local](http://blackmagi
-***
-
## Debugging the firmware
Open the **Terminal** in the `flipperzero-firmware` directory that you cloned earlier and run the following command:
@@ -159,16 +154,16 @@ This will upload the firmware you've just built to your Flipper Zero via the Dev
To debug in **VSCode**, do the following:
1. In VSCode, open the `flipperzero-firmware` directory.
-
2. You should see a notification about recommended extensions. Install them.
- > [!TIP] If there were no notifications, open the `Extensions` tab, enter `@recommended` in the search bar, and install the workspace recommendations.
-
+> [!TIP]
+>
+> If there were no notifications, open the `Extensions` tab,
+> enter `@recommended` in the search bar,
+> and install the workspace recommendations.
+>
3. In the **Terminal**, run the `./fbt vscode_dist` command. This will generate the VSCode configuration files needed for debugging.
-
4. In VSCode, open the **Run and Debug** tab and select **Attach FW (blackmagic)** from the dropdown menu.
-
5. If needed, flash your Flipper Zero with the `./fbt flash` command, then click the **Play** button in the debug sidebar to start the debugging session.
-
6. Note that starting a debug session halts the execution of the firmware, so you'll need to click the **Continue** button on the toolbar at the top of your VSCode window to continue execution.
@@ -176,5 +171,4 @@ To debug in **VSCode**, do the following:
To learn about debugging, visit the following pages:
* [Debugging with GDB](https://sourceware.org/gdb/current/onlinedocs/gdb.pdf)
-
-* [Debugging in VS Code](https://code.visualstudio.com/docs/editor/debugging)
+* [Debugging in VSCode](https://code.visualstudio.com/docs/editor/debugging)
From 5d82ecfed528784ff63643c33632d8936612c569 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:00:38 +0400
Subject: [PATCH 05/52] Update Get started with the Dev Board.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
.../devboard/Get started with the Dev Board.md | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/documentation/devboard/Get started with the Dev Board.md b/documentation/devboard/Get started with the Dev Board.md
index 4a895f9993..a6fe301783 100644
--- a/documentation/devboard/Get started with the Dev Board.md
+++ b/documentation/devboard/Get started with the Dev Board.md
@@ -64,7 +64,7 @@ The Developer Board can work in the **Wired** mode and two **Wireless** modes: *
## Wired
-
+
To connect the Developer Board in **Wired** mode, do the following:
@@ -106,11 +106,11 @@ To connect the Developer Board in **Wired** mode, do the following:
### Wi-Fi access point (AP) mode
-
+
Out of the box, the Developer Board is configured to work as a **Wi-Fi access point**. This means it'll create its own Wi-Fi network to which you can connect. If your Developer Board doesn't create a Wi-Fi network, it is probably configured to work in **Wi-Fi client** mode. To reset your Developer Board back to **Wi-Fi access point** mode, press and hold the **BOOT** button for 10 seconds, then wait for the module to reboot.
-
+
To connect the Developer Board in **Wi-Fi access point** mode, do the following:
@@ -123,7 +123,7 @@ To connect the Developer Board in **Wi-Fi access point** mode, do the following:
### Wi-Fi client (STA) mode
-
+
To connect the Developer Board in **Wi-Fi client** mode, you need to configure it to connect to your Wi-Fi network by doing the following:
@@ -133,13 +133,13 @@ To connect the Developer Board in **Wi-Fi client** mode, you need to configure i
4. Select the **STA** mode and enter your network's **SSID** (name) and **password**. For convenience, you can click the **+** button to see the list of nearby networks.
5. Save the configuration and reboot the Developer Board.
-
+![In the Wi-Fi tab, you can set the Developer Board mode]](https://github.com/user-attachments/assets/fbeea000-1117-4297-8a0d-5d580123e938)
After rebooting, the Developer Board connects to your Wi-Fi network. You can connect to the device using the mDNS name `blackmagic.local` or the IP address it got from your router (you'll have to figure this out yourself, every router is different).
After connecting to your debugger via [http://blackmagic.local](http://blackmagic.local), you can find its IP address in the **SYS** tab. You can also change the debugger's mode to **AP** or **STA** there.
-
+
## Debugging the firmware
@@ -166,7 +166,7 @@ To debug in **VSCode**, do the following:
5. If needed, flash your Flipper Zero with the `./fbt flash` command, then click the **Play** button in the debug sidebar to start the debugging session.
6. Note that starting a debug session halts the execution of the firmware, so you'll need to click the **Continue** button on the toolbar at the top of your VSCode window to continue execution.
-
+
To learn about debugging, visit the following pages:
From a1f961ea2a5fbfb0f38970f911a705abd75ea733 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:01:47 +0400
Subject: [PATCH 06/52] Update Get started with the Dev Board.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
documentation/devboard/Get started with the Dev Board.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/documentation/devboard/Get started with the Dev Board.md b/documentation/devboard/Get started with the Dev Board.md
index a6fe301783..a679ccb11e 100644
--- a/documentation/devboard/Get started with the Dev Board.md
+++ b/documentation/devboard/Get started with the Dev Board.md
@@ -132,8 +132,9 @@ To connect the Developer Board in **Wi-Fi client** mode, you need to configure i
3. In a browser, go to the configuration page on `http://192.168.4.1`.
4. Select the **STA** mode and enter your network's **SSID** (name) and **password**. For convenience, you can click the **+** button to see the list of nearby networks.
5. Save the configuration and reboot the Developer Board.
+6. In the Wi-Fi tab, you can set the Developer Board mode
-![In the Wi-Fi tab, you can set the Developer Board mode]](https://github.com/user-attachments/assets/fbeea000-1117-4297-8a0d-5d580123e938)
+
After rebooting, the Developer Board connects to your Wi-Fi network. You can connect to the device using the mDNS name `blackmagic.local` or the IP address it got from your router (you'll have to figure this out yourself, every router is different).
From 6947efae2749788523d6cce9355d739d1c953c99 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:05:14 +0400
Subject: [PATCH 07/52] Update Firmware update on Developer Board.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
.../devboard/Firmware update on Developer Board.md | 13 ++++++-------
1 file changed, 6 insertions(+), 7 deletions(-)
diff --git a/documentation/devboard/Firmware update on Developer Board.md b/documentation/devboard/Firmware update on Developer Board.md
index 1cd205023d..0df5c1f7de 100644
--- a/documentation/devboard/Firmware update on Developer Board.md
+++ b/documentation/devboard/Firmware update on Developer Board.md
@@ -52,13 +52,13 @@ If you want to learn more about uFBT, visit [the project's page](https://pypi.or
```
View the devices in the list.
2. Connect the Developer Board to your computer using a USB-C cable.
-
-3. Switch your Developer Board to Bootloader mode:
+
+4. Switch your Developer Board to Bootloader mode:
3.1. Press and hold the **BOOT** button.
3.2. Press the **RESET** button while holding the **BOOT** button.
3.3. Release the **BOOT** button.
-
-4. Repeat Step 1 and view the name of your Developer Board that appeared in the list.
+ 
+6. Repeat Step 1 and view the name of your Developer Board that appeared in the list.
For example, on macOS:
@@ -98,8 +98,7 @@ Try doing the following:
## Finishing the installation
After flashing the firmware:
-1. Reboot the Developer Board by pressing the **RESET** button.
-
-2. Disconnect and reconnect the USB-C cable.
+1. Reboot the Developer Board by pressing the **RESET** button. 
+3. Disconnect and reconnect the USB-C cable.
The Developer Board should appear as a serial device on your computer. Now, you can use it with the Black Magic Debug client of your choice.
From 63351f3fb6d69b5f8ee86eb5b247bf21085a82a9 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:12:40 +0400
Subject: [PATCH 08/52] Update Reading logs via the Dev Board.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
.../Reading logs via the Dev Board.md | 91 +++++++------------
1 file changed, 31 insertions(+), 60 deletions(-)
diff --git a/documentation/devboard/Reading logs via the Dev Board.md b/documentation/devboard/Reading logs via the Dev Board.md
index 5cf35d99ee..41461b1cdc 100644
--- a/documentation/devboard/Reading logs via the Dev Board.md
+++ b/documentation/devboard/Reading logs via the Dev Board.md
@@ -4,17 +4,14 @@ The Developer Board allows you to read Flipper Zero logs via UART. Unlike readin
> [!NOTE]
>
-> Flipper Zero logs can only be viewed when the developer board is connected via USB. The option to view logs over Wi-Fi will be added in future updates.
-
-***
+> Flipper Zero logs can only be viewed when the developer board is connected via USB.
+> The option to view logs over Wi-Fi will be added in future updates.
## Setting the log level
Depending on your needs, you can set the log level by going to `Main Menu -> Settings -> Log Level`. To learn more about logging levels, visit [Settings](https://docs.flipperzero.one/basics/settings#d5TAt).
-
-
-***
+
## Viewing Flipper Zero logs
@@ -37,43 +34,35 @@ After installation of `minicom` on your macOS computer, you can connect to the D
1. Cold-plug the Developer Board into your Flipper Zero by turning off the Flipper Zero, connecting the developer board, and then turning it back on.
2. On your computer, open the Terminal and run the following command:
-
```bash
ls /dev/cu.*
```
-
- > [!NOTE] The list of devices.
-
+> [!NOTE]
+>
+> The list of devices.
3. Connect the developer board to your computer using a USB Type-C cable.
-
-
-4. Rerun the command. Two new devices have to appear: this is the Developer Board.
-
+ 
+5. Rerun the command. Two new devices have to appear: this is the Developer Board.
```bash
/dev/cu.usbmodemblackmagic1
```
-
```bash
/dev/cu.usbmodemblackmagic3
```
- > [!NOTE] Your Developer Board might have different names.
-
-5. Run the following command:
-
+> [!NOTE]
+>
+> Your Developer Board might have different names.
+6. Run the following command:
```bash
minicom -D /dev/ -b 230400
```
Where `` is the name of your device with a bigger number.
-
Example:
-
```bash
minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
```
-
-6. View logs of your Flipper Zero in the Terminal.
-
-7. To quit, close the `minicom` window or quit via the `minicom` menu.
+7. View logs of your Flipper Zero in the Terminal.
+8. To quit, close the `minicom` window or quit via the `minicom` menu.
### Linux
@@ -86,48 +75,38 @@ On Linux, you need to install the `minicom` communication program. For example,
After installation of `minicom` on your Linux computer, you can connect to the Developer Board to read Flipper Zero logs by doing the following:
1. Cold-plug the Developer Board into your Flipper Zero by turning off the Flipper Zero, connecting the developer board, and then turning it back on.
-
2. On your computer, open the Terminal and run the following command:
-
```bash
ls /dev/tty*
```
-
Note the list of devices.
-
3. Connect the developer board to your computer using a USB Type-C cable.
-
-
+ 
4. Rerun the command. Two new devices have to appear: this is the Developer Board.
-
```bash
/dev/ttyACM0
```
-
```bash
/dev/ttyACM1
```
-
- > [!NOTE] Your Developer Board might have different names.
-
+> [!NOTE]
+>
+> Your Developer Board might have different names.
5. Run the following command:
-
```bash
minicom -D /dev/ -b 230400
```
-
Where `` is the name of your device with a bigger number.
-
Example:
-
```bash
minicom -D /dev/cu.usbmodemblackmagic3 -b 230400
```
-
6. View logs of your Flipper Zero in the Terminal.
-
- > [!NOTE] If no logs are shown in the Terminal, try running the command from Step 5 with another device name.
-
+> [!NOTE]
+>
+> If no logs are shown in the Terminal,
+> try running the command from Step 5 with another device name.
+>
7. To quit, close the minicom window or quit via the minicom menu.
### Windows
@@ -135,22 +114,14 @@ After installation of `minicom` on your Linux computer, you can connect to the D
On Windows, do the following:
1. On your computer, [install the PuTTY application](https://www.chiark.greenend.org.uk/\~sgtatham/putty/latest.html).
-
2. Cold-plug the Developer Board into your Flipper Zero by turning off the Flipper Zero, connecting the developer board, and then turning it back on.
-
3. Connect the developer board to your computer using a USB Type-C cable.
-
-
+ 
4. Find the serial port that the developer board is connected to by going to `Device Manager -> Ports (COM & LPT)` and looking for a new port that appears when you connect the Wi-Fi developer board.
-
-
-5. Run the `PuTTY` application and select `Serial` as the connection type.
-
-6. Enter the port number you found in the previous step into the `Serial line` field.
-
-7. Set the `Speed` parameter to `230400` and click `Open`.
-
-
-8. View logs of your Flipper Zero in the PuTTY terminal window.
-
-9. To quit, close the PuTTY window.
+ 
+6. Run the `PuTTY` application and select `Serial` as the connection type.
+7. Enter the port number you found in the previous step into the `Serial line` field.
+8. Set the `Speed` parameter to `230400` and click `Open`.
+ 
+10. View logs of your Flipper Zero in the PuTTY terminal window.
+11. To quit, close the PuTTY window.
From f8ad2b556b5a7c8b97a85fb6e9e5356aa5aea4a9 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:13:47 +0400
Subject: [PATCH 09/52] Update BadUsbScriptFormat.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
documentation/file_formats/BadUsbScriptFormat.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/documentation/file_formats/BadUsbScriptFormat.md b/documentation/file_formats/BadUsbScriptFormat.md
index 8b0a449020..0b8381c1e8 100644
--- a/documentation/file_formats/BadUsbScriptFormat.md
+++ b/documentation/file_formats/BadUsbScriptFormat.md
@@ -189,6 +189,7 @@ Example:
ID 1234:abcd Flipper Devices:Flipper Zero
```
-> [!ATTENTION]
+> [!IMPORTANT]
+>
> VID and PID are hex codes and are mandatory.
> Manufacturer and Product are text strings and are optional.
From 0286a336a1ae66d3741a51098e4907efa2af51e6 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:32:38 +0400
Subject: [PATCH 10/52] Update FAQ.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
documentation/FAQ.md | 82 +++++++++++++++++++++++++-------------------
1 file changed, 47 insertions(+), 35 deletions(-)
diff --git a/documentation/FAQ.md b/documentation/FAQ.md
index 96b11aca53..67581999e3 100644
--- a/documentation/FAQ.md
+++ b/documentation/FAQ.md
@@ -15,7 +15,7 @@ Follow this link for [details](https://github.com/DarkFlippers/unleashed-firmwar
## INSTALLED UNLEASHED AND NOW BACKLIGHT DOESNT WORK?
-You’ve installed a version made for custom RGB modded flippers. The version ending in `“r”` is specifically for “RGB” modded flippers.
+You’ve installed a version made for custom RGB modded flippers. The version ending in `r` is specifically for `RGB` modded flippers.
Please, do not use that version if your flipper isn’t modded!
@@ -23,14 +23,13 @@ Please, do not use that version if your flipper isn’t modded!
See default pack and extra pack (for `e` build) list [here](https://github.com/xMasterX/all-the-plugins/tree/dev).
-
## Where I can find differences between original (official) firmware and Unleashed firmware?
[Right here](https://github.com/DarkFlippers/unleashed-firmware#whats-changed)
## How to use SubGHz Remote app?
-1. Open app, press Back button, select New map file
+1. Open app, press `Back` button, select `New map file`
2. Configure signal files and their names for every button (also you can add only one signal and make other buttons empty - just don't select any files for them in config)
3. Save new map file
4. Open map file and select your previously created file
@@ -43,9 +42,9 @@ Follow this [link](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/d
## I installed Unleashed firmware and now my mobile app doesn't connect to flipper ( OR I changed flipper device name and my mobile app now doesn't connect to flipper )
1. Click Forget flipper in mobile app
- 2. Open your phone settings - bluetooth, find flipper - if it present here - open its options and click forget device
- 3. On flipper itself open Settings -> Bluetooth -> Forget all devices -> and confirm
- 4. Make sure your flipper has bluetooth ON and open Mobile app and pair it to flipper
+ 2. Open your `phone settings - bluetooth`, find flipper - if it present here - open its options and click forget device
+ 3. On flipper itself open `Settings -> Bluetooth -> Forget all devices` and confirm
+ 4. Make sure your flipper has bluetooth `ON` and open Mobile app and pair it to flipper
5. Done
## My desktop (pin, favourites, etc..) (or other) settings was reset to default after update, what to do?
@@ -58,20 +57,19 @@ The most common cause of the flipper not connecting to google chrome is having q
Or having second flipper lab page open at same time.
-You must close qFlipper (or other flipper lab web pages) before attempting to connect your flipper to chrome.
+You must close qFlipper (or other flipper lab web pages) before attempting to connect your flipper to Chrome.
## Flipper doesn't work! How to restore firmware???
Follow this [guide](https://docs.flipper.net/basics/firmware-update/firmware-recovery)
-
## Useful links and files
Flipper Awesome - place where you can find almost all links that you might need:
* [Awesome-FlipperZero](https://github.com/djsime1/awesome-flipperzero)
* Dict files for iButton Fuzzer and RFID Fuzzer:
-https://t.me/flipperzero_unofficial_ru/37058
-https://t.me/flipperzero_unofficial_ru/37072
+ * https://t.me/flipperzero_unofficial_ru/37058
+ * https://t.me/flipperzero_unofficial_ru/37072
* UL Releases in [Telegram](https://t.me/unleashed_fw)
* UL Dev Builds in [Telegram](https://t.me/kotnehleb)
* Our [Discord](https://discord.unleashedflip.com)
@@ -80,7 +78,7 @@ https://t.me/flipperzero_unofficial_ru/37072
All is simple:
1. Open `Settings -> Desktop -> Change Flipper Name`
-2. Enter new name and click Save
+2. Enter new name and click `Save`
3. Exit from settings - Flipper will automatically reboot
4. Done, you have custom name which will stay until you reset it to default or replace with new one
@@ -107,9 +105,15 @@ Please follow this [link](https://github.com/DarkFlippers/unleashed-firmware#ple
## What are the dev builds? Where I can get latest build for dev branch?
-This is an automatic assembly of the latest commits from the repository that have not yet been released, the previous build is deleted when a new one is uploaded and old remains only as file in the telegram channel
-Be aware that this is not release ready builds! They may have bugs and issues, if you are using dev build and found issue, report it! In GitHub issues
-
+This is an automatic assembly of the latest commits from the repository that have not yet been released, the previous build is deleted when a new one is uploaded and old remains only as file in the telegram channel
+
+> [!CAUTION]
+>
+> Be aware that this is not release ready builds!
+>
+> They may have bugs and issues,
+> if you are using dev build and found issue,
+> report it! In [GitHub issues](https://github.com/DarkFlippers/unleashed-firmware/issues)
Dev builds is available in Discord, Win channel - `unleashed-development`
Builds also can be found [here](https://t.me/kotnehleb).
@@ -137,13 +141,20 @@ The server will remain active and will be automatically updated
[Guide](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/SubGHzRemoteProg.md)
-## How Can I Unlock/Remove SubGHz restriction?
+## How Can I Unlock / Remove SubGHz restriction?
-If you are using Unleashed firmware - **all region locks are removed by default**!
+> [!TIP]
+>
+> If you are using Unleashed firmware - **all region locks are removed by default**!
+
+Also, there is a way to go outside of frequencies stated in `CC1101 datasheet`, but transmission on those frequencies may cause chip damage, make sure you know what you are doing!
+
+Do not edit this settings to bypass region lock since there is no region locks in unleashed, all chip supported frequencies will work without any extra steps.
-Also, there is a way to go outside of frequencies stated in CC1101 datasheet, but transmission on those frequencies may cause chip damage, make sure you know what you are doing! Do not edit this settings to bypass region lock since there is no region locks in unleashed, all chip supported frequencies will work without any extra steps.
But, if you know that you need to bypass subghz chip safety restriction you can unlock the safety restriction which will allow you to go outside the chips supported frequency.
-This covers how to do it and information regarding the risks of damage to the flipper by doing so. Please read [this](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/DangerousSettings.md) before.
+This covers how to do it and information regarding the risks of damage to the flipper by doing so.
+
+Please read [this](https://github.com/DarkFlippers/unleashed-firmware/blob/dev/documentation/DangerousSettings.md) before.
## Can I clone a car key fob for my own car to use flipper as a key?
@@ -161,7 +172,7 @@ Nowhere, this is illegal in almost every country in the world
And you might be banned for that in our communities, since 99% of that content is fake, or showing illegal actions, and we don't like TikTok related questions.
-## I was banned in Unleashed Discord/Telegram/etc.. How to remove ban? I created GitHub issue and it was removed too!
+## I was banned in Unleashed Discord / Telegram / etc.. How to remove ban? I created GitHub issue and it was removed too!
Not possible, rules is rules, read them before sending messages in our communities
@@ -169,7 +180,7 @@ Not possible, rules is rules, read them before sending messages in our communiti
`sudo dot_clean -mn /Volumes/Flipper\ SD` -> `Flipper\ SD` may be named differently for you, replace with your microSD card name
-## How to sort files on flipper microSD on macOS/Linux?
+## How to sort files on flipper microSD on macOS / Linux?
Will make sorting faster, and will work for OFW
1. `brew install fatsort` -> Install fatsort using `brew.sh` (only on macOS)
@@ -180,7 +191,7 @@ Will make sorting faster, and will work for OFW
## Your Flipper feels slow and unresponsive?
1. Make sure you using good microSD card from known brand, flipper works with microSD via SPI that means not any microSD will work good even if it works ok with other devices.
-2. Go into **Settings -> System** and make sure that you have
+2. Go into `Settings -> System` and make sure that you have
```text
Log Level = None
Debug = OFF
@@ -191,16 +202,16 @@ Will make sorting faster, and will work for OFW
## Flipper crashed, stuck, frozen?
-Reboot it by holding Left + Back buttons
+Reboot it by holding `Left` + `Back` buttons
## How to reset forgotten Flipper pin code?
**Disconnect USB Cable if it was connected**
-1. Turn off the device - hold back button -> Turn Off
+1. Turn off the device - hold back button -> `Turn Off`
**If you can't turn it off, try next step but hold buttons for 30-40 seconds)**
-2. Hold `Up` + `Back` for `~5 sec` -> You will see reset screen -> Hold `Right` to reset (and `Down` arrow to exit if you don't want to reset pin code)
+2. Hold Up + Back for `~5 sec` -> You will see reset screen -> Hold Right to reset (and Down arrow to exit if you don't want to reset pin code)
3. Done, internal memory (dolphin level, settings, pin code, is erased to default settings)
## What are the differences between x, y and z firmware?
@@ -237,10 +248,10 @@ The Flipper Zero has no available attacks for this card currently.
### Amiibos
-- NTAG215. that's it. It's not going on a MIFARE Classic.
+- `NTAG215`. That's it. It's not going on a MIFARE Classic.
- Currently, you cannot write Amiibos to new physical tags. yet.
-### HID/iClass
+### HID / iClass
- `Picopass` iClass can be read using the `Picopass` reader plugin
- 26bit Picopass can be downgraded to H10301 RFID credentials (note, it is not guaranteed to work if the reader is not configured to read low frequency)
@@ -252,29 +263,30 @@ The Flipper Zero has no available attacks for this card currently.
### LF-RFID
If you're wanting to make clones of low frequency RFID chips you need to write to T5577's. `Blanks` do not exist. All of the chips the Flipper Zero can interact with are read-only and cannot be overwritten or purchased blank.
+
T5577s are multi-emulator chips that the Flipper Zero can program to be other tags
-### Unknown Card/Fob
+### Unknown Card / Fob
-If you have exhausted all options of scanning via NFC/RFID/PICOPASS then take a photo of:
+If you have exhausted all options of scanning via NFC / RFID / PICOPASS then take a photo of:
- The front and back of your credential
- The reader you use with the credential
- If your credential is a card, hold it up to a very bright light source e.g. a lightbulb and take a photo of the exposed antenna. This is useful for identification, post it for us to identify!
-## How do I access the CLI/Logs?
+## How do I access the CLI / Logs?
To access the Serial CLI, click one of the following based on your platform.
Desktop web browser*
- *Chromium browsers only, such as: Google Chrome, Microsoft Edge, Opera/Opera GX, Brave, and Vivaldi.
+ *Chromium browsers only, such as: Google Chrome, Microsoft Edge, Opera / Opera GX, Brave, and Vivaldi.
Connect your Flipper via USB.
Ensure qFlipper and any other serial terminals are closed.
Open my.flipp.dev in one of the aforementioned browsers.
-
Click CONNECT and select "USB Serial Device" from the list.
+
Click CONNECT and select USB Serial Device from the list.
Wait until you can see your device details on screen.
Select the 💻 CLI item from the left sidebar.
Done!
@@ -287,12 +299,12 @@ To access the Serial CLI, click one of the following based on your platform.
Open qFlipper and look for the COM port next to the Flipper's name. (Should say COM followed by a number, like COM1)
+
Open qFlipper and look for the COM port next to the Flipper's name. (Should say COM followed by a number, like COM1)
Take note of the COM port number.
CLOSE qFlipper, otherwise the next steps won't work.
Open PuTTY and ensure you're on the Session screen.
-
Select "Serial" under connection type.
-
Set serial line to the COM port. (Just COM followed by the number, like COM1)
+
Select Serial under connection type.
+
Set serial line to the COM port. (Just COM followed by the number, like COM1)
Set speed to 115200
Optional: Save the session settings for easy connection later.
Finally, click Open to enter the CLI.
@@ -339,7 +351,7 @@ To access the Serial CLI, click one of the following based on your platform.
Unfortunately, iOS is incapable of accessing a serial terminal over USB; try one of the other methods
On the Flipper, open the settings, go to System, and set Log Level to Debug. (You can keep Debug set to off unless someone asks you to turn it on)
-
Once you have the CLI open, type log and press enter to start watching logs. Press Ctrl-C or Cmd-C to exit log mode.
+
Once you have the CLI open, type log and press enter to start watching logs. Press Ctrl-C or Cmd-C to exit log mode.
From 012796d113356401a6e409f701a90b12eefa7e65 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:33:22 +0400
Subject: [PATCH 11/52] Update FuriHalBus.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
documentation/FuriHalBus.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/documentation/FuriHalBus.md b/documentation/FuriHalBus.md
index 248699d778..7077e3abf0 100644
--- a/documentation/FuriHalBus.md
+++ b/documentation/FuriHalBus.md
@@ -6,7 +6,9 @@ On system startup, most of the peripheral devices are under reset and not clocke
Some crucial peripherals are enabled right away by the system, others must be explicitly enabled by the user code.
-> [!NOTE] Here and afterwards the word `system` refers to any code belonging to the operating system,
+> [!NOTE]
+>
+> Here and afterwards the word `system` refers to any code belonging to the operating system,
> hardware drivers or built-in applications.
To **ENABLE** a peripheral, call `furi_hal_bus_enable()`. At the time of the call, the peripheral in question **MUST** be disabled;
From 74527d97b9dbf4722fafbc5feb45521a9e00d975 Mon Sep 17 00:00:00 2001
From: DerSkythe <31771569+derskythe@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:40:28 +0400
Subject: [PATCH 12/52] Update fbt.md
Signed-off-by: DerSkythe <31771569+derskythe@users.noreply.github.com>
---
documentation/fbt.md | 69 +++++++++++++++++++++++++++++++-------------
1 file changed, 49 insertions(+), 20 deletions(-)
diff --git a/documentation/fbt.md b/documentation/fbt.md
index 2538f23dc8..a8759f8eb2 100644
--- a/documentation/fbt.md
+++ b/documentation/fbt.md
@@ -9,24 +9,35 @@ If you don't need all features of `fbt` - like building the whole firmware - and
To use `fbt`, you only need `git` installed in your system.
-`fbt` by default downloads and unpacks a pre-built toolchain, and then modifies environment variables for itself to use it. It does not contaminate your global system's path with the toolchain.
- > However, if you wish to use tools supplied with the toolchain outside `fbt`, you can open an *fbt shell*, with properly configured environment.
- > - On Windows, simply run `scripts/toolchain/fbtenv.cmd`.
- > - On Linux & MacOS, run `source scripts/toolchain/fbtenv.sh` in a new shell.
- > - You can also type ```. `./fbt -s env` ``` in your shell. (Keep the "." at the beginning.)
+`fbt` by default downloads and unpacks a pre-built toolchain, and then modifies environment variables for itself to use it.
+It does not contaminate your global system's path with the toolchain.
+
+> [!NOTE]
+>
+> However, if you wish to use tools supplied with the toolchain outside `fbt`,
+> you can open an *fbt shell*, with properly configured environment.
+>
+> - On Windows, simply run `scripts/toolchain/fbtenv.cmd`.
+> - On Linux & MacOS, run `source scripts/toolchain/fbtenv.sh` in a new shell.
+> - You can also type ```. `./fbt -s env` ``` in your shell. (Keep the "." at the beginning.)
- If your system is not supported by pre-built toolchain variants or you want to use custom versions of dependencies, you can `set FBT_NOENV=1`. `fbt` will skip toolchain & environment configuration and will expect all tools to be available on your system's `PATH`. *(this option is not available on Windows)*
+If your system is not supported by pre-built toolchain variants or you want to use custom versions of dependencies, you can `set FBT_NOENV=1`.
- If `FBT_TOOLCHAIN_PATH` variable is set, `fbt` will use that directory to unpack toolchain into. By default, it downloads toolchain into `toolchain` subdirectory repo's root.
+`fbt` will skip toolchain & environment configuration and will expect all tools to be available on your system's `PATH`. *(this option is not available on Windows)*
+
+If `FBT_TOOLCHAIN_PATH` variable is set, `fbt` will use that directory to unpack toolchain into. By default, it downloads toolchain into `toolchain` subdirectory repo's root.
If you want to enable extra debug output for `fbt` and toolchain management scripts, you can `set FBT_VERBOSE=1`.
`fbt` always performs `git submodule update --init` on start, unless you set `FBT_NO_SYNC=1` in the environment:
- - On Windows, it's `set "FBT_NO_SYNC=1"` in the shell you're running `fbt` from
- - On \*nix, it's `$ FBT_NO_SYNC=1 ./fbt ...`
-
- > There are more variables controlling basic `fbt` behavior. See `fbt` & `fbtenv` scripts' sources for details.
+- On Windows, it's `set "FBT_NO_SYNC=1"` in the shell you're running `fbt` from
+- On \*nix, it's `$ FBT_NO_SYNC=1 ./fbt ...`
+> [!NOTE]
+>
+> There are more variables controlling basic `fbt` behavior.
+> See `fbt` & `fbtenv` scripts' sources for details.
+>
## Invoking FBT
@@ -38,22 +49,34 @@ To run cleanup (think of `make clean`) for specified targets, add the `-c` optio
## Build directories
-`fbt` builds updater & firmware in separate subdirectories in `build`, and their names depend on optimization settings (`COMPACT` & `DEBUG` options). However, for ease of integration with IDEs, the latest built variant's directory is always linked as `built/latest`. Additionally, `compile_commands.json` is generated in that folder (it is used for code completion support in IDEs).
+`fbt` builds updater & firmware in separate subdirectories in `build`, and their names depend on optimization settings (`COMPACT` & `DEBUG` options).
+
+However, for ease of integration with IDEs, the latest built variant's directory is always linked as `built/latest`.
+
+Additionally, `compile_commands.json` is generated in that folder (it is used for code completion support in IDEs).
-`build/latest` symlink & compilation database are only updated upon *firmware build targets* - that is, when you're re-building the firmware itself. Running other tasks, like firmware flashing or building update bundles *for a different debug/release configuration or hardware target*, does not update `built/latest` dir to point to that configuration.
+`build/latest` symlink & compilation database are only updated upon *firmware build targets* - that is, when you're re-building the firmware itself.
+
+Running other tasks, like firmware flashing or building update bundles *for a different debug/release configuration or hardware target*, does not update `built/latest` dir to point to that configuration.
## VSCode integration
-`fbt` includes basic development environment configuration for VSCode. Run `./fbt vscode_dist` to deploy it. That will copy the initial environment configuration to the `.vscode` folder. After that, you can use that configuration by starting VSCode and choosing the firmware root folder in the "File > Open Folder" menu.
+`fbt` includes basic development environment configuration for VSCode. Run `./fbt vscode_dist` to deploy it.
+
+That will copy the initial environment configuration to the `.vscode` folder.
-To use language servers other than the default VS Code C/C++ language server, use `./fbt vscode_dist LANG_SERVER=` instead. Currently `fbt` supports the default language server (`cpptools`) and `clangd`.
+After that, you can use that configuration by starting VSCode and choosing the firmware root folder in the File > Open Folder menu.
+
+To use language servers other than the default VS Code C/C++ language server, use `./fbt vscode_dist LANG_SERVER=` instead.
+
+Currently `fbt` supports the default language server (`cpptools`) and `clangd`.
- On the first start, you'll be prompted to install recommended plugins. We highly recommend installing them for the best development experience. _You can find a list of them in `.vscode/extensions.json`._
-- Basic build tasks are invoked in the Ctrl+Shift+B menu.
+- Basic build tasks are invoked in the Ctrl + Shift + B menu.
- Debugging requires a supported probe. That includes:
- Wi-Fi devboard with stock firmware (blackmagic).
- ST-Link and compatible devices.
- - J-Link for flashing and debugging (in VSCode only). _Note that J-Link tools are not included with our toolchain and you have to [download](https://www.segger.com/downloads/jlink/) them yourself and put them on your system's PATH._
+ - J-Link for flashing and debugging (in VSCode only). _Note that J-Link tools are not included with our toolchain and you have to [download](https://www.segger.com/downloads/jlink/) them yourself and put them on your system's `PATH`.
- Without a supported probe, you can install firmware on Flipper using the USB installation method.
## FBT targets
@@ -68,7 +91,7 @@ To use language servers other than the default VS Code C/C++ language server, us
- `copro_dist` - bundle Core2 FUS+stack binaries for qFlipper.
- `flash` - flash the attached device over SWD interface with supported probes. Probe is detected automatically; you can override it with `SWD_TRANSPORT=...` variable. If multiple probes are attached, you can specify the serial number of the probe to use with `SWD_TRANSPORT_SERIAL=...`.
- `flash_usb`, `flash_usb_full` - build, upload and install the update package to the device over USB. See details on `updater_package` and `updater_minpackage`.
-- `debug` - build and flash firmware, then attach with gdb with firmware's .elf loaded.
+- `debug` - build and flash firmware, then attach with gdb with firmware's `.elf` loaded.
- `debug_other`, `debug_other_blackmagic` - attach GDB without loading any `.elf`. It will allow you to manually add external `.elf` files with `add-symbol-file` in GDB.
- `updater_debug` - attach GDB with the updater's `.elf` loaded.
- `devboard_flash` - Update WiFi dev board. Supports `ARGS="..."` to pass extra arguments to the update script, e.g. `ARGS="-c dev"`.
@@ -76,7 +99,7 @@ To use language servers other than the default VS Code C/C++ language server, us
- `openocd` - just start OpenOCD. You can pass extra arguments with `ARGS="..."`.
- `get_blackmagic` - output the blackmagic address in the GDB remote format. Useful for IDE integration.
- `get_stlink` - output serial numbers for attached STLink probes. Used for specifying an adapter with `SWD_TRANSPORT_SERIAL=...`.
-- `lint`, `format` - run clang-format on the C source code to check and reformat it according to the `.clang-format` specs. Supports `ARGS="..."` to pass extra arguments to clang-format.
+- `lint`, `format` - run `clang-format` on the C source code to check and reformat it according to the `.clang-format` specs. Supports `ARGS="..."` to pass extra arguments to clang-format.
- `lint_py`, `format_py` - run [black](https://black.readthedocs.io/en/stable/index.html) on the Python source code, build system files & application manifests. Supports `ARGS="..."` to pass extra arguments to black.
- `firmware_pvs` - generate a PVS Studio report for the firmware. Requires PVS Studio to be available on your system's `PATH`.
- `doxygen` - generate Doxygen documentation for the firmware. `doxy` target also opens web browser to view the generated documentation.
@@ -115,6 +138,7 @@ To use language servers other than the default VS Code C/C++ language server, us
## Configuration
Default configuration variables are set in the configuration file: `fbt_options.py`.
+
Values set in the command line have higher precedence over the configuration file.
You can also create a file called `fbt_options_local.py` that will be evaluated when loading default options file, enabling persisent overriding of default options without modifying default configuration.
@@ -123,7 +147,12 @@ You can find out available options with `./fbt -h`.
### Firmware application set
-You can create customized firmware builds by modifying the list of applications to be included in the build. Application presets are configured with the `FIRMWARE_APPS` option, which is a `map(configuration_name:str -> application_list:tuple(str))`. To specify an application set to use in the build, set `FIRMWARE_APP_SET` to its name.
+You can create customized firmware builds by modifying the list of applications to be included in the build.
+
+Application presets are configured with the `FIRMWARE_APPS` option, which is a `map(configuration_name:str -> application_list:tuple(str))`.
+
+To specify an application set to use in the build, set `FIRMWARE_APP_SET` to its name.
+
For example, to build a firmware image with unit tests, run `./fbt FIRMWARE_APP_SET=unit_tests`.
Check out `fbt_options.py` for details.
From f8b0eab063780ca2538ad930591c3e5fb1f967c5 Mon Sep 17 00:00:00 2001
From: Ikko Eltociear Ashimine
Date: Sat, 27 Jul 2024 00:57:58 +0900
Subject: [PATCH 13/52] Debug: update QueueTools.py
availabe -> available
---
scripts/debug/FreeRTOS/FreeRTOSgdb/QueueTools.py | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/scripts/debug/FreeRTOS/FreeRTOSgdb/QueueTools.py b/scripts/debug/FreeRTOS/FreeRTOSgdb/QueueTools.py
index a35f0894f1..4984d2a06a 100644
--- a/scripts/debug/FreeRTOS/FreeRTOSgdb/QueueTools.py
+++ b/scripts/debug/FreeRTOS/FreeRTOSgdb/QueueTools.py
@@ -102,7 +102,7 @@ def GetQueueType(self):
except Exception as exc:
# If the TRACE functionality of the RTOS is not enabled,
- # then the queue type will not be availabe in the queue
+ # then the queue type will not be available in the queue
# handle - so we return None
print("Failed to get Type: %s" % str(exc))
return None
From 173ecc800e0ba4dc7c418e8ec108d90c462885b4 Mon Sep 17 00:00:00 2001
From: Leonid Meleshin
Date: Sun, 28 Jul 2024 01:57:39 +0400
Subject: [PATCH 14/52] Remove unused entries from .editorconfig (#3811)
---
.editorconfig | 3 ---
1 file changed, 3 deletions(-)
diff --git a/.editorconfig b/.editorconfig
index a31ef8e753..1fdc58bc6f 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -8,6 +8,3 @@ charset = utf-8
[*.{cpp,h,c,py,sh}]
indent_style = space
indent_size = 4
-
-[{Makefile,*.mk}]
-indent_size = tab
From 0223c23cfbaf0f6fdc4a42d8511a5a78ec9d22f4 Mon Sep 17 00:00:00 2001
From: Jan Wiesemann
Date: Sun, 28 Jul 2024 00:03:35 +0200
Subject: [PATCH 15/52] Reordered VS-Code Tasks to follow the [Release] >
[Debug] schema (#3810)
Co-authored-by: hedger
---
.vscode/example/tasks.json | 46 +++++++++++++++++++-------------------
1 file changed, 23 insertions(+), 23 deletions(-)
diff --git a/.vscode/example/tasks.json b/.vscode/example/tasks.json
index 1bc6d9ee75..aab2994f77 100644
--- a/.vscode/example/tasks.json
+++ b/.vscode/example/tasks.json
@@ -63,12 +63,6 @@
"type": "shell",
"command": "./fbt updater_all"
},
- {
- "label": "[Debug] Flash (USB, w/o resources)",
- "group": "build",
- "type": "shell",
- "command": "./fbt FORCE=1 flash_usb"
- },
{
"label": "[Release] Flash (USB, w/o resources)",
"group": "build",
@@ -76,16 +70,16 @@
"command": "./fbt COMPACT=1 DEBUG=0 FORCE=1 flash_usb"
},
{
- "label": "[Debug:unit_tests] Flash (USB)",
+ "label": "[Debug] Flash (USB, w/o resources)",
"group": "build",
"type": "shell",
- "command": "./fbt FIRMWARE_APP_SET=unit_tests FORCE=1 flash_usb_full"
+ "command": "./fbt FORCE=1 flash_usb"
},
{
- "label": "[Debug] Flash (USB, with resources)",
+ "label": "[Debug:unit_tests] Flash (USB)",
"group": "build",
"type": "shell",
- "command": "./fbt FORCE=1 flash_usb_full"
+ "command": "./fbt FIRMWARE_APP_SET=unit_tests FORCE=1 flash_usb_full"
},
{
"label": "[Release] Flash (USB, with resources)",
@@ -94,16 +88,16 @@
"command": "./fbt COMPACT=1 DEBUG=0 FORCE=1 flash_usb_full"
},
{
- "label": "[Debug] Create PVS-Studio report",
+ "label": "[Debug] Flash (USB, with resources)",
"group": "build",
"type": "shell",
- "command": "./fbt firmware_pvs"
+ "command": "./fbt FORCE=1 flash_usb_full"
},
{
- "label": "[Debug] Build FAPs",
+ "label": "[Debug] Create PVS-Studio report",
"group": "build",
"type": "shell",
- "command": "./fbt fap_dist"
+ "command": "./fbt firmware_pvs"
},
{
"label": "[Release] Build FAPs",
@@ -112,10 +106,10 @@
"command": "./fbt COMPACT=1 DEBUG=0 fap_dist"
},
{
- "label": "[Debug] Build App",
+ "label": "[Debug] Build FAPs",
"group": "build",
"type": "shell",
- "command": "./fbt build APPSRC=${relativeFileDirname}"
+ "command": "./fbt fap_dist"
},
{
"label": "[Release] Build App",
@@ -124,10 +118,10 @@
"command": "./fbt COMPACT=1 DEBUG=0 build APPSRC=${relativeFileDirname}"
},
{
- "label": "[Debug] Launch App on Flipper",
+ "label": "[Debug] Build App",
"group": "build",
"type": "shell",
- "command": "./fbt launch APPSRC=${relativeFileDirname}"
+ "command": "./fbt build APPSRC=${relativeFileDirname}"
},
{
"label": "[Release] Launch App on Flipper",
@@ -135,6 +129,12 @@
"type": "shell",
"command": "./fbt COMPACT=1 DEBUG=0 launch APPSRC=${relativeFileDirname}"
},
+ {
+ "label": "[Debug] Launch App on Flipper",
+ "group": "build",
+ "type": "shell",
+ "command": "./fbt launch APPSRC=${relativeFileDirname}"
+ },
{
"label": "[Debug] Launch App on Flipper with Serial Console",
"dependsOrder": "sequence",
@@ -145,16 +145,16 @@
]
},
{
- "label": "[Debug] Build and upload all FAPs to Flipper over USB",
+ "label": "[Release] Build and upload all FAPs to Flipper over USB",
"group": "build",
"type": "shell",
- "command": "./fbt fap_deploy"
+ "command": "./fbt COMPACT=1 DEBUG=0 fap_deploy"
},
{
- "label": "[Release] Build and upload all FAPs to Flipper over USB",
+ "label": "[Debug] Build and upload all FAPs to Flipper over USB",
"group": "build",
"type": "shell",
- "command": "./fbt COMPACT=1 DEBUG=0 fap_deploy"
+ "command": "./fbt fap_deploy"
},
{
// Press Ctrl+] to quit
@@ -180,4 +180,4 @@
}
}
]
-}
\ No newline at end of file
+}
From 30c2676d60ec6d55f61e7d1d05d1c07a72152c2e Mon Sep 17 00:00:00 2001
From: MX <10697207+xMasterX@users.noreply.github.com>
Date: Sun, 28 Jul 2024 19:46:35 +0300
Subject: [PATCH 16/52] subghz fix crash and wrong states
---
.../main/subghz/scenes/subghz_scene_frequency_analyzer.c | 5 +++--
applications/main/subghz/scenes/subghz_scene_receiver.c | 2 +-
2 files changed, 4 insertions(+), 3 deletions(-)
diff --git a/applications/main/subghz/scenes/subghz_scene_frequency_analyzer.c b/applications/main/subghz/scenes/subghz_scene_frequency_analyzer.c
index 2a0b5e498a..9e5289c548 100644
--- a/applications/main/subghz/scenes/subghz_scene_frequency_analyzer.c
+++ b/applications/main/subghz/scenes/subghz_scene_frequency_analyzer.c
@@ -69,8 +69,9 @@ bool subghz_scene_frequency_analyzer_on_event(void* context, SceneManagerEvent e
return true;
} else if(event.event == SubGhzCustomEventViewFreqAnalOkLong) {
- // Don't need to save, we already saved on short event
- //scene_manager_set_scene_state(subghz->scene_manager, SubGhzSceneStart, 10);
+ // Don't need to save, we already saved on short event (and on exit event too)
+ subghz_rx_key_state_set(subghz, SubGhzRxKeyStateIDLE);
+ scene_manager_set_scene_state(subghz->scene_manager, SubGhzSceneStart, 10);
scene_manager_next_scene(subghz->scene_manager, SubGhzSceneReceiver);
return true;
}
diff --git a/applications/main/subghz/scenes/subghz_scene_receiver.c b/applications/main/subghz/scenes/subghz_scene_receiver.c
index 01b46d2486..1a00634180 100644
--- a/applications/main/subghz/scenes/subghz_scene_receiver.c
+++ b/applications/main/subghz/scenes/subghz_scene_receiver.c
@@ -146,11 +146,11 @@ static void subghz_scene_add_to_history_callback(
if(subghz_history_get_text_space_left(subghz->history, NULL)) {
notification_message(subghz->notifications, &sequence_error);
}
+ subghz_rx_key_state_set(subghz, SubGhzRxKeyStateAddKey);
}
subghz_receiver_reset(receiver);
furi_string_free(item_name);
furi_string_free(item_time);
- subghz_rx_key_state_set(subghz, SubGhzRxKeyStateAddKey);
} else {
FURI_LOG_D(TAG, "%s protocol ignored", decoder_base->protocol->name);
}
From b2305ce5c7a6ab36babc30243a589eccfa9edcb6 Mon Sep 17 00:00:00 2001
From: MX <10697207+xMasterX@users.noreply.github.com>
Date: Sun, 28 Jul 2024 19:55:18 +0300
Subject: [PATCH 17/52] upd changelog
---
CHANGELOG.md | 63 +++++-----------------------------------------------
1 file changed, 6 insertions(+), 57 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 777f87c7a6..ddb64ba574 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,64 +1,13 @@
## Main changes
- SubGHz:
- - **Novoferm** remotes full support
- - Fix Decode scene in RAW files
- - Add manually -> Add Sommer FM238 option for cases when default option doesn't work (named as Sommer fm2)
- - Remove broken preset modulation
- - Normstahl, Sommer, MHouse, Aprimatic -> Fixes for button codes and more in Add manually
- - Custom button improvements for MHouse, Novoferm, Nice Smilo
- - Hormann EcoStar -> Add manually support, and custom button support
- - Hormann HSM 44bit static -> Button code decoding fix
- - Choose RSSI threshold for Hopping mode (by @Willy-JL)
-- NFC:
- - OFW: Ultralight C authentication with des key
- - EMV Transactions less nested, hide if unavailable (by @Willy-JL | PR #771)
- - Update Mifare Classic default keys dict with new keys from proxmark3 repo and UberGuidoZ repo
-- LF RFID:
- - Update T5577 password list (by @korden32 | PR #774)
- - Add DEZ 8 display form for EM4100 (by @korden32 | PR #776 & (#777 by @mishamyte))
-- JS:
- - Refactor widget and keyboard modules, fix crash (by @Willy-JL | PR #770)
- - SubGHz module fixes and improvements (by @Willy-JL)
-* OFW: Infrared: check for negative timings
-* OFW: Fix iButton/LFRFID Add Manually results being discarded
-* OFW: Event Loop Timers
-* OFW: Updater: resource compression
+ - Fix rare crash when opening Read mode via Frequency analyzer
+ - Refactor frequency analyzer code for better readability (by @derskythe | PR #782)
+* Docs: Remove not printable symbols and update docs (by @derskythe | PR #783)
* Apps: **Check out more Apps updates and fixes by following** [this link](https://github.com/xMasterX/all-the-plugins/commits/dev)
## Other changes
-* OFW: HID/BLE Keyboard UI refactoring
-* OFW: CCID: Add CCIDWorker
-* OFW: Disabled ISR runtime stats collection for updater builds
-* OFW: VSCode fixes: .gitignore & clangd
-* OFW: ufbt: synced .clang-format rules with main
-* OFW: Code formatting update
-* OFW: scripts: runfap: fixed starting apps with spaces in path
-* OFW: toolchain: v38. clangd as default language server
-* OFW: NFC: ISO15693 Render Typo Fix
-* OFW: tar archive: fix double free
-* OFW: ufbt: added ARGS to commandline parser
-* OFW: lib: sconscript todo cleanup
-* OFW: Intruder animation
-* OFW: Desktop: allow to close blocking bad sd animation
-* OFW: Updater: reset various debug flags on production build flash (was done in same way in UL before)
-* OFW: Fix PVS Warnings
-* OFW: CCID: Improve request and response data handling
-* OFW: Furi: count ISR time. Cli: show ISR time in top.
-* OFW: toolchain: v37
-* OFW: NFC: Cache plugin name not full path, saves some RAM (by @Willy-JL)
-* OFW: copro: bumped to 1.20.0
-* OFW: input_srv: Put input state data on the stack of the service
-* OFW: Coalesce some allocations
-* OFW: updater: slightly smaller image
-* OFW: Updater: Fix double dir cleanup
-* OFW: cli: storage: minor subcommand lookup refactor
-* OFW: LFRFID Securakey: Add Support for RKKTH Plain Text Format
-* OFW: NFC: Add mf_classic_set_sector_trailer_read function
-* OFW: Separate editing and renaming in iButton and LFRFID
-* OFW: New js modules documentation added
-* OFW: Update link to mfkey32
-* OFW: NFC: Desfire Renderer Minor Debug
-* OFW: RPC: Fix input lockup on disconnect
-* OFW: Thread Signals
+* Misc: Fix typo in comment in QueueTools.py (by @eltociear | PR #785)
+* OFW: Reordered VS-Code Tasks to follow the `Release` > `Debug` schema
+* OFW: Remove unused entries from .editorconfig
+
+
+Hitting the `centre` button on the Flipper toggles edit mode.
+When in edit mode, `Left` and `Right` will change the digit to be changed, and up and down will adjust the digit value.
+
+