Giter Club home page Giter Club logo

x4-controller's Introduction

EPPG Controller

Build

Arduino based logic for OpenPPG X4 Throttle Controller

The SP140 controller codebase is located at https://github.com/openppg/eppg-controller

This master branch is only for testing the latest firmware for the X4

It may not be stable and is not recommended for flying. See stable releases here

For batch 3 (non-telemetry) controllers please see the batch-3 branch.

For batch 2 (Arduino nano based) controllers please see the batch-2 branch.

Build and flash firmware

OpenPPG supports flashing the firmware PlatformIO. Older versions were also compatible with Arduino IDE.

Using PlatformIO

Suitable for Mac, Windows, and Linux

Setup

  1. Follow the instructions here for using with VSCode https://platformio.org/install/ide?install=vscode
  2. Extract the downloaded code from the repo here (or git clone it)
  3. Open the folder using the PlatformIO "open project" option inside of VSCode.

Flash the OpenPPG Code

  1. Click the "PlatformIO Build" button inside of VSCode or enter platformio run --target upload in the command line. PlatformIO will automatically download libraries the first time it runs.

Install the driver

Batch 3+ OpenPPG controllers are powered by Atmel’s SAMD21G18A MCU, featuring a 32-bit ARM Cortex® M0+ core. On some operating systems you may need extra drivers to communicate with it.

Download and Prepare OpenPPG Code

  1. Download the latest controller code zip from here

Flash the OpenPPG Code

  1. First make sure the code compiles by hitting the check button in the bottom left "Build".
  2. Connect the controller to your computer by using the USB port on the bottom of the controller.
  3. Flash the firmware by clicking "Upload" in the bottom left.

Bootloader

The latest batches of OpenPPG X4 controllers use the UF2 bootloader (compatible with Arduino). It makes firmware updates as simple as drag and drop. Learn more here https://github.com/openppg/uf2-samdx1

Building .uf2 update file

The uf2 bootloader can update firmware with a .uf2 binary file built from a complied .bin firmware file. The .bin file is automatically built when "verifying" the firmware in either Arduino IDE or PIO. Using the uf2-samdx repo above python tool the command to build a compatible .uf2 file should look something like:

$ python3 utils/uf2conv.py x4-controller/.pio/build/OpenPPG\ CM0/firmware.bin -c -o X4-update.uf2

Config tool

The open source web based config tool for updating certain settings over USB (without needing to flash firmware) can be found at https://config.openppg.com.

Help improve these docs

Pull requests are welcome for these instructions and code changes.

x4-controller's People

Contributors

glydrfreak avatar zjwhitehead avatar

Stargazers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.