cpia.h
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:11k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. #ifndef cpia_h
  2. #define cpia_h
  3. /*
  4.  * CPiA Parallel Port Video4Linux driver
  5.  *
  6.  * Supports CPiA based parallel port Video Camera's.
  7.  *
  8.  * (C) Copyright 1999 Bas Huisman,
  9.  *                    Peter Pregler,
  10.  *                    Scott J. Bertin,
  11.  *                    VLSI Vision Ltd.
  12.  *
  13.  * This program is free software; you can redistribute it and/or modify
  14.  * it under the terms of the GNU General Public License as published by
  15.  * the Free Software Foundation; either version 2 of the License, or
  16.  * (at your option) any later version.
  17.  *
  18.  * This program is distributed in the hope that it will be useful,
  19.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21.  * GNU General Public License for more details.
  22.  *
  23.  * You should have received a copy of the GNU General Public License
  24.  * along with this program; if not, write to the Free Software
  25.  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  26.  */
  27. #define CPIA_MAJ_VER 0
  28. #define CPIA_MIN_VER    7
  29. #define CPIA_PATCH_VER 4
  30. #define CPIA_PP_MAJ_VER       0
  31. #define CPIA_PP_MIN_VER       7
  32. #define CPIA_PP_PATCH_VER     4
  33. #define CPIA_MAX_FRAME_SIZE_UNALIGNED (352 * 288 * 4)   /* CIF at RGB32 */
  34. #define CPIA_MAX_FRAME_SIZE ((CPIA_MAX_FRAME_SIZE_UNALIGNED + PAGE_SIZE - 1) & ~(PAGE_SIZE - 1)) /* align above to PAGE_SIZE */
  35. #ifdef __KERNEL__
  36. #include <asm/uaccess.h>
  37. #include <linux/videodev.h>
  38. #include <linux/smp_lock.h>
  39. struct cpia_camera_ops
  40. {
  41. /* open sets privdata to point to structure for this camera.
  42.          * Returns negative value on error, otherwise 0.
  43.  */
  44. int (*open)(void *privdata);
  45. /* Registers callback function cb to be called with cbdata
  46.  * when an image is ready.  If cb is NULL, only single image grabs
  47.  * should be used.  cb should immediately call streamRead to read
  48.  * the data or data may be lost. Returns negative value on error,
  49.  * otherwise 0.
  50.  */
  51. int (*registerCallback)(void *privdata, void (*cb)(void *cbdata),
  52.                         void *cbdata);
  53. /* transferCmd sends commands to the camera.  command MUST point to
  54.  * an  8 byte buffer in kernel space. data can be NULL if no extra
  55.  * data is needed.  The size of the data is given by the last 2
  56.  * bytes of command.  data must also point to memory in kernel space.
  57.  * Returns negative value on error, otherwise 0.
  58.  */
  59. int (*transferCmd)(void *privdata, u8 *command, u8 *data);
  60. /* streamStart initiates stream capture mode.
  61.  * Returns negative value on error, otherwise 0.
  62.  */
  63. int (*streamStart)(void *privdata);
  64. /* streamStop terminates stream capture mode.
  65.  * Returns negative value on error, otherwise 0.
  66.  */
  67. int (*streamStop)(void *privdata);
  68.         
  69. /* streamRead reads a frame from the camera.  buffer points to a
  70.          * buffer large enough to hold a complete frame in kernel space.
  71.          * noblock indicates if this should be a non blocking read.
  72.  * Returns the number of bytes read, or negative value on error.
  73.          */
  74. int (*streamRead)(void *privdata, u8 *buffer, int noblock);
  75. /* close disables the device until open() is called again.
  76.  * Returns negative value on error, otherwise 0.
  77.  */
  78. int (*close)(void *privdata);
  79. /* If wait_for_stream_ready is non-zero, wait until the streamState
  80.  * is STREAM_READY before calling streamRead.
  81.  */
  82. int wait_for_stream_ready;
  83. };
  84. struct cpia_frame {
  85. u8 *data;
  86. int count;
  87. int width;
  88. int height;
  89. volatile int state;
  90. };
  91. struct cam_params {
  92. struct {
  93. u8 firmwareVersion;
  94. u8 firmwareRevision;
  95. u8 vcVersion;
  96. u8 vcRevision;
  97. } version;
  98. struct {
  99. u16 vendor;
  100. u16 product;
  101. u16 deviceRevision;
  102. } pnpID;
  103. struct {
  104. u8 vpVersion;
  105. u8 vpRevision;
  106. u16 cameraHeadID;
  107. } vpVersion;
  108. struct {
  109. u8 systemState;
  110. u8 grabState;
  111. u8 streamState;
  112. u8 fatalError;
  113. u8 cmdError;
  114. u8 debugFlags;
  115. u8 vpStatus;
  116. u8 errorCode;
  117. } status;
  118. struct {
  119. u8 brightness;
  120. u8 contrast;
  121. u8 saturation;
  122. } colourParams;
  123. struct {
  124. u8 gainMode;
  125. u8 expMode;
  126. u8 compMode;
  127. u8 centreWeight;
  128. u8 gain;
  129. u8 fineExp;
  130. u8 coarseExpLo;
  131. u8 coarseExpHi;
  132. u8 redComp;
  133. u8 green1Comp;
  134. u8 green2Comp;
  135. u8 blueComp;
  136. } exposure;
  137. struct {
  138. u8 balanceModeIsAuto;
  139. u8 redGain;
  140. u8 greenGain;
  141. u8 blueGain;
  142. } colourBalance;
  143. struct {
  144. u8 divisor;
  145. u8 baserate;
  146. } sensorFps;
  147. struct {
  148. u8 gain1;
  149. u8 gain2;
  150. u8 gain4;
  151. u8 gain8;
  152. } apcor;
  153. struct {
  154. u8 flickerMode;
  155. u8 coarseJump;
  156. u8 allowableOverExposure;
  157. } flickerControl;
  158. struct {
  159. u8 gain1;
  160. u8 gain2;
  161. u8 gain4;
  162. u8 gain8;
  163. } vlOffset;
  164. struct {
  165. u8 mode;
  166. u8 decimation;
  167. } compression;
  168. struct {
  169. u8 frTargeting;
  170. u8 targetFR;
  171. u8 targetQ;
  172. } compressionTarget;
  173. struct {
  174. u8 yThreshold;
  175. u8 uvThreshold;
  176. } yuvThreshold;
  177. struct {
  178. u8 hysteresis;
  179. u8 threshMax;
  180. u8 smallStep;
  181. u8 largeStep;
  182. u8 decimationHysteresis;
  183. u8 frDiffStepThresh;
  184. u8 qDiffStepThresh;
  185. u8 decimationThreshMod;
  186. } compressionParams;
  187. struct {
  188. u8 videoSize; /* CIF/QCIF */
  189. u8 subSample;
  190. u8 yuvOrder;
  191. } format;
  192. struct {
  193. u8 colStart; /* skip first 8*colStart pixels */
  194. u8 colEnd; /* finish at 8*colEnd pixels */
  195. u8 rowStart; /* skip first 4*rowStart lines */
  196. u8 rowEnd; /* finish at 4*rowEnd lines */
  197. } roi;
  198. u8 ecpTiming;
  199. u8 streamStartLine;
  200. };
  201. enum v4l_camstates {
  202. CPIA_V4L_IDLE = 0,
  203. CPIA_V4L_ERROR,
  204. CPIA_V4L_COMMAND,
  205. CPIA_V4L_GRABBING,
  206. CPIA_V4L_STREAMING,
  207. CPIA_V4L_STREAMING_PAUSED,
  208. };
  209. #define FRAME_NUM 2 /* double buffering for now */
  210. struct cam_data {
  211. struct cam_data **previous;
  212. struct cam_data *next;
  213.         struct semaphore busy_lock;     /* guard against SMP multithreading */
  214. struct cpia_camera_ops *ops; /* lowlevel driver operations */
  215. void *lowlevel_data; /* private data for lowlevel driver */
  216. u8 *raw_image; /* buffer for raw image data */
  217. struct cpia_frame decompressed_frame;
  218.                                         /* buffer to hold decompressed frame */
  219. int image_size;         /* sizeof last decompressed image */
  220. int open_count; /* # of process that have camera open */
  221. /* camera status */
  222. int fps; /* actual fps reported by the camera */
  223. int transfer_rate; /* transfer rate from camera in kB/s */
  224. u8 mainsFreq; /* for flicker control */
  225. /* proc interface */
  226. struct semaphore param_lock; /* params lock for this camera */
  227. struct cam_params params; /* camera settings */
  228. struct proc_dir_entry *proc_entry; /* /proc/cpia/videoX */
  229. /* v4l */
  230. int video_size; /* VIDEO_SIZE_ */
  231. volatile enum v4l_camstates camstate; /* v4l layer status */
  232. struct video_device vdev; /* v4l videodev */
  233. struct video_picture vp; /* v4l camera settings */
  234. struct video_window vw; /* v4l capture area */
  235. /* mmap interface */
  236. int curframe; /* the current frame to grab into */
  237. u8 *frame_buf; /* frame buffer data */
  238.         struct cpia_frame frame[FRAME_NUM];
  239. /* FRAME_NUM-buffering, so we need a array */
  240. int first_frame;
  241. int mmap_kludge; /* 'wrong' byte order for mmap */
  242. volatile u32 cmd_queue; /* queued commands */
  243. };
  244. /* cpia_register_camera is called by low level driver for each camera.
  245.  * A unique camera number is returned, or a negative value on error */
  246. struct cam_data *cpia_register_camera(struct cpia_camera_ops *ops, void *lowlevel);
  247. /* cpia_unregister_camera is called by low level driver when a camera
  248.  * is removed.  This must not fail. */
  249. void cpia_unregister_camera(struct cam_data *cam);
  250. /* raw CIF + 64 byte header + (2 bytes line_length + EOL) per line + 4*EOI +
  251.  * one byte 16bit DMA alignment
  252.  */
  253. #define CPIA_MAX_IMAGE_SIZE ((352*288*2)+64+(288*3)+5)
  254. /* constant value's */
  255. #define MAGIC_0 0x19
  256. #define MAGIC_1 0x68
  257. #define DATA_IN 0xC0
  258. #define DATA_OUT 0x40
  259. #define VIDEOSIZE_QCIF 0 /* 176x144 */
  260. #define VIDEOSIZE_CIF 1 /* 352x288 */
  261. #define VIDEOSIZE_SIF 2 /* 320x240 */
  262. #define VIDEOSIZE_QSIF 3 /* 160x120 */
  263. #define VIDEOSIZE_48_48 4 /* where no one has gone before, iconsize! */
  264. #define VIDEOSIZE_64_48 5
  265. #define VIDEOSIZE_128_96 6
  266. #define VIDEOSIZE_160_120 VIDEOSIZE_QSIF
  267. #define VIDEOSIZE_176_144 VIDEOSIZE_QCIF
  268. #define VIDEOSIZE_192_144 7
  269. #define VIDEOSIZE_224_168 8
  270. #define VIDEOSIZE_256_192 9
  271. #define VIDEOSIZE_288_216 10
  272. #define VIDEOSIZE_320_240 VIDEOSIZE_SIF
  273. #define VIDEOSIZE_352_288 VIDEOSIZE_CIF
  274. #define VIDEOSIZE_88_72 11 /* quarter CIF */
  275. #define SUBSAMPLE_420 0
  276. #define SUBSAMPLE_422 1
  277. #define YUVORDER_YUYV 0
  278. #define YUVORDER_UYVY 1
  279. #define NOT_COMPRESSED 0
  280. #define COMPRESSED 1
  281. #define NO_DECIMATION 0
  282. #define DECIMATION_ENAB 1
  283. #define EOI 0xff /* End Of Image */
  284. #define EOL 0xfd /* End Of Line */
  285. #define FRAME_HEADER_SIZE 64
  286. /* Image grab modes */
  287. #define CPIA_GRAB_SINGLE 0
  288. #define CPIA_GRAB_CONTINUOUS 1
  289. /* Compression parameters */
  290. #define CPIA_COMPRESSION_NONE 0
  291. #define CPIA_COMPRESSION_AUTO 1
  292. #define CPIA_COMPRESSION_MANUAL 2
  293. #define CPIA_COMPRESSION_TARGET_QUALITY         0
  294. #define CPIA_COMPRESSION_TARGET_FRAMERATE       1
  295. /* Return offsets for GetCameraState */
  296. #define SYSTEMSTATE 0
  297. #define GRABSTATE 1
  298. #define STREAMSTATE 2
  299. #define FATALERROR 3
  300. #define CMDERROR 4
  301. #define DEBUGFLAGS 5
  302. #define VPSTATUS 6
  303. #define ERRORCODE 7
  304. /* SystemState */
  305. #define UNINITIALISED_STATE 0
  306. #define PASS_THROUGH_STATE 1
  307. #define LO_POWER_STATE 2
  308. #define HI_POWER_STATE 3
  309. #define WARM_BOOT_STATE 4
  310. /* GrabState */
  311. #define GRAB_IDLE 0
  312. #define GRAB_ACTIVE 1
  313. #define GRAB_DONE 2
  314. /* StreamState */
  315. #define STREAM_NOT_READY 0
  316. #define STREAM_READY 1
  317. #define STREAM_OPEN 2
  318. #define STREAM_PAUSED 3
  319. #define STREAM_FINISHED 4
  320. /* Fatal Error, CmdError, and DebugFlags */
  321. #define CPIA_FLAG   1
  322. #define SYSTEM_FLAG   2
  323. #define INT_CTRL_FLAG   4
  324. #define PROCESS_FLAG   8
  325. #define COM_FLAG  16
  326. #define VP_CTRL_FLAG  32
  327. #define CAPTURE_FLAG  64
  328. #define DEBUG_FLAG 128
  329. /* VPStatus */
  330. #define VP_STATE_OK 0x00
  331. #define VP_STATE_FAILED_VIDEOINIT 0x01
  332. #define VP_STATE_FAILED_AECACBINIT 0x02
  333. #define VP_STATE_AEC_MAX 0x04
  334. #define VP_STATE_ACB_BMAX 0x08
  335. #define VP_STATE_ACB_RMIN 0x10
  336. #define VP_STATE_ACB_GMIN 0x20
  337. #define VP_STATE_ACB_RMAX 0x40
  338. #define VP_STATE_ACB_GMAX 0x80
  339. /* ErrorCode */
  340. #define ERROR_FLICKER_BELOW_MIN_EXP     0x01 /*flicker exposure got below minimum exposure */
  341. #define ALOG(lineno,fmt,args...) printk(fmt,lineno,##args)
  342. #define LOG(fmt,args...) ALOG((__LINE__),KERN_INFO __FILE__":"__FUNCTION__"(%d):"fmt,##args)
  343. #ifdef _CPIA_DEBUG_
  344. #define ADBG(lineno,fmt,args...) printk(fmt, jiffies, lineno, ##args)
  345. #define DBG(fmt,args...) ADBG((__LINE__),KERN_DEBUG __FILE__"(%ld):"__FUNCTION__"(%d):"fmt,##args)
  346. #else
  347. #define DBG(fmn,args...) do {} while(0)
  348. #endif
  349. #define DEB_BYTE(p)
  350.   DBG("%1d %1d %1d %1d %1d %1d %1d %1d n",
  351.       (p)&0x80?1:0, (p)&0x40?1:0, (p)&0x20?1:0, (p)&0x10?1:0,
  352.         (p)&0x08?1:0, (p)&0x04?1:0, (p)&0x02?1:0, (p)&0x01?1:0);
  353. #define ADD_TO_LIST(l, drv) 
  354.   {
  355.     lock_kernel();
  356.     (drv)->next = l;
  357.     (drv)->previous = &(l);
  358.     (l) = drv;
  359.     unlock_kernel();
  360.   } while(0)
  361. #define REMOVE_FROM_LIST(drv) 
  362.   {
  363.     if ((drv)->previous != NULL) {
  364.       lock_kernel();
  365.       if ((drv)->next != NULL)
  366.         (drv)->next->previous = (drv)->previous;
  367.       *((drv)->previous) = (drv)->next;
  368.       (drv)->previous = NULL;
  369.       (drv)->next = NULL;
  370.       unlock_kernel();
  371.     }
  372.   } while (0)
  373. static inline void cpia_add_to_list(struct cam_data* l, struct cam_data* drv)
  374. {
  375. drv->next = l;
  376. drv->previous = &l;
  377. l = drv;
  378. }
  379. static inline void cpia_remove_from_list(struct cam_data* drv)
  380. {
  381. if (drv->previous != NULL) {
  382. if (drv->next != NULL)
  383. drv->next->previous = drv->previous;
  384. *(drv->previous) = drv->next;
  385. drv->previous = NULL;
  386. drv->next = NULL;
  387. }
  388. }
  389. #endif /* __KERNEL__ */
  390. #endif /* cpia_h */