GuillaumeHemmen/flipperzero-firmware-wPlugins
1
0
Fork 0
mirror of https://github.com/RogueMaster/flipperzero-firmware-wPlugins.git synced 2024-11-01 11:42:37 +01:00
Code Issues Projects Releases Packages Wiki Activity

fix: fixed gcc-arm-embedded reference and updated steps to build the firmware

Browse source
This commit is contained in:
Elton Alves 2023-06-06 10:43:12 +02:00
parent 36d65f3806
commit ec51227ab9
2 changed files with 41 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
Brewfile
View file

@ -1,4 +1,4 @@
cask "brew-cask/gcc-arm-embedded.rb" cask "brew-cask/gcc-arm-embedded"
brew "protobuf" brew "protobuf"
brew "gdb" brew "gdb"
brew "open-ocd" brew "open-ocd"

87
MACOS_GUIDE.md
View file

@ -1,82 +1,73 @@
# **macOS compile guide** by deafbed ## **macOS compile guide** by deafbed,
* Updated by **@eltonalvess**
### Tested with M1 Macbook Air, macOS Monterey (12.4) ### Tested with M1 Macbook Air, macOS Monterey (12.4)
### :arrow_up: Update
* Tested with M1 Macbook Pro, macOS Ventura (13.4, 22F66) [06-06-2023]
* *(NB: do NOT include the "$ " if copying/pasting any of the below commands)* ## **FROM THE BEGINNING**
## FROM SCRATCH
### Install qFlipper ### Install qFlipper
qFlipper can be found on the App Store or you can download it from [https://flipperzero.one/update](https://flipperzero.one/update) - qFlipper can be found on the App Store or you can download it from [https://flipperzero.one/update](https://flipperzero.one/update)
### Install Brew ---
Open Terminal.app and run
`$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` ### **Install the Homebrew application**
**IMPORTANT:** once installed, run the two commands given to you ("Next steps") `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
*(first should begin `$ echo 'eval...'`, second should begin `$ eval "$(/opt/...))`* Open `Terminal.app` or `iTerm.app` and run `source ~/.bashrc` of if you are using zsh the command should be `source ~/.zshrc` (It will refresh enviroment variables that Homebrew creates).
Quit and re-open Terminal.app, then run To have sure that Brew was installed sucessfully then run
`$ brew help` `brew help` it should output something like this:
to check if the installation was successful ![out](https://github.com/EltonAlvess/flipperzero-firmware-wPlugins/assets/1638045/a3f56314-c9ff-4e73-9811-81042f1e731a)
### Install Docker Desktop ---
Download the appropriate version (Intel/M1) of Docker Desktop from
[https://docs.docker.com/desktop/mac/install/](https://docs.docker.com/desktop/mac/install/)
*(If the downloaded file has no extension/won't open, simply append .dmg to the filename)* ### **Download the source code of the firmware**
To clone the repository, just run the command below:
Open Docker.dmg and drag Docker.app to the Applications folder `git clone --recursive https://github.com/RogueMaster/flipperzero-firmware-wPlugins.git`
Eject Docker.dmg from the sidebar, navigate to your Applications folder and open Docker. Install as prompted and wait a few seconds until Docker is running It will download the latest build files from the github repository (in your prefered folder)
Quit and re-open Terminal, and run Inside the source code folder (flipperzero-firmware-wPlugins) run the follow command:
`$ docker help` `chmod u+x buildRelease.sh`
to check if the install was successful > This command will give permission to execute the Shell Script (.sh).
---
### Make sure PIP is up-to-date ### **Install the necessary prerequisites**
Still in Terminal, run
`$ python3 -m pip install --upgrade pip` Go to the downloaded firmware folder
### Download the firmware `cd flipperzero-firmware-wPlugins`
Next, run
`$ git clone --recursive https://github.com/RogueMaster/flipperzero-firmware-wPlugins.git` Next, we run the following command to download the remaining requirements:
This will download the latest build files from the github repository (in this case most likely to your Home folder) `brew bundle --verbose`
### Install the necessary prerequisites ---
Navigate to the folder you just downloaded
`$ cd flipperzero-firmware-wPlugins`
Next, we run 2 scripts to download the remaining requirements. First:
`$ brew bundle --verbose`
Then:
`$ pip3 install -r scripts/requirements.txt`
### Compile ### Compile
Make sure Docker is still open, if not open Docker.app
In Terminal, still in the flipperzero-firmware-wPlugins directory, run To compile the source code just run the following command inside the root folder.
`$ docker-compose up -d` `./buildRelease.sh`
Then: > :sleeping: It will start to compile, be patient it take a while!
---
`$ docker-compose exec dev ./fbt` ### The output files
If everything goes well it will appear some 3 files in the root folder like the image below:
It may take a while and you might see some errors but if all goes well the compiled firmware (DFU) file should now be in **flipperzero-firmware-wPlugins/dist/f7-C/flipper-z-f7-full-local.dfu** ![image](https://github.com/EltonAlvess/flipperzero-firmware-wPlugins/assets/1638045/eec62f52-8a6a-4f3a-a293-196cb83aeba3)
---
### Put your Flipper into Recovery/DFU mode ### Put your Flipper into Recovery/DFU mode
Put your flipper into DFU mode by: Put your flipper into DFU mode by:
@ -85,6 +76,8 @@ Put your flipper into DFU mode by:
2. once turned off, release BACK but keep holding LEFT until the LED flashes blue 2. once turned off, release BACK but keep holding LEFT until the LED flashes blue
3. once the LED flashes blue, release LEFT and your Flipper should be in recovery mode 3. once the LED flashes blue, release LEFT and your Flipper should be in recovery mode
---
### Install the firmware ### Install the firmware
Open qFlipper.app Open qFlipper.app