Startsida Utforska Hjälp
Logga in
torambo.com
/
Momentum-Apps
2
0
Fork 0
Filer Ärenden 0 Pull-förfrågningar 0 Wiki
Träd: 51f0b0ca7d
Grenar Taggar
Momentum-Apps
/
README.md

README.md 6.6 KB
Historik Rå

Flipper Zero - Camera Suite

Firmware and software to run an ESP32-CAM module on your Flipper Zero device.

Table of Contents

Previews

More previews coming soon!

[ Back to top ]

Hardware Requirements

Requires an ESP32-CAM module (I've personally used these: Amazon Link 1 | Amazon Link 2).

[ Back to top ]

Hardware Installation

Below is the pinout guide and diagram for the ESP32-CAM module to the Flipper Zero. From the ESP32-CAM module to the Flipper Zero:

VCC to 3V3
GND to GND (Be sure to use the right GND, see image below.)
U0R to TX
U0T to RX

On the ESP32-CAM module itself you'll also need to connect the IO0 pin to GND. This will place the module into flash mode for installing the firmware later on (see Firmware Installation). You can do this by connecting a jumper wire, a button, or a switch to do this.

[ Back to top ]

Firmware Installation

  1. Download and install the Arduino IDE from here.
  2. Go to the releases section for this repo and download the esp32_cam_uart_stream.zip file.
  3. Extract the contents of esp32_cam_uart_stream.zip to disk. Be sure to keep the .ino file nested in the folder with the same name.
  4. Open ~\esp32_cam_uart_stream\esp32_cam_uart_stream.ino with your Arduino IDE.
  5. In the Arduino IDE, go to File > Preferences.

  6. In the Settings tab, add the following URL to the Additional Boards Manager URLs field:

    https://dl.espressif.com/dl/package_esp32_index.json

  7. In the Arduino IDE, go to Tools > Board > Boards Manager.

  8. Search for esp32 and install esp32 by Espressif Systems.

  9. Plug in your Flipper Zero via USB. Make sure qFlipper or something else isn't connected to it already after doing so.

  10. On your Flipper Zero, open GPIO > USB-UART Bridge.

  11. In the Arduino IDE, go to Tools > Board > esp32 > AI Thinker ESP32-CAM.

  12. In the Arduino IDE, go to Tools > Port and select the port that your Flipper Zero is connected to.

  13. Plug in the ESP32-CAM module to your Flipper Zero while connecting the IO0 pin to GND. See Hardware Installation for more information.

  14. Press the RST button on the back of the ESP32-CAM module to boot it into flash mode.

  15. In the Arduino IDE, go to Sketch > Upload to upload the firmware to your ESP32-CAM module. You will see upload progress in % and receive a message on completion if successful.

  16. Fin! Now you may use the Software Installation section to install the software on your Flipper Zero to take advantage of this hardwares firmware.

Note the upload may fail a few times, this is normal, try again. If it still fails, try pressing the RST button on the back of the ESP32-CAM module again or checking your connections.

[ Back to top ]

Software Installation

  1. Connect your Flipper Zero via USB, or insert your MicroSD.
  2. Download "camerasuite.fap" from the release section.

  3. Move "camerasuite.fap" into ~\apps\gpio\ on your Flipper Zero MicroSD:

    .                            # The Flipper Zero MicroSD root.
├── apps                     # The Flipper Zero Applications folder.
|   ├── gpio                 # The Flipper Zero General Purpose Input/Output folder.
|   |   ├── camerasuite.fap  # The Camera Suite application.

  4. Reinsert your MicroSD into your Flipper Zero if you took it out.

  5. Plug in your ESP32-CAM module to your Flipper Zero.

  6. Press the "Power" button on your Flipper Zero to turn it on.

  7. Open the application "[ESP32-CAM] Camera Suite":

    Applications > GPIO > [ESP32-CAM] Camera Suite

  8. That's it! Follow the on screen instructions to continue.

[ Back to top ]

Software Guide

Flipper Zero button mappings:

🔼 = Contrast Up

🔽 = Contrast Down

◀️ = Toggle invert.

▶️ = Toggle dithering on/off.

⚪ = Toggle between Floyd–Steinberg and Atkinson dithering.

↩️ = Go back.

Camera Suite settings:

Orientation = Rotate the camera image 90 degrees clockwise starting at zero by default (0, 90, 180, 270). This is useful if you have your camera module mounted in a different orientation than the default.

Haptic FX = Toggle haptic feedback on/off.

Sound FX = Toggle sound effects on/off.

LED FX = Toggle LED effects on/off.

[ Back to top ]

Attributions

This project is based on/forked from the Fliper Zero Camera Application by Z4urce combined with the Flipper Zero Boilerplate Application by Dave Lee.

[ Back to top ]

Fin. Thanks for looking and happy programming friend!

Cody