taborlab / Iris

The Light Program Interface
BSD 3-Clause "New" or "Revised" License
12 stars 2 forks source link

Document calibration procedure and flashing new config.h calibration file to the device #193

Closed SynbioLucas closed 9 years ago

SynbioLucas commented 9 years ago

Currently, the largest hurdle in usability is flashing the firmware to the device after calibration. Short of making an interface for calibrating, we have to at least document thoroughly all the steps in:

Calibration

  1. Placing all LEDs in the device so they're consistently oriented.
  2. Imaging the device in a gel imager to acquire calibration data. Note ensuring a correct GS setting is used to avoid saturation.
  3. How to use the Matlab software to create calibration settings. Also indicate how to iterate using previous calibration settings.

    Flashing new firmware

  4. How to use Amtel studio. How to set up file structure and configure compiler correctly.
  5. Incorporating the calibration settings into the config.h file correctly. Difference between setting DC & GS (64 vs 255 settings).
  6. (Re)building the code.
  7. Flashing to the device. Specify all required flash/interface settings.

Ideally, all these steps will include images and extensive descriptions of all steps in order to limit the number of support requests we get. In the 'beta' phase, this was the single most difficult and troublesome series of issues people encountered.

BrianLandry commented 9 years ago

I don't think this is at all related to the LPI. So it doesn't make much sense to have it as an issue here.