ReadMe: update outdated bits and pieces (#3726)

This commit is contained in:
あく 2024-06-20 18:18:31 +01:00 committed by GitHub
parent 3859646e13
commit a0036d10fc
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 22 additions and 38 deletions

View file

@ -52,7 +52,8 @@ Supported development platforms:
Supported in-circuit debuggers (optional but highly recommended): Supported in-circuit debuggers (optional but highly recommended):
- [Flipper Zero Wi-Fi Development Board](https://shop.flipperzero.one/products/wifi-devboard) - [Flipper Zero Wi-Fi Development Board](https://shop.flipperzero.one/products/wifi-devboard)
- ST-Link - CMSIS-DAP compatible: Raspberry Pi Debug Probe and etc...
- ST-Link (v2, v3, v3mods)
- J-Link - J-Link
Flipper Build System will take care of all the other dependencies. Flipper Build System will take care of all the other dependencies.
@ -96,18 +97,20 @@ Make sure your Flipper is on, and your firmware is functioning. Connect your Fli
- [Hardware combos and Un-bricking](/documentation/KeyCombo.md) - recovering your Flipper from the most nasty situations - [Hardware combos and Un-bricking](/documentation/KeyCombo.md) - recovering your Flipper from the most nasty situations
- [Flipper File Formats](/documentation/file_formats) - everything about how Flipper stores your data and how you can work with it - [Flipper File Formats](/documentation/file_formats) - everything about how Flipper stores your data and how you can work with it
- [Universal Remotes](/documentation/UniversalRemotes.md) - contributing your infrared remote to the universal remote database - [Universal Remotes](/documentation/UniversalRemotes.md) - contributing your infrared remote to the universal remote database
- [Firmware Roadmap](/documentation/RoadMap.md) - [Firmware Roadmap](https://miro.com/app/board/uXjVO_3D6xU=/)
- And much more in the [Developer Documentation](https://developer.flipper.net/flipperzero/doxygen) - And much more in the [Developer Documentation](https://developer.flipper.net/flipperzero/doxygen)
# Project structure # Project structure
- `applications` - applications and services used in firmware - `applications` - Applications and services used in firmware
- `assets` - assets used by applications and services - `applications_users` - Place for your additional applications and services
- `furi` - Furi Core: OS-level primitives and helpers - `assets` - Assets used by applications and services
- `documentation` - documentation generation system configs and input files - `documentation` - Documentation generation system configs and input files
- `firmware` - firmware source code - `furi` - Furi Core: OS-level primitives and helpers
- `lib` - our and 3rd party libraries, drivers, etc. - `lib` - Our and 3rd party libraries, drivers, tools and etc...
- `scripts` - supplementary scripts and python libraries home - `site_scons` - Build system configuration and modules
- `scripts` - Supplementary scripts and various python libraries
- `targets` - Firmware targets: platform specific code
Also, see `ReadMe.md` files inside those directories for further details. Also, see `ReadMe.md` files inside those directories for further details.

View file

@ -1,10 +1,5 @@
# Firmware Assets {#firmware_assets} # Firmware Assets {#firmware_assets}
## Requirements
- Python3
- Python3 packages: Pillow & heatshrink2
## Compiling ## Compiling
```bash ```bash

View file

@ -1,17 +1,18 @@
# Structure # Structure
- `FreeRTOS-Kernel` - FreeRTOS kernel source code
- `FreeRTOS-glue` - Extra glue to hold together FreeRTOS kernel and flipper firmware
- `app-scened-template` - C++ app library - `app-scened-template` - C++ app library
- `bit_lib` - library for working with bits/bytes directly - `bit_lib` - library for working with bits/bytes directly
- `callback-connector` - Callback connector library - `ble_profile` - BLE Profiles source code
- `cmsis_core` - CMSIS Core package, contain cortex-m core headers - `cmsis_core` - CMSIS Core package, contain cortex-m core headers
- `cxxheaderparser` - C++ headers parser, used by SDK bundler - `cxxheaderparser` - C++ headers parser, used by SDK bundler
- `datetime` - DateTime library
- `digital_signal` - Digital signal library: used by NFC for software implemented protocols - `digital_signal` - Digital signal library: used by NFC for software implemented protocols
- `drivers` - Various flipper drivers - `drivers` - Various flipper drivers
- `fatfs` - FatFS file system driver - `fatfs` - FatFS file system driver
- `flipper_application` - Flipper application library, used for FAPs - `flipper_application` - Flipper application library, used for FAPs
- `flipper_format` - Flipper File Format library - `flipper_format` - Flipper File Format library
- `FreeRTOS-glue` - Extra glue to hold together FreeRTOS kernel and flipper firmware
- `FreeRTOS-Kernel` - FreeRTOS kernel source code
- `heatshrink` - Heatshrink compression library - `heatshrink` - Heatshrink compression library
- `ibutton` - ibutton library, used by iButton application - `ibutton` - ibutton library, used by iButton application
- `infrared` - Infrared library, used by Infrared application - `infrared` - Infrared library, used by Infrared application
@ -20,7 +21,9 @@
- `littlefs` - LittleFS file system driver, used by internal storage - `littlefs` - LittleFS file system driver, used by internal storage
- `mbedtls` - MbedTLS cryptography library - `mbedtls` - MbedTLS cryptography library
- `microtar` - MicroTAR library - `microtar` - MicroTAR library
- `mjs` - MJs, javascript engine library
- `mlib` - M-Lib C containers library - `mlib` - M-Lib C containers library
- `music_worker` - MusicWorker library for playing midi and RTTTL files
- `nanopb` - NanoPB library, protobuf implementation for MCU - `nanopb` - NanoPB library, protobuf implementation for MCU
- `nfc` - NFC library, used by NFC application - `nfc` - NFC library, used by NFC application
- `one_wire` - OneWire library, used by iButton application - `one_wire` - OneWire library, used by iButton application
@ -33,4 +36,4 @@
- `subghz` - Subghz library, used by SubGhz application - `subghz` - Subghz library, used by SubGhz application
- `toolbox` - Toolbox library, contains various things that is used by Flipper firmware - `toolbox` - Toolbox library, contains various things that is used by Flipper firmware
- `u8g2` - u8g2 graphics library, used by GUI subsystem - `u8g2` - u8g2 graphics library, used by GUI subsystem
- `update_util` - update utilities library, used by updater - `update_util` - update utilities library, used by updater

View file

@ -1,22 +1,5 @@
# Flipper firmware
What does it do?
- [x] RTOS
- [x] FuriHAL
- [x] FuriCore
- [x] Services
- [x] Applications
# Targets # Targets
| Name | Firmware Address | Reset Combo | DFU Combo | - f18 - Not Flipper Zero
|-----------|-------------------|-----------------------|-----------------------| - f7 - Flipper Zero
| f7 | 0x08000000 | L+Back, release both | L+Back, release Back | - furi_hal_include - Global Furi HAL includes, common for all targets
Also, there is a "hardware" ST bootloader combo available even on a bricked or empty device: L+Ok+Back, release Back, Left.
Target independent code and headers in `target/include` folders. More details in `documentation/KeyCombo.md`
# Building
Check out `documentation/fbt.md` on how to build and flash firmware.