Code Monkey home page Code Monkey logo

async-rgb-led-analyzer's Introduction

Saleae Async RGB LED Analyzer

Saleae Async RGB LED Analyzer

Getting Started

The following documentation describes how to build this analyzer locally. For more detailed information about the Analyzer SDK, debugging, CI builds, and more, check out the readme in the Sample Analyzer repository.

https://github.com/saleae/SampleAnalyzer

MacOS

Dependencies:

  • XCode with command line tools
  • CMake 3.13+
  • git

Install command line tools after XCode is installed:

xcode-select --install

Then open XCode, open Preferences from the main menu, go to locations, and select the only option under 'Command line tools'.

Install CMake on MacOS:

  1. Download the binary distribution for MacOS, cmake-*-Darwin-x86_64.dmg
  2. Install the usual way by dragging into applications.
  3. Open a terminal and run the following:
/Applications/CMake.app/Contents/bin/cmake-gui --install

Note: Errors may occur if older versions of CMake are installed.

Build the analyzer:

mkdir build
cd build
cmake ..
cmake --build .

Ubuntu 18.04+

Dependencies:

  • CMake 3.13+
  • gcc 4.8+
  • git

Misc dependencies:

sudo apt-get install build-essential

Build the analyzer:

mkdir build
cd build
cmake ..
cmake --build .

Windows

Dependencies:

  • Visual Studio 2019
  • CMake 3.13+
  • git

Visual Studio 2019

Note - newer and older versions of Visual Studio are likely to work.

Setup options:

  • Workloads > Desktop & Mobile > "Desktop development with C++"

Note - if CMake has any problems with the MSVC compiler, it's likely a component is missing.

CMake

Download and install the latest CMake release here. https://cmake.org/download/

git

Download and install git here. https://git-scm.com/

Build the analyzer:

mkdir build
cd build
cmake .. -A x64

Then, open the newly created solution file located here: build\async_rgb_led_analyzer.sln

Optionally, build from the command line without opening Visual Studio:

cmake --build .

The built analyzer DLLs will be located here:

build\Analyzers\Debug

build\Analyzers\Release

For debug and release builds, respectively.

Output Frame Format

Frame Type: "pixel"

Property Type Description
index int The index along the LED strip. Index 0 is the first LED
red int The red channel, [0-255]
green int The green channel, [0-255]
blue int The blue channel, [0-255]

Represents a single RGB pixel value

async-rgb-led-analyzer's People

Contributors

marcus10110 avatar schmicro avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

async-rgb-led-analyzer's Issues

The WS2811 LED bit timing tolerance should be wider

Existing tolerances can be found here:

"WS2811", "Worldsemi 24-bit RGB controller", 8, 3,

Taken from this datasheet:
https://cdn-shop.adafruit.com/datasheets/WS2811.pdf

Problem 1: The tolerance for the high speed operation is implemented as +/- 75ns. The datasheet is ambiguous, and I suggest increasing tolerance to +/-150ns.

Problem 2: Other datasheets for the WS2811 offer wildly different ranges:
e.g. this document (via google):
http://www.world-semi.com/DownLoadFile/129

I can't update this at the moment, and to complicate things, the tests for this analyzer haven't been migrated in yet from the original repo here:
https://github.com/saleae/AsyncRgbLedAnalyzer/tree/topics/testing

And I think updating these tolerances might break tests.

Add Settings option for customizing low/high duration tolerances at runtime

Suggestion: Add a boolean settings option that allows the user to input their own low/high tolerances. This would make it so that for every new serial RGB LED that comes out, this analyzer doesn't need to be updated with another drop-down option - the user can just tune it to their own.

I could see it working 2 ways - either it pre-populates the values based on what you selected, or it only becomes active if you select a new "custom" LED from the dropdown menu. I am not sure if settings can "interact" like that though (i.e. enable/disable/update setting A based on the value in setting B).

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.