doc/FAQ

   1
   2 1.  Should I use CONFIG_MODVERSIONS when compiling a Linux kernel?
   3
   4 Short answer:  No.  Long answer: MODVERSIONS allows you to safely
   5 use a module on multiple kernel versions.  However, making comedi
   6 work with CONFIG_MODVERSIONS is a real pain.  Sometimes it works,
   7 sometimes it doesn't.
   8
   9
  10 2. I get the error message:
  11
  12 Makefile:14: /usr/src/linux/.config: No such file or directory
  13 make: *** No rule to make target `/usr/src/linux/.config'.  Stop.
  14
  15
  16 It means you don't have the file /usr/src/linux/.config.  This file
  17 contains all the configuration information about your linux kernel,
  18 which comedi needs in order to compile correctly.  Some distributions
  19 don't contain this file, so you will need to create your own, by
  20 compiling your own kernel.  This file is automatically created
  21 when you run 'make config', the first step in compiling a kernel.
  22
  23
  24 3. When compiling programs that use libcomedi, I get error message:
  25
  26 /usr/lib/libcomedi.a(range.o): In function `comedi_from_phys':
  27 range.o(.text+0x169): undefined reference to `floor'
  28
  29
  30 This error messsage indicates that the linker cannot resolve the
  31 reference to floor(), which is a function in the math library
  32 that is used in the function comedi_from_phys().  This only
  33 happens when you link statically.  Add '-lm' to your linking
  34 command.
  35
  36
  37 4. Someone on the mailing list told me to look in the kernel log.
  38 How do I do that?
  39
  40 Kernel log messages are continuously written to the file
  41 /var/log/messages.  In addition, a shortcut to get recent log
  42 messages is the 'dmesg' command, which will print the last 4-16 kB
  43 (depending on the kernel) of kernel log messages.
  44
  45
  46 5. I think I found a bug: I get Oops messages in the kernel log.
  47
  48 Oops messages always indicate a bug.  If you are not using the
  49 latest version of Comedi, please upgrade and try again, since
  50 these types of bugs are usually quickly fixed.  Look at the file
  51 BUG_REPORTING in the Linux kernel source, follow the instructions,
  52 and send the information to David Schleef <ds@schleef.org>.
  53
  54
  55 6. Could you please add a search engine to the mailing list archive?
  56
  57 No.  Please use generic web search engines such as Google, where you
  58 can add the search term "site:stm.lbl.gov" to limit the search to
  59 the site where the Comedi archives are located.
  60
  61
  62 7. I apply a signal to channel 0, but I see the signal on other
  63 channels.
  64
  65 Typically, this is an electrical problem that can come from multiple
  66 sources.  First, any inputs that are not specifically driven or
  67 grounded will tend to float around, measuring random electrical
  68 signals in their environment -- the strongest of which are usually
  69 nearby channels, 50/60 Hz line noise, or the A/D converter itself.
  70
  71
  72 8. An FFT of measured data shows lots of sharp peaks.
  73
  74 Yep.  Not much that can be done about that.  Well, actually, there is.
  75 Peaks near multiples of 50 or 60 Hz are electromagnetic coupling from
  76 the power mains.  Almost all the time, this indicates a ground loop
  77 in the measurement path.  Peaks that are multiples of 100 or 120 Hz
  78 on photodetectors are because of the room lights.  Peaks in the 100-1000
  79 Hz range, with harmonics, are sometimes stray fields from electric
  80 motors.  Strong, sharp peaks in the 1-100 kHz range are typically due
  81 to the horizontal refresh of CRT displays (like your computer monitor).
  82 Less strong peaks can be due to electronics in a computer or other
  83 device.
  84
  85 However, a sharp peak in an FFT does not always indicate a problem.
  86 Remember that you always have noise, and that some of it will be
  87 periodic.  You just have to make sure that the particular type of
  88 noise that you have does not affect your analysis.
  89
  90
  91 9. Ok, I'm getting good results.  What should I look at to get great
  92 results?
  93
  94  - Make sure that all unused inputs are grounded.  Electrically floating
  95    wires act as antennas, picking up stray electrical signals, and often
  96    strongly coupling them into the signals you actually want to measure.
  97
  98  - Get a flat panel monitor.  CRT displays emit strong magnetic fields
  99    oscillating at the horizontal refresh rate.  It is most easily
 100    observable in a Fourier transform of an input signal.
 101
 102  - Calibrate your board.
 103
 104  - Read up on ground loops.  Make sure that all your electrical
 105    shielding has exactly one path to a common ground.
 106
 107  - If you use a laptop for data acquisition, make sure it is grounded
 108    properly.  Laptops usually are not grounded, and you generally
 109    don't want your data acquisition cable to also be your grounding
 110    wire.
 111
 112  -
 113