GEMISIS / tone_gen

Very simple tone generator application for the Flipper Zero. Setup to be a good sample project as well.

Tone Generator

This repo contains a simple application for the Flipper Zero that can generate a steady tone with a variety of user chosen settings. It's designed to be a simple application showcasing how to develop apps for the Flipper Zero, and get my hands dirty with doing so. It is written entirely in C, and is very simple in nature by design.

Dependencies

This project depends on uFBT for building. It is also recommended to install VSCode for ease of development, as well as minicom for debugging (brew install minicom).

App Source File Structure

The application is structured such that each scene can be self contained, with the sharing of data between scenes done via the app context. All of the scenes can be found with their corresponding source and header files in the src/scenes directory. The scenes do as follows:

• Starting Scene: The scene where the application starts. This has the main menu options that users see when they start the app.
• Playback Scene: The scene where the sound is played. Animates a waveform with the approximate shape of the sound being played.
• Settings Scene: The scene where users can configure the tone's properties.

Note as well that the app context file is generic, and designed in such as way that it should not need to be updated for things specific to the application. This allows for an easier time to allow scenes to self manage, insteaed of having somewhere else that centrally manages everything.

Helpful Commands

• ufbt: Builds the project
• ufbt launch: Launches the project on a device. Make sure no other applications (including qFlipper) are connected to the device.
• minicom -D /dev/tty.X: Replace X with the name of your flipper device when connected and then use this to start a command line interface to your flipper device. From there, you can run log debug to see debug logs from the app while it is running.