This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
resources:tools-software:linux-software:colorimeter [18 May 2015 22:31] – removing linux code section Brandon Bushey | resources:tools-software:linux-software:colorimeter [24 May 2018 13:35] (current) – Add an important note to close iio-osc before starting the app. Istvan Csomortani | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== CN0363 Colorimeter Application User Guide ====== | ====== CN0363 Colorimeter Application User Guide ====== | ||
+ | ===== Starting the Application ===== | ||
+ | <note important> | ||
- | ===== Introduction ===== | + | {{: |
- | {{: | + | The CN0363 |
- | + | ||
- | {{: | + | |
- | + | ||
- | + | ||
- | The circuit shown above from [[adi>CN0363]] is a dual channel colorimeter featuring a modulated light source transmitter, | + | |
- | By using modulated light and digital synchronous detection, rather than a constant (dc) source, the system strongly rejects any noise sources at frequencies other than the modulation frequency, providing excellent accuracy. | + | |
- | The dual channel circuit measures the ratio of light absorbed by the liquids in the sample and reference containers at three different wavelengths. This forms the basis of many chemical analysis and environmental monitoring instruments used to measure concentrations and characterize materials through absorption spectroscopy. | + | |
- | + | ||
- | <note tip> | + | |
- | + | ||
- | <note tip>A complete design support package containing schematic, assembly drawing, layout files, Gerber files, and bill-of-materials is available at [[adi> | + | |
- | + | ||
- | ===== Equipment Needed ===== | + | |
- | The [[adi> | + | |
- | + | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | * Two vials: one filled with water and one filled with the sample liquid under test | + | |
- | | + | |
- | | + | |
- | + | ||
- | The equipment should be connected as shown below, but make sure all power is turned off before beginning the software installation. | + | |
- | + | ||
- | {{: | + | |
- | + | ||
- | ===== Software Installation ===== | + | |
- | + | ||
- | + | ||
- | An 8GB formatted and partitioned SD card is supplied with the CN0363 board. This SD card contains most of the images required to run the various FMC boards, but it must be updated before the application software for CN0363 is run. Use the following procedure: | + | |
- | + | ||
- | - Connect the HDMI monitor, power supply, keyboard/ | + | |
- | - Connect the EVAL-CN0373-PMDZ board to the ZedBoard, but do not connect the power at this time. | + | |
- | - Install the Analog Devices SD card in the ZedBoard | + | |
- | - Verify the jumpers (JP7-JP11, and JP6) are set to the SD Card Boot Mode as described in [[http:// | + | |
- | - Turn the ZedBoard power switch on. The board should boot after about 30 seconds. | + | |
- | - Enter "Update" | + | |
- | - When the update is complete, turn the ZedBoard power off. | + | |
- | - As an alternative, | + | |
- | - Turn the EVAL-CN0363-SDPZ power on. | + | |
- | - Turn the ZedBoard power on. | + | |
- | - Select the " | + | |
- | - The system is now ready to analyze samples. | + | |
<WRAP clear></ | <WRAP clear></ | ||
- | |||
- | ===== Source code ===== | ||
- | The source code for the Colorimeter application can be found on the [[https:// | ||
- | |||
- | |||
===== Analyzing a Sample ===== | ===== Analyzing a Sample ===== | ||
The Colorimeter application has three main tabs [[# | The Colorimeter application has three main tabs [[# | ||
+ | |||
===== Automated Data Collection ===== | ===== Automated Data Collection ===== | ||
+ | |||
{{ : | {{ : | ||
Line 66: | Line 21: | ||
==== Analyze Sample ==== | ==== Analyze Sample ==== | ||
- | Clicking the **Analyze Sample** button will perform | + | Clicking the **Analyze Sample** button will perform |
Once the analyzing process has finished it is also possible to either try to match the sample to a existing sample from the sample library or save the sample into the sample library for future use. | Once the analyzing process has finished it is also possible to either try to match the sample to a existing sample from the sample library or save the sample into the sample library for future use. | ||
+ | |||
==== Match Sample ==== | ==== Match Sample ==== | ||
Clicking the **Match Sample** button will compare the current sample to all samples in the sample library. If a sample is found that has a close enough matching score the sample including its name and match score will be displayed. | Clicking the **Match Sample** button will compare the current sample to all samples in the sample library. If a sample is found that has a close enough matching score the sample including its name and match score will be displayed. | ||
+ | |||
==== Save Sample ==== | ==== Save Sample ==== | ||
Line 100: | Line 57: | ||
{{ : | {{ : | ||
- | The sample library allows to manage and compare previously saved sample data. On the left side is a list of all samples. On the right side the absorbence | + | The sample library allows to manage and compare previously saved sample data. On the left side is a list of all samples. On the right side the absorbance |
Samples can also be removed from the library by selecting the sample and then clicking the **Remove** button. A sample that has been removed from the library can not be restored. | Samples can also be removed from the library by selecting the sample and then clicking the **Remove** button. A sample that has been removed from the library can not be restored. | ||
Line 109: | Line 66: | ||
{{ : | {{ : | ||
- | For optimum performance it is necessary to calibrate the application to the connected board and the environment. This calibration can be performed in the calibration dialog which can be opened | + | For optimum performance it is necessary to calibrate the application to the connected board and the environment. This calibration can be performed in the calibration dialog which can be opened |
Calibration must be performed with distilled water in both the reference and the sample probes. It is also recommended that during calibration the photo-diodes are shielded from ambient light. | Calibration must be performed with distilled water in both the reference and the sample probes. It is also recommended that during calibration the photo-diodes are shielded from ambient light. | ||
Start the automatic calibration procedure in the software; from the Menu | Start the automatic calibration procedure in the software; from the Menu | ||
- | bar, open the **Calibration** dialog box, and click **Calibrate**.Once the calibration is done the calibration values will be updated. | + | bar, open the **Calibration** dialog box, and click **Calibrate**. Once the calibration is done the calibration values will be updated. |
It is also possible to save the current calibration data for later use by clicking the **Export** button or to load previously saved calibration data by clicking the **Import** button. | It is also possible to save the current calibration data for later use by clicking the **Export** button or to load previously saved calibration data by clicking the **Import** button. | ||
Line 120: | Line 77: | ||
Calibration data includes a zero-offset for each channel and gain setting, which removes any potential offset that is measured if no excitation signal is present. The calibration data also includes a gain factor which expresses the relative relationship of the reference and sample channel values at full-scale excitation. | Calibration data includes a zero-offset for each channel and gain setting, which removes any potential offset that is measured if no excitation signal is present. The calibration data also includes a gain factor which expresses the relative relationship of the reference and sample channel values at full-scale excitation. | ||
+ | ===== Source code ===== | ||
+ | |||
+ | The source code for the Colorimeter application can be found on the [[https:// | ||
+ | |||
+ | <div> | ||
+ | **Install colorimeter application** | ||
+ | < | ||
+ | < | ||
+ | Cloning into ' | ||
+ | remote: Counting objects: 65, done. | ||
+ | remote: Compressing objects: 100% (33/33), done. | ||
+ | remote: Total 65 (delta 13), reused 2 (delta 2), pack-reused 28 | ||
+ | Unpacking objects: 100% (65/65), done. | ||
+ | Checking connectivity... done. | ||
+ | $ make | ||
+ | cc -shared -o capture.so capture.c -liio -lm -Wall -Wextra -fPIC -std=gnu99 -pedantic -O3 | ||
+ | $ make install | ||
+ | sed ' | ||
+ | sed ' | ||
+ | root@analog: | ||
+ | install -d // | ||
+ | install -d // | ||
+ | install -d // | ||
+ | install ./ | ||
+ | install ./ | ||
+ | install ./ | ||
+ | ./setup.py install --prefix=/ | ||
+ | running install | ||
+ | running build | ||
+ | running build_py | ||
+ | copying lib/ | ||
+ | running install_lib | ||
+ | copying build/ | ||
+ | byte-compiling / | ||
+ | running install_egg_info | ||
+ | Removing / | ||
+ | Writing / | ||
+ | xdg-icon-resource install --noupdate --size 16 ./ | ||
+ | xdg-icon-resource install --noupdate --size 32 ./ | ||
+ | xdg-icon-resource install --size 64 ./ | ||
+ | xdg-desktop-menu install adi-colorimeter.desktop</ | ||
+ | </ | ||
+ | </ | ||
===== Supported Devices ===== | ===== Supported Devices ===== | ||
- | [[adi> | + | * [[adi> |
+ | |||
+ | ===== More Information ===== | ||
- | [[http:// | + | * [[:resources: |