kopia lustrzana https://gitlab.com/sane-project/backends
				
				
				
			
		
			
				
	
	
		
			448 wiersze
		
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
			
		
		
	
	
			448 wiersze
		
	
	
		
			11 KiB
		
	
	
	
		
			C
		
	
	
/* sane - Scanner Access Now Easy.
 | 
						|
 | 
						|
   Copyright (C) 2000 Kazuya Fukuda
 | 
						|
 | 
						|
   This file is part of the SANE package.
 | 
						|
 | 
						|
   This program is free software; you can redistribute it and/or
 | 
						|
   modify it under the terms of the GNU General Public License as
 | 
						|
   published by the Free Software Foundation; either version 2 of the
 | 
						|
   License, or (at your option) any later version.
 | 
						|
 | 
						|
   This program is distributed in the hope that it will be useful, but
 | 
						|
   WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
						|
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 | 
						|
   General Public License for more details.
 | 
						|
 | 
						|
   You should have received a copy of the GNU General Public License
 | 
						|
   along with this program; if not, write to the Free Software
 | 
						|
   Foundation, Inc., 59 Temple Place - Suite 330, Boston,
 | 
						|
   MA 02111-1307, USA.
 | 
						|
 | 
						|
   As a special exception, the authors of SANE give permission for
 | 
						|
   additional uses of the libraries contained in this release of SANE.
 | 
						|
 | 
						|
   The exception is that, if you link a SANE library with other files
 | 
						|
   to produce an executable, this does not by itself cause the
 | 
						|
   resulting executable to be covered by the GNU General Public
 | 
						|
   License.  Your use of that executable is in no way restricted on
 | 
						|
   account of linking the SANE library code into it.
 | 
						|
 | 
						|
   This exception does not, however, invalidate any other reasons why
 | 
						|
   the executable file might be covered by the GNU General Public
 | 
						|
   License.
 | 
						|
 | 
						|
   If you submit changes to SANE to the maintainers to be included in
 | 
						|
   a subsequent release, you agree by submitting the changes that
 | 
						|
   those changes may be distributed with this exception intact.
 | 
						|
 | 
						|
   If you write modifications of your own for SANE, it is your choice
 | 
						|
   whether to permit this exception to apply to your modifications.
 | 
						|
   If you do not wish that, delete this exception notice. */
 | 
						|
 | 
						|
#ifndef nec_h
 | 
						|
#define nec_h 1
 | 
						|
 | 
						|
#include <sys/types.h>
 | 
						|
 | 
						|
/* default values for configurable options.
 | 
						|
   Though these options are only meaningful if USE_FORK is defined,
 | 
						|
   they are 
 | 
						|
   DEFAULT_BUFFERS:      number of buffers allocated as shared memory
 | 
						|
                         for the data transfer from reader_process to
 | 
						|
                         read_data. The minimum value is 2
 | 
						|
   DEFAULT_BUFSIZE:      default size of one buffer. Must be greater
 | 
						|
                         than zero.
 | 
						|
   DEFAULT_QUEUED_READS: number of read requests queued by 
 | 
						|
                         sanei_scsi_req_enter. Since queued read requests
 | 
						|
                         are currently only supported for Linux and 
 | 
						|
                         DomainOS, this value should automatically be set
 | 
						|
                         dependent on the target OS...
 | 
						|
                         For Linux, 2 is the optimum; for DomainOS, I
 | 
						|
                         don't have any recommendation; other OS
 | 
						|
                         should use the value zero.
 | 
						|
   
 | 
						|
   The value for DEFAULT_BUFSIZE is probably too Linux-oriented...
 | 
						|
*/
 | 
						|
 | 
						|
#define DEFAULT_BUFFERS 12
 | 
						|
#define DEFAULT_BUFSIZE 128 * 1024
 | 
						|
#define DEFAULT_QUEUED_READS 2
 | 
						|
 | 
						|
#define NEC_MAJOR	0
 | 
						|
#define NEC_MINOR	12
 | 
						|
 | 
						|
