Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
Mecrisp-Cube for the Flipper Zero
Intro
Instant real-time programming with Forth.
The Flipper Zero is an excellent portable tool for interaction with access control systems.
But the display, the buttons, LIPO (2.1 Ah), GPIO, BLE, SD-Card, RTC, etc. make it also an ideal tool for programming on the go. | ||||||||
Changed: | ||||||||
< < | Sources on GitHub (Flipper branch on Mecrisp-Cube) | |||||||
> > | This page is no longer updated regularly, the current documentation can be found at GitHub (Flipper branch on Mecrisp-Cube). Sources are also there. | |||||||
Contents
FeaturesThe standard Mecrisp-Cube features like RTOS, Filesystem, USB, etc.
Getting StartedThese instructions will get you a copy of the project up and running on your local machine (Flipper Zero) for development and testing purposes.Prerequisites
Flash the Mecrisp-Cube FirmwareFlash the Mecrisp-Cube binary (MecrispCubeFlipper.bin ) or better the fs-util-binary (MecrispCubeFlipperFS.bin ) to the Flipper Zero. Using the built-in USB DFU bootloader, see also firmware recovery.
Switch On/Off, Buttons, LED
Special Functions on StartupUSB-CDC is the default console.
RGB LED as Status IndicatorThe RGB LED displays the status
Use the Terminal (USB CDC)Connect the Flipper Zero USB to the PC. Start the terminal emulator application on the PC. Check for the serial communication port (e.g. for Linux/dev/ttyACM0 ).
I set the putty terminal configuration to
Mecrisp-Stellaris RA 2.5.4 by Matthias Koch. Mecrisp-Cube 1.5.0 for STM32WB Flipper, 63/128 KiB RAM/FLASH dictionary (C) 2023 peter@spyr.ch * Firmware Package STM32Cube FW_WB V1.17.3, USB-CDC, BLE Stack 5.3 (C) 2023 STMicroelectronics * CMSIS-RTOS V2 FreeRTOS wrapper, FreeRTOS Kernel V10.3.1 (C) 2020 Amazon.com * FatFs for internal flash and microSD - Generic FAT fs module R0.12c (C) 2017 ChaN include 0:/etc/rc.localUse the interpreter: 23 5 / .[CR] 4 ok.Type in your first Forth program: : hello ." World" ;[CR] ok. hello[CR] World ok. Additional Tools and Local FilesystemPopulate a microSD with the contents of sdcard. Put the microSD into the uSD Card slot and reset or power cycle the board. The directory should look like this:ls -l 1:[CR] drw- 0 2021-04-18T18:12:38 boot drw- 0 2021-03-21T18:47:52 etc drw- 0 2021-03-21T18:47:54 fsr drw- 0 2021-03-21T18:47:54 home drw- 0 2021-03-21T18:47:56 man -rwa 7219 2021-01-08T19:42:36 README.md ok.You can use the local CLI commands like mkfs , mkdir and cp to create a filesystem on the serial flash and fill it with files and folders. But this is tedious job because I haven't yet implemented a recursive copy for MecrispCube. But there is prepared disk image
(for details see MicroSdBlocks#Serial_Flash) on microSD and the tool dd . You can copy the disk image to the drive 0: (this takes about 8 Minutes):
dd 1:/boot/fd-384KiB.img 0:[CR] ok. mount 0:[CR] ok. ls 0:[CR] man fsr README.md boot etc home ok.The Mecrisp have some tools bundled in its distribution e.g. assembler, disassembler, dump, float. I put those tools and some more into the folder /fsr . With the "init.fs script" I compile my favorite ones into the flash directory (if you use the fs-util-binary binary, these tools are already compiled in):
compiletoflash[CR] ok. include /etc/init.fs[CR] init.fs Loading started RAM Dictionary: 392991 KiB utils.fs loading ... conditional.fs loading ... dump.fs loading ... disassembler-m3.fs loading ... float.fs loading ... threads.fs loading ... RAM Dictionary: 392981 KiB init.fs finished ok.For example, the word disassember is available now: see dump[CR] 080405F0: B500 push { lr } 080405F2: F7C2 bl 08002A3E --> cr 080405F4: FA24 080405F6: CF08 ldmia r7 { r3 } 080405F8: F013 ands r2 r3 #F 080405FA: 020F 080405FC: F847 str r3 [ r7 #-4 ]! 080405FE: 3D04 08040600: 2A00 cmp r2 #0 08040602: D000 beq 08040606 08040604: 3610 adds r6 #10 08040606: CF08 ldmia r7 { r3 } 08040608: F847 str r6 [ r7 #-4 ]! Flash the original Flipper FirmwareIf you want to go back to the original firmware, do the following
Installing Development EnvironmentA step by step series of examples that tell you how to get a development env running Install the IDE STM32CubeIDE, it is Eclipse and GCC based. STM32CubeMX is included in the IDE, you need a stand alone installation only if you do not want to use the STM32CubeIDE. Get the sources from github:psi@homer:~> git clone --branch Flipper https://github.com/spyren/Mecrisp-Cube Klone nach 'Mecrisp-Cube' ... remote: Enumerating objects: 1157, done. remote: Counting objects: 100% (1157/1157), done. remote: Compressing objects: 100% (620/620), done. remote: Total 3183 (delta 720), reused 934 (delta 525), pack-reused 2026 Empfange Objekte: 100% (3183/3183), 41.60 MiB | 6.96 MiB/s, Fertig. Löse Unterschiede auf: 100% (2100/2100), Fertig.Import the project into the IDE: File -> Import -> General -> Existing Projects into Workspace -> Select root directory Copy project into workspace Browse to Mecrisp-Cube directoryGenerate code from the STM32CubeMX MecrispCubeFlipper.ioc file:
Project -> Generate CodeRestore changed source files $ git status {list of changed files} $ git restore {files to restore}Select the Build Configuration (Debug if you want to debug the project) and Build the project: Project -> Build Configurations -> Set Active -> Debug/Release Project -> Build Project This work by Peter Schmid is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. Sitronix ST7567
|