| |
1 |
'''[wiki:GraspExtrasSoftware noisetone]''' |
| |
2 |
|
| |
3 |
[[TracNav(GraspExtrasContents)]] |
| |
4 |
|
| |
5 |
'''noisetone''' is a diagnostic tool that repeatedly reads out a small area from an attached CCD and interprets noise statistics as an audible tone. This is intended to assist diagnosing system noise performance without needing to repeatedly look at a screen whether a change to grounding, etc. made a change to readout noise. |
| |
6 |
|
| |
7 |
Invoked with no options, noisetone displays a basic summary of the available options: |
| |
8 |
|
| |
9 |
{{{ |
| |
10 |
% noisetone |
| |
11 |
STARGRASP Noise tool v0.10 |
| |
12 |
|
| |
13 |
usage: noisetone [options] |
| |
14 |
where [options] can be (default values shown in []) |
| |
15 |
c*ontroller= Hostname or IP of controller |
| |
16 |
d*ev= [0] Device to read out (0 or 1) |
| |
17 |
l*eft= [1] Device channel for left audio (0..7) |
| |
18 |
r*ight= [0] Device channel for right audio (0..7) |
| |
19 |
cell*row= [7] Device cell row read out (0..7, OTA only) |
| |
20 |
(Do not type the *. Letters after the * are optional.) |
| |
21 |
|
| |
22 |
Note: if the controller string is 'test.tone', noisetone |
| |
23 |
will not attempt to connect to a controller and will |
| |
24 |
instead generate a test tone. This is intended to make |
| |
25 |
troubleshooting on a new system easier. |
| |
26 |
|
| |
27 |
}}} |
| |
28 |
|
| |
29 |
The options are as follows: |
| |
30 |
|
| |
31 |
||'''option'''||'''Description''' ||'''Reqd?'''|| |
| |
32 |
||controller ||Hostname or IP address of controller for readout ||Y|| |
| |
33 |
||dev ||Controller device to be read out (0 or 1) ||N|| |
| |
34 |
||left ||A/D channel for device to be read out and played on the left audio channel (0-7). ||N|| |
| |
35 |
||right ||A/D channel for device to be read out and played on the right audio channel (0-7).||N|| |
| |
36 |
||cellrow ||For a connected OTA CCD, cell row to be read out (0-7) ||N|| |
| |
37 |
|
| |
38 |
Note that if the controller is the special string "'''test.tone'''", noisetone will not contact a controller but instead will play a test tone until interrupted. This is intended to allow troubleshooting of noisetone's operation on a new system. |
| |
39 |
|
| |
40 |
=== Sound Library === |
| |
41 |
|
| |
42 |
noisetone uses the open-source [http://www.portaudio.com/ portaudio] library to provide audio functionality. This has been tested on Ubuntu 10.04 as well as an older version of OS X (power PC). |
| |
43 |
|
| |
44 |
On Ubuntu, portaudio requires the ''libasound2-dev'' package to be installed. |