typedef enum
 | 
						|
  {
 | 
						|
    OPT_NUM_OPTS = 0,
 | 
						|
 | 
						|
    OPT_MODE_GROUP,
 | 
						|
    OPT_MODE,
 | 
						|
    OPT_HALFTONE,
 | 
						|
    OPT_PAPER,
 | 
						|
    OPT_SCANSOURCE,
 | 
						|
    OPT_GAMMA,
 | 
						|
#ifdef USE_CUSTOM_GAMMA
 | 
						|
    OPT_CUSTOM_GAMMA,
 | 
						|
#endif
 | 
						|
    OPT_RESOLUTION_GROUP,
 | 
						|
#ifdef USE_RESOLUTION_LIST
 | 
						|
    OPT_RESOLUTION_LIST,
 | 
						|
#endif
 | 
						|
    OPT_RESOLUTION,
 | 
						|
 | 
						|
    OPT_GEOMETRY_GROUP,
 | 
						|
    OPT_TL_X,			/* top-left x */
 | 
						|
    OPT_TL_Y,			/* top-left y */
 | 
						|
    OPT_BR_X,			/* bottom-right x */
 | 
						|
    OPT_BR_Y,			/* bottom-right y */
 | 
						|
 | 
						|
    OPT_ENHANCEMENT_GROUP,
 | 
						|
    OPT_EDGE_EMPHASIS,
 | 
						|
    OPT_OR,
 | 
						|
    OPT_NR,
 | 
						|
    OPT_EDGE,
 | 
						|
    OPT_THRESHOLD,
 | 
						|
#ifdef USE_COLOR_THRESHOLD
 | 
						|
    OPT_THRESHOLD_R,
 | 
						|
    OPT_THRESHOLD_G,
 | 
						|
    OPT_THRESHOLD_B,
 | 
						|
#endif
 | 
						|
    OPT_LIGHTCOLOR,
 | 
						|
    OPT_TINT,
 | 
						|
    OPT_COLOR,
 | 
						|
    OPT_PREVIEW,
 | 
						|
 | 
						|
#ifdef USE_CUSTOM_GAMMA 
 | 
						|
    OPT_GAMMA_VECTOR,
 | 
						|
    OPT_GAMMA_VECTOR_R,
 | 
						|
    OPT_GAMMA_VECTOR_G,
 | 
						|
    OPT_GAMMA_VECTOR_B,
 | 
						|
#endif
 | 
						|
    /* must come last: */
 | 
						|
    NUM_OPTIONS
 | 
						|
  }
 | 
						|
NEC_Option;
 | 
						|
 | 
						|
#ifdef USE_FORK
 | 
						|
 | 
						|
/* status defines for a buffer: 
 | 
						|
   buffer not used / read request queued / buffer contains data
 | 
						|
*/
 | 
						|
#define SHM_EMPTY 0
 | 
						|
#define SHM_BUSY  1
 | 
						|
#define SHM_FULL  2
 | 
						|
typedef struct NEC_shmem_ctl
 | 
						|
  {
 | 
						|
    int shm_status;   /* can be SHM_EMPTY, SHM_BUSY, SHM_FULL */
 | 
						|
    size_t used;      /* number of bytes successfully read from scanner */
 | 
						|
    size_t nreq;      /* number of bytes requested from scanner */
 | 
						|
    size_t start;    /* index of the begin of used area of the buffer */
 | 
						|
    void *qid;
 | 
						|
    SANE_Byte *buffer;
 | 
						|
  }
 | 
						|
NEC_shmem_ctl;
 | 
						|
 | 
						|
typedef struct NEC_rdr_ctl
 | 
						|
  {
 | 
						|
    int cancel;      /* 1 = flag for the reader process to cancel */
 | 
						|
    int running; /* 1 indicates that the reader process is alive */
 | 
						|
    SANE_Status status; /* return status of the reader process */
 | 
						|
    NEC_shmem_ctl *buf_ctl;
 | 
						|
  }
 | 
						|
NEC_rdr_ctl;
 | 
						|
#endif /* USE_FORK */
 | 
						|
 | 
						|
typedef enum 
 | 
						|
  {
 | 
						|
    /* PCIN500, PCINXXX are used as array indices, so the corresponding
 | 
						|
       numbers should start at 0
 | 
						|
    */
 | 
						|
    unknown = -1,
 | 
						|
    PCIN500,
 | 
						|
    PCINXXX
 | 
						|
  }
 | 
						|
NEC_Model;
 | 
						|
 | 
						|
