• C 63.2%
  • Python 34%
  • C++ 1.9%
  • Linker Script 0.6%
  • HLSL 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-08-02 21:20:29 +00:00
configurations firmware version numbers bumped to v1.0 2018-01-24 11:48:28 -06:00
docs Adding status_led.rst, oops 2018-02-17 10:09:37 -06:00
examples readme updates 2018-01-18 14:30:16 -06:00
FX docs and FX 2018-02-02 11:43:17 -06:00
hardware/chromatron/v1.0 hardware v1.0 2018-01-18 15:14:36 -06:00
img more demos 2017-07-26 14:56:43 -05:00
python Bump the pip group across 1 directory with 2 updates 2026-08-02 09:08:48 +00:00
src add single level cache to static KV search 2018-02-04 11:56:54 -06:00
targets check in of source from old repo 2018-01-18 14:12:01 -06:00
build.py Fixed build script 2018-01-18 14:22:19 -06:00
KNOWN_ISSUES.txt docs docs docs 2018-02-01 17:50:00 -06:00
make_fw_package.py fixed path in build script, removed old zip file creation. 2018-01-18 14:16:16 -06:00
README.rst Fix broken link in readme 2018-02-21 11:05:39 -06:00

Chromatron
==========

`Chromatron Wifi Pixel Controller <http://chromatron.io>`_

Chromatron is an open source Wifi pixel controller. It is a complete hardware and software toolkit designed specifically for making projects with LED pixel strips.

Supported LED types:

- APA102
- WS2801
- WS2811/WS2812/WS2812b
- SK6812 (RGB and RGBW)
- Analog/PWM (RGB only - post an issue if you need RGBW support)
- `Adafruit Pixie <https://www.adafruit.com/product/2741>`_


Documentation
-------------

`chromatron.readthedocs.io <https://chromatron.readthedocs.io>`_


Support
-------

`Chromatron Google Group <https://groups.google.com/forum/#!forum/chromatron>`_


Build Instructions
-------------------

Install Python tools:


The build system only works with Python 2.7 (for now).  Additionally, building on Windows is also broken (for now).  Official releases are built on Mac OS X.  Builds on Ubuntu should also work.


.. code:: bash

    $ pip install chromatron

You will also need PlatformIO (which is needed to build the wifi firmware):

.. code:: bash

    $ pip install platformio


Make sure you are in the root folder of the repository for the remaining steps.


Install compiler toolchain:

.. code:: bash

    $ sapphiremake --install_build_tools


Scan for firmware projects.  This searchs the folder structure for all of the projects so the build tools can find everything.

.. code:: bash

    $ sapphiremake --discover


Build the bootloader project:

.. code:: bash

    $ sapphiremake -p loader_xmega128a4u


Build everything else:

.. code:: bash

    $ python make_fw_package.py



License Information
-------------------

The software contents of this repository are released under the GNU General Public License v3.

See http://www.gnu.org/licenses/ for more information.