Blame view

kernel/linux-imx6_3.14.28/Documentation/misc-devices/bh1770glc.txt 3.51 KB
6b13f685e   김민수   BSP 최초 추가
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
  Kernel driver bh1770glc
  =======================
  
  Supported chips:
  ROHM BH1770GLC
  OSRAM SFH7770
  
  Data sheet:
  Not freely available
  
  Author:
  Samu Onkalo <samu.p.onkalo@nokia.com>
  
  Description
  -----------
  BH1770GLC and SFH7770 are combined ambient light and proximity sensors.
  ALS and proximity parts operates on their own, but they shares common I2C
  interface and interrupt logic. In principle they can run on their own,
  but ALS side results are used to estimate reliability of the proximity sensor.
  
  ALS produces 16 bit lux values. The chip contains interrupt logic to produce
  low and high threshold interrupts.
  
  Proximity part contains IR-led driver up to 3 IR leds. The chip measures
  amount of reflected IR light and produces proximity result. Resolution is
  8 bit. Driver supports only one channel. Driver uses ALS results to estimate
  reliability of the proximity results. Thus ALS is always running while
  proximity detection is needed.
  
  Driver uses threshold interrupts to avoid need for polling the values.
  Proximity low interrupt doesn't exists in the chip. This is simulated
  by using a delayed work. As long as there is proximity threshold above
  interrupts the delayed work is pushed forward. So, when proximity level goes
  below the threshold value, there is no interrupt and the delayed work will
  finally run. This is handled as no proximity indication.
  
  Chip state is controlled via runtime pm framework when enabled in config.
  
  Calibscale factor is used to hide differences between the chips. By default
  value set to neutral state meaning factor of 1.00. To get proper values,
  calibrated source of light is needed as a reference. Calibscale factor is set
  so that measurement produces about the expected lux value.
  
  SYSFS
  -----
  
  chip_id
  	RO - shows detected chip type and version
  
  power_state
  	RW - enable / disable chip. Uses counting logic
  	     1 enables the chip
  	     0 disables the chip
  
  lux0_input
  	RO - measured lux value
  	     sysfs_notify called when threshold interrupt occurs
  
  lux0_sensor_range
  	RO - lux0_input max value
  
  lux0_rate
  	RW - measurement rate in Hz
  
  lux0_rate_avail
  	RO - supported measurement rates
  
  lux0_thresh_above_value
  	RW - HI level threshold value. All results above the value
  	     trigs an interrupt. 65535 (i.e. sensor_range) disables the above
  	     interrupt.
  
  lux0_thresh_below_value
  	RW - LO level threshold value. All results below the value
  	     trigs an interrupt. 0 disables the below interrupt.
  
  lux0_calibscale
  	RW - calibration value. Set to neutral value by default.
  	     Output results are multiplied with calibscale / calibscale_default
  	     value.
  
  lux0_calibscale_default
  	RO - neutral calibration value
  
  prox0_raw
  	RO - measured proximity value
  	     sysfs_notify called when threshold interrupt occurs
  
  prox0_sensor_range
  	RO - prox0_raw max value
  
  prox0_raw_en
  	RW - enable / disable proximity - uses counting logic
  	     1 enables the proximity
  	     0 disables the proximity
  
  prox0_thresh_above_count
  	RW - number of proximity interrupts needed before triggering the event
  
  prox0_rate_above
  	RW - Measurement rate (in Hz) when the level is above threshold
  	     i.e. when proximity on has been reported.
  
  prox0_rate_below
  	RW - Measurement rate (in Hz) when the level is below threshold
  	     i.e. when proximity off has been reported.
  
  prox0_rate_avail
  	RO - Supported proximity measurement rates in Hz
  
  prox0_thresh_above0_value
  	RW - threshold level which trigs proximity events.
  	     Filtered by persistence filter (prox0_thresh_above_count)
  
  prox0_thresh_above1_value
  	RW - threshold level which trigs event immediately