typedef struct NEC_Info
 | 
						|
  {
 | 
						|
    SANE_Range res_range;
 | 
						|
    SANE_Range tl_x_ranges[3]; /* normal / FSU / ADF */
 | 
						|
    SANE_Range br_x_ranges[3]; /* normal / FSU / ADF */
 | 
						|
    SANE_Range tl_y_ranges[3]; /* normal / FSU / ADF */
 | 
						|
    SANE_Range br_y_ranges[3]; /* normal / FSU / ADF */
 | 
						|
    SANE_Range threshold_range;
 | 
						|
    SANE_Range tint_range;
 | 
						|
    SANE_Range color_range;
 | 
						|
 | 
						|
    SANE_Int res_default;
 | 
						|
    SANE_Int x_default;
 | 
						|
    SANE_Int y_default;
 | 
						|
    SANE_Int bmu;
 | 
						|
    SANE_Int mud;
 | 
						|
    SANE_Int adf_fsu_installed;
 | 
						|
    SANE_String_Const scansources[5];
 | 
						|
    size_t buffers;
 | 
						|
    size_t bufsize;
 | 
						|
    int wanted_bufsize;
 | 
						|
    size_t queued_reads;
 | 
						|
  }
 | 
						|
NEC_Info;
 | 
						|
 | 
						|
typedef struct NEC_Sense_Data
 | 
						|
  {
 | 
						|
    NEC_Model model;
 | 
						|
    /* flag, if conditions like "paper jam" or "cover open" 
 | 
						|
       are considered as an error. Should be 0 for attach, else
 | 
						|
       a frontend might refuse to start, if the scanner returns
 | 
						|
       these errors.
 | 
						|
    */
 | 
						|
    int complain_on_adf_error;
 | 
						|
    /* Linux returns only 16 bytes of sense data... */
 | 
						|
    u_char sb[16]; 
 | 
						|
  }
 | 
						|
NEC_Sense_Data;
 | 
						|
 | 
						|
typedef struct NEC_Device
 | 
						|
  {
 | 
						|
    struct NEC_Device *next;
 | 
						|
    SANE_Device sane;
 | 
						|
    NEC_Info info;
 | 
						|
    /* xxx now part of sense data NEC_Model model; */
 | 
						|
    NEC_Sense_Data sensedat;
 | 
						|
  }
 | 
						|
NEC_Device;
 | 
						|
 | 
						|
typedef struct NEC_New_Device 
 | 
						|
  {
 | 
						|
    struct NEC_Device *dev;
 | 
						|
    struct NEC_New_Device *next;
 | 
						|
  }
 | 
						|
NEC_New_Device;
 | 
						|
 | 
						|
typedef struct NEC_Scanner
 | 
						|
  {
 | 
						|
    struct NEC_Scanner *next;
 | 
						|
    int fd;
 | 
						|
    NEC_Device *dev;
 | 
						|
    SANE_Option_Descriptor opt[NUM_OPTIONS];
 | 
						|
    Option_Value val[NUM_OPTIONS];
 | 
						|
    SANE_Parameters params;
 | 
						|
 | 
						|
    int    get_params_called;
 | 
						|
    SANE_Byte *buffer;    /* for color data re-ordering */
 | 
						|
    SANE_Int buf_used;
 | 
						|
    SANE_Int buf_pos;
 | 
						|
    SANE_Int modes;
 | 
						|
    SANE_Int res;
 | 
						|
    SANE_Int ulx;
 | 
						|
    SANE_Int uly;
 | 
						|
    SANE_Int width;
 | 
						|
    SANE_Int length;
 | 
						|
    SANE_Int threshold;
 | 
						|
    SANE_Int image_composition;
 | 
						|
    SANE_Int bpp;
 | 
						|
    SANE_Int halftone;
 | 
						|
    SANE_Bool reverse;
 | 
						|
    SANE_Bool or;
 | 
						|
    SANE_Bool nr;
 | 
						|
    SANE_Int gamma;
 | 
						|
    SANE_Int edge;
 | 
						|
    SANE_Int lightcolor;
 | 
						|
    SANE_Int adf_fsu_mode; /* mode selected by user */
 | 
						|
    SANE_Int adf_scan; /* flag, if the actual scan is an ADF scan */
 | 
						|
 | 
						|
    SANE_Int tint;
 | 
						|
    SANE_Int color;
 | 
						|
 | 
						|
    size_t bytes_to_read;
 | 
						|
    size_t max_lines_to_read;
 | 
						|
    size_t unscanned_lines;
 | 
						|
    SANE_Bool scanning;
 | 
						|
    SANE_Bool busy;
 | 
						|
    SANE_Bool cancel;
 | 
						|
#ifdef USE_CUSTOM_GAMMA
 | 
						|
    SANE_Int gamma_table[4][256];
 | 
						|
#endif
 | 
						|
#ifdef USE_FORK
 | 
						|
    pid_t reader_pid;
 | 
						|
    NEC_rdr_ctl   *rdr_ctl;
 | 
						|
    int shmid;
 | 
						|
    size_t read_buff; /* index of the buffer actually used by read_data */
 | 
						|
#endif /* USE_FORK */
 | 
						|
  }
 | 
						|
