DarkFlippers/unleashed-firmware
1
1
Fork 0
mirror of https://github.com/DarkFlippers/unleashed-firmware.git synced 2024-12-26 06:42:02 +03:00
Code Issues Projects Releases Wiki Activity
c2eeadc41e
unleashed-firmware/documentation/CustomFlipperName.md
MX 1beb7735a2
update docs
2022-08-14 06:25:32 +03:00

2.2 KiB
Raw Blame History

How to change Flipper name:

Instruction

  1. Read How to build and How to install to know how to build and install firmware
  2. Follow how to build instructions to prepare all things before continuing
  3. Run release build to verify all is ok - ./fbt COMPACT=1 DEBUG=0 updater_package
  4. Clear build files - ./fbt COMPACT=1 DEBUG=0 updater_package -c
  5. Run command with extra enviroment var before ./fbt that variable should contain your custom name in alphanumeric characters - max length 8 chars CUSTOM_FLIPPER_NAME=Name ./fbt COMPACT=1 DEBUG=0 updater_package - where Name write your custom name
  6. Copy dist/f7-C/f7-update-local folder to microSD update/myfw/ and run update file on flipper from file manager app (Archive)
  7. Flash from microSD card only, .dfu update from qFlipper will not work properly since name and serial number will be changed
  8. Done, you will have custom name, serial number and bluetooth mac address

Troubleshooting

I'm using Windows and name changing / building firmware doesn't work

  • Use PowerShell or VSCode terminal(powershell by default)
  • Clear build files - .\fbt.cmd COMPACT=1 DEBUG=0 updater_package -c
  • Enter this in same terminal $Env:CUSTOM_FLIPPER_NAME="Name"
  • Run release build - .\fbt.cmd COMPACT=1 DEBUG=0 updater_package
  • Flash as described before (see 6.)
  • If something still not work - Run powershell or VSCode as Admin

Name stays same for every new build

  • Clear build files - ./fbt COMPACT=1 DEBUG=0 updater_package -c
  • Try again

I want to return my original name and serial number

  • Flash stock FW or any CFW using microSD card offline update method

Or

  • Clear build files - ./fbt COMPACT=1 DEBUG=0 updater_package -c
  • Run release build - ./fbt COMPACT=1 DEBUG=0 updater_package
  • Copy dist/f7-C/f7-update-local folder to microSD update/myfw/ and run update file on flipper from file manager app (Archive)
  • Flash from microSD card only, .dfu update from qFlipper will not work properly since name and serial number will be changed