NEC_Scanner;
 | 
						|
 | 
						|
typedef struct NEC_Send
 | 
						|
{
 | 
						|
    SANE_Int dtc;
 | 
						|
    SANE_Int dtq;
 | 
						|
    SANE_Int length;
 | 
						|
    SANE_Byte *data;
 | 
						|
}
 | 
						|
NEC_Send;
 | 
						|
 | 
						|
typedef struct WPDH
 | 
						|
{
 | 
						|
    u_char wpdh[6];
 | 
						|
    u_char wdl[2];
 | 
						|
} 
 | 
						|
WPDH;
 | 
						|
 | 
						|
typedef struct WDB
 | 
						|
{
 | 
						|
    SANE_Byte wid;
 | 
						|
    SANE_Byte autobit;
 | 
						|
    SANE_Byte x_res[2];
 | 
						|
    SANE_Byte y_res[2];
 | 
						|
 | 
						|
    SANE_Byte x_ul[4];
 | 
						|
    SANE_Byte y_ul[4];
 | 
						|
    SANE_Byte width[4];
 | 
						|
    SANE_Byte length[4];
 | 
						|
 | 
						|
    SANE_Byte brightness;
 | 
						|
    SANE_Byte threshold;
 | 
						|
    SANE_Byte contrast;
 | 
						|
    SANE_Byte image_composition;
 | 
						|
    SANE_Byte bpp;
 | 
						|
 | 
						|
    SANE_Byte ht_pattern[2];
 | 
						|
    SANE_Byte rif_padding;
 | 
						|
    SANE_Byte bit_ordering[2];
 | 
						|
    SANE_Byte compression_type;
 | 
						|
    SANE_Byte compression_argument;
 | 
						|
    SANE_Byte reserved[6];
 | 
						|
}
 | 
						|
WDB;
 | 
						|
 | 
						|
/* "extension" of the window descriptor block for the PC-IN500 */
 | 
						|
typedef struct XWDBX500
 | 
						|
  {
 | 
						|
    SANE_Byte data_length;
 | 
						|
    SANE_Byte control;
 | 
						|
    SANE_Byte format;
 | 
						|
    SANE_Byte gamma;
 | 
						|
    SANE_Byte tint;
 | 
						|
    SANE_Byte color;
 | 
						|
    SANE_Byte reserved1;
 | 
						|
    SANE_Byte reserved2;
 | 
						|
  }
 | 
						|
WDBX500;
 | 
						|
 | 
						|
typedef struct window_param
 | 
						|
{
 | 
						|
    WPDH wpdh;
 | 
						|
    WDB wdb;
 | 
						|
    WDBX500 wdbx500;
 | 
						|
}
 | 
						|
window_param;
 | 
						|
 | 
						|
typedef struct mode_sense_param
 | 
						|
{
 | 
						|
    SANE_Byte mode_data_length;
 | 
						|
    SANE_Byte mode_param_header2;
 | 
						|
    SANE_Byte mode_param_header3;
 | 
						|
    SANE_Byte mode_desciptor_length;
 | 
						|
    SANE_Byte page_code;
 | 
						|
    SANE_Byte page_length; /* 6 */
 | 
						|
    SANE_Byte bmu;
 | 
						|
    SANE_Byte res2;
 | 
						|
    SANE_Byte mud[2];
 | 
						|
    SANE_Byte res3;
 | 
						|
    SANE_Byte res4;
 | 
						|
}
 | 
						|
mode_sense_param;
 | 
						|
 | 
						|
typedef struct mode_sense_subdevice
 | 
						|
{
 | 
						|
    SANE_Byte mode_data_length;
 | 
						|
    SANE_Byte mode_param_header2;
 | 
						|
    SANE_Byte mode_param_header3;
 | 
						|
    SANE_Byte mode_desciptor_length;
 | 
						|
    SANE_Byte res1[5];
 | 
						|
    SANE_Byte blocklength[3];
 | 
						|
    SANE_Byte page_code;
 | 
						|
    SANE_Byte page_length; /* 0x1a */
 | 
						|
    SANE_Byte a_mode_type;
 | 
						|
    SANE_Byte f_mode_type;
 | 
						|
    SANE_Byte res2;
 | 
						|
    SANE_Byte max_x[4];
 | 
						|
    SANE_Byte max_y[4];
 | 
						|
    SANE_Byte res3[2];
 | 
						|
    SANE_Byte x_basic_resolution[2];
 | 
						|
    SANE_Byte y_basic_resolution[2];
 | 
						|
    SANE_Byte x_max_resolution[2];
 | 
						|
    SANE_Byte y_max_resolution[2];
 | 
						|
    SANE_Byte x_min_resolution[2];
 | 
						|
    SANE_Byte y_min_resolution[2];
 | 
						|
    SANE_Byte res4;
 | 
						|
}
 | 
						|
mode_sense_subdevice;
 | 
						|
 | 
						|
typedef struct mode_select_param
 | 
						|
{
 | 
						|
    SANE_Byte mode_param_header1;
 | 
						|
    SANE_Byte mode_param_header2;
 | 
						|
    SANE_Byte mode_param_header3;
 | 
						|
    SANE_Byte mode_param_header4;
 | 
						|
    SANE_Byte page_code;
 | 
						|
    SANE_Byte page_length; /* 6 */
 | 
						|
    SANE_Byte res1;
 | 
						|
    SANE_Byte res2;
 | 
						|
    SANE_Byte mud[2];
 | 
						|
    SANE_Byte res3;
 | 
						|
    SANE_Byte res4;
 | 
						|
}
 | 
						|
mode_select_param;
 | 
						|
 | 
						|
typedef struct mode_select_subdevice
 | 
						|
{
 | 
						|
    SANE_Byte mode_param_header1;
 | 
						|
    SANE_Byte mode_param_header2;
 | 
						|
    SANE_Byte mode_param_header3;
 | 
						|
    SANE_Byte mode_param_header4;
 | 
						|
    SANE_Byte page_code;
 | 
						|
    SANE_Byte page_length; /*  0x1A */
 | 
						|
    SANE_Byte a_mode;
 | 
						|
    SANE_Byte f_mode;
 | 
						|
    SANE_Byte res[24];
 | 
						|
}
 | 
						|
mode_select_subdevice;
 | 
						|
 | 
						|
typedef struct buffer_status
 | 
						|
{
 | 
						|
    SANE_Byte data_length[3];
 | 
						|
    SANE_Byte block;
 | 
						|
    SANE_Byte window_id;
 | 
						|
    SANE_Byte reserved;
 | 
						|
    SANE_Byte bsa[3];      /* buffer space available */ 
 | 
						|
    SANE_Byte fdb[3];      /* filled data buffer */
 | 
						|
}
 | 
						|
buffer_status;
 | 
						|
 | 
						|
/* SCSI commands */
 | 
						|
#define TEST_UNIT_READY        0x00
 | 
						|
#define REQUEST_SENSE          0x03
 | 
						|
#define INQUIRY                0x12
 | 
						|
#define MODE_SELECT6           0x15
 | 
						|
#define RESERVE_UNIT           0x16
 | 
						|
#define RELEASE_UNIT           0x17
 | 
						|
#define MODE_SENSE6            0x1a
 | 
						|
#define SCAN                   0x1b
 | 
						|
#define SEND_DIAGNOSTIC        0x1d
 | 
						|
#define SET_WINDOW             0x24
 | 
						|
#define GET_WINDOW             0x25
 | 
						|
#define READ                   0x28
 | 
						|
#define SEND                   0x2a
 | 
						|
#define GET_DATA_BUFFER_STATUS 0x34
 | 
						|
 | 
						|
#define SENSE_LEN              18
 | 
						|
#define INQUIRY_LEN            36
 | 
						|
#define MODEPARAM_LEN          12
 | 
						|
#define MODE_SUBDEV_LEN        32
 | 
						|
#define WINDOW_LEN             76
 | 
						|
#define BUFFERSTATUS_LEN       12
 | 
						|
 | 
						|
#endif /* not nec_h */
 |