Dave Cohen / SI1141

Library for using SI1141 sensor

Fork of SI1143 by Guillermo Torijano

SI1143.cpp@7:f1303b85db58, 2014-05-14 (annotated)

Committer:
dmcohen24
Date:
Wed May 14 19:01:05 2014 +0000
Revision:
7:f1303b85db58
Parent:
5:3fadc61598bc
Child:
8:70933bf445af
Adjusted library to work with SI1141;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
GAT27 2:21381f11a5af 1 /**
GAT27 2:21381f11a5af 2 * @author Guillermo A Torijano
GAT27 2:21381f11a5af 3 *
GAT27 2:21381f11a5af 4 * @section LICENSE
GAT27 2:21381f11a5af 5 *
GAT27 2:21381f11a5af 6 * Permission is hereby granted, free of charge, to any person obtaining a copy
GAT27 2:21381f11a5af 7 * of this software and associated documentation files (the "Software"), to deal
GAT27 2:21381f11a5af 8 * in the Software without restriction, including without limitation the rights
GAT27 2:21381f11a5af 9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
GAT27 2:21381f11a5af 10 * copies of the Software, and to permit persons to whom the Software is
GAT27 2:21381f11a5af 11 * furnished to do so, subject to the following conditions:
GAT27 2:21381f11a5af 12 *
GAT27 2:21381f11a5af 13 * The above copyright notice and this permission notice shall be included in
GAT27 2:21381f11a5af 14 * all copies or substantial portions of the Software.
GAT27 2:21381f11a5af 15 *
GAT27 2:21381f11a5af 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
GAT27 2:21381f11a5af 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
GAT27 2:21381f11a5af 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
GAT27 2:21381f11a5af 19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
GAT27 2:21381f11a5af 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
GAT27 2:21381f11a5af 21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
GAT27 2:21381f11a5af 22 * THE SOFTWARE.
GAT27 2:21381f11a5af 23 *
GAT27 2:21381f11a5af 24 * @section DESCRIPTION
GAT27 2:21381f11a5af 25 *
GAT27 2:21381f11a5af 26 * Parallax SI1143 Gesture Sensor.
GAT27 2:21381f11a5af 27 *
GAT27 2:21381f11a5af 28 * Datasheet:
GAT27 2:21381f11a5af 29 *
GAT27 2:21381f11a5af 30 * http://www.silabs.com/Support%20Documents/TechnicalDocs/Si114x.pdf
GAT27 2:21381f11a5af 31 */
GAT27 2:21381f11a5af 32
GAT27 0:18ebb7348150 33 #include "SI1143.h"
GAT27 0:18ebb7348150 34
GAT27 0:18ebb7348150 35 SI1143::SI1143(PinName sda, PinName scl)
GAT27 0:18ebb7348150 36 {
GAT27 0:18ebb7348150 37 wait_ms(30);
GAT27 0:18ebb7348150 38 i2c_ = new I2C(sda, scl);
GAT27 5:3fadc61598bc 39 // 3.4MHz, as specified by the datasheet, but DO NOT USE.
GAT27 1:28beeb2f209b 40 //i2c_->frequency(3400000);
GAT27 0:18ebb7348150 41
GAT27 4:af8f820733e0 42 restart();
GAT27 4:af8f820733e0 43 }
GAT27 4:af8f820733e0 44
GAT27 4:af8f820733e0 45 void SI1143::restart()
GAT27 4:af8f820733e0 46 {
GAT27 0:18ebb7348150 47 command(RESET);
GAT27 0:18ebb7348150 48 wait_ms(30);
GAT27 0:18ebb7348150 49
GAT27 5:3fadc61598bc 50 // Setting up LED Power to full
GAT27 5:3fadc61598bc 51 write_reg(HW_KEY,HW_KEY_VAL0);
dmcohen24 7:f1303b85db58 52 write_reg(PS_LED21,0x0F); // Was 0x0A
dmcohen24 7:f1303b85db58 53 write_reg(PS_LED3,0x00);
dmcohen24 7:f1303b85db58 54 //write_reg(PS_LED21,0xAA);
dmcohen24 7:f1303b85db58 55 //write_reg(PS_LED3,0x0A);
dmcohen24 7:f1303b85db58 56 //write_reg(PARAM_WR, ALS_IR_TASK + ALS_VIS_TASK + PS1_TASK + PS2_TASK + PS3_TASK);
dmcohen24 7:f1303b85db58 57 write_reg(PARAM_WR, ALS_IR_TASK + ALS_VIS_TASK + PS1_TASK);
GAT27 0:18ebb7348150 58
GAT27 0:18ebb7348150 59 command(PARAM_SET + (CHLIST & 0x1F));
GAT27 0:18ebb7348150 60
GAT27 0:18ebb7348150 61 write_reg(INT_CFG,0);
GAT27 0:18ebb7348150 62 write_reg(IRQ_ENABLE,0);
GAT27 0:18ebb7348150 63 write_reg(IRQ_MODE1,0);
GAT27 0:18ebb7348150 64 write_reg(IRQ_MODE2,0);
dmcohen24 7:f1303b85db58 65
dmcohen24 7:f1303b85db58 66 //write_reg(PS_ADC_MISC,0x24);
dmcohen24 7:f1303b85db58 67 //write_reg(PS1_ADCMUX,0x03);
GAT27 0:18ebb7348150 68 }
GAT27 0:18ebb7348150 69
GAT27 0:18ebb7348150 70 void SI1143::command(char cmd)
GAT27 0:18ebb7348150 71 {
GAT27 0:18ebb7348150 72 int val;
GAT27 0:18ebb7348150 73
GAT27 0:18ebb7348150 74 val = read_reg(RESPONSE,1);
GAT27 0:18ebb7348150 75 while(val!=0)
GAT27 0:18ebb7348150 76 {
GAT27 0:18ebb7348150 77 write_reg(COMMAND,NOP);
GAT27 0:18ebb7348150 78 val = read_reg(RESPONSE,1);
GAT27 0:18ebb7348150 79 }
GAT27 0:18ebb7348150 80 do{
GAT27 0:18ebb7348150 81 write_reg(COMMAND,cmd);
GAT27 0:18ebb7348150 82 if(cmd==RESET) break;
GAT27 0:18ebb7348150 83 val = read_reg(RESPONSE,1);
GAT27 0:18ebb7348150 84 }while(val==0);
GAT27 0:18ebb7348150 85 }
GAT27 0:18ebb7348150 86
GAT27 1:28beeb2f209b 87 char SI1143::read_reg(/*unsigned*/ char address, int num_data) // Read a register
GAT27 0:18ebb7348150 88 {
GAT27 0:18ebb7348150 89 char tx[1];
GAT27 0:18ebb7348150 90 char rx[1];
GAT27 0:18ebb7348150 91
GAT27 1:28beeb2f209b 92 //i2c_->start();
GAT27 0:18ebb7348150 93 tx[0] = address;
GAT27 0:18ebb7348150 94 i2c_->write((IR_ADDRESS << 1) & 0xFE, tx, num_data);
GAT27 0:18ebb7348150 95 wait_ms(1);
GAT27 1:28beeb2f209b 96 //i2c_->stop();
GAT27 0:18ebb7348150 97
GAT27 1:28beeb2f209b 98 //i2c_->start();
GAT27 0:18ebb7348150 99 i2c_->read((IR_ADDRESS << 1) | 0x01, rx, num_data);
GAT27 0:18ebb7348150 100 wait_ms(1);
GAT27 1:28beeb2f209b 101 //i2c_->stop();
GAT27 0:18ebb7348150 102
GAT27 0:18ebb7348150 103 return rx[0];
GAT27 0:18ebb7348150 104 }
GAT27 0:18ebb7348150 105
GAT27 1:28beeb2f209b 106 void SI1143::write_reg(char address, char num_data) // Write a resigter
GAT27 1:28beeb2f209b 107 {
GAT27 0:18ebb7348150 108 char tx[2];
GAT27 5:3fadc61598bc 109
GAT27 5:3fadc61598bc 110 //i2c_->start();
GAT27 0:18ebb7348150 111 tx[0] = address;
GAT27 0:18ebb7348150 112 tx[1] = num_data;
GAT27 0:18ebb7348150 113 i2c_->write((IR_ADDRESS << 1) & 0xFE, tx, 2);
GAT27 0:18ebb7348150 114 wait_ms(1);
GAT27 1:28beeb2f209b 115 //i2c_->stop();
GAT27 0:18ebb7348150 116 }
GAT27 0:18ebb7348150 117
GAT27 5:3fadc61598bc 118 void SI1143::bias(int ready, int repeat)
GAT27 0:18ebb7348150 119 {
GAT27 5:3fadc61598bc 120 wait(ready);
dmcohen24 7:f1303b85db58 121 bias1 = 0; //get_ps1(repeat);
GAT27 5:3fadc61598bc 122 bias2 = get_ps2(repeat);
GAT27 5:3fadc61598bc 123 bias3 = get_ps3(repeat);
GAT27 0:18ebb7348150 124 }
GAT27 0:18ebb7348150 125
GAT27 5:3fadc61598bc 126 int SI1143::get_ps1(int repeat) // Read the data for the first LED
GAT27 0:18ebb7348150 127 {
GAT27 5:3fadc61598bc 128 int stack = 0;
GAT27 5:3fadc61598bc 129
GAT27 0:18ebb7348150 130 command(PSALS_FORCE);
GAT27 0:18ebb7348150 131
GAT27 5:3fadc61598bc 132 for(int r=repeat; r>0; r=r-1)
GAT27 5:3fadc61598bc 133 {
GAT27 5:3fadc61598bc 134 LowB = read_reg(PS1_DATA0,1);
GAT27 5:3fadc61598bc 135 HighB = read_reg(PS1_DATA1,1);
GAT27 5:3fadc61598bc 136 stack = stack + (HighB * 256) + LowB;
GAT27 5:3fadc61598bc 137 }
GAT27 5:3fadc61598bc 138 PS1 = stack / repeat;
GAT27 0:18ebb7348150 139
GAT27 0:18ebb7348150 140 if(PS1 > bias1)
GAT27 0:18ebb7348150 141 PS1 = PS1 - bias1;
GAT27 0:18ebb7348150 142 else
GAT27 0:18ebb7348150 143 PS1 = 0;
GAT27 5:3fadc61598bc 144
GAT27 5:3fadc61598bc 145 return PS1;
GAT27 5:3fadc61598bc 146 }
GAT27 5:3fadc61598bc 147
GAT27 5:3fadc61598bc 148 int SI1143::get_ps2(int repeat) // Read the data for the second LED
GAT27 5:3fadc61598bc 149 {
GAT27 5:3fadc61598bc 150 int stack = 0;
GAT27 5:3fadc61598bc 151
GAT27 5:3fadc61598bc 152 command(PSALS_FORCE);
GAT27 5:3fadc61598bc 153
GAT27 5:3fadc61598bc 154 for(int r=repeat; r>0; r=r-1)
GAT27 5:3fadc61598bc 155 {
GAT27 5:3fadc61598bc 156 LowB = read_reg(PS2_DATA0,1);
GAT27 5:3fadc61598bc 157 HighB = read_reg(PS2_DATA1,1);
GAT27 5:3fadc61598bc 158 stack = stack + (HighB * 256) + LowB;
GAT27 5:3fadc61598bc 159 }
GAT27 5:3fadc61598bc 160 PS2 = stack / repeat;
GAT27 5:3fadc61598bc 161
GAT27 0:18ebb7348150 162 if(PS2 > bias2)
GAT27 0:18ebb7348150 163 PS2 = PS2 - bias2;
GAT27 0:18ebb7348150 164 else
GAT27 0:18ebb7348150 165 PS2 = 0;
GAT27 5:3fadc61598bc 166
GAT27 5:3fadc61598bc 167 return PS2;
GAT27 5:3fadc61598bc 168 }
GAT27 5:3fadc61598bc 169
GAT27 5:3fadc61598bc 170 int SI1143::get_ps3(int repeat) // Read the data for the third LED
GAT27 5:3fadc61598bc 171 {
GAT27 5:3fadc61598bc 172 int stack = 0;
GAT27 5:3fadc61598bc 173
GAT27 5:3fadc61598bc 174 command(PSALS_FORCE);
GAT27 5:3fadc61598bc 175
GAT27 5:3fadc61598bc 176 for(int r=repeat; r>0; r=r-1)
GAT27 5:3fadc61598bc 177 {
GAT27 5:3fadc61598bc 178 LowB = read_reg(PS3_DATA0,1);
GAT27 5:3fadc61598bc 179 HighB = read_reg(PS3_DATA1,1);
GAT27 5:3fadc61598bc 180 stack = stack + (HighB * 256) + LowB;
GAT27 5:3fadc61598bc 181 }
GAT27 5:3fadc61598bc 182 PS3 = stack / repeat;
GAT27 5:3fadc61598bc 183
GAT27 0:18ebb7348150 184 if(PS3 > bias3)
GAT27 0:18ebb7348150 185 PS3 = PS3 - bias3;
GAT27 0:18ebb7348150 186 else
GAT27 0:18ebb7348150 187 PS3 = 0;
GAT27 0:18ebb7348150 188
GAT27 5:3fadc61598bc 189 return PS3;
GAT27 0:18ebb7348150 190 }
GAT27 2:21381f11a5af 191
GAT27 5:3fadc61598bc 192 int SI1143::get_vis(int repeat) // Read the data for ambient light
GAT27 5:3fadc61598bc 193 {
GAT27 5:3fadc61598bc 194 int stack = 0;
GAT27 5:3fadc61598bc 195
GAT27 5:3fadc61598bc 196 command(PSALS_FORCE);
GAT27 5:3fadc61598bc 197
GAT27 5:3fadc61598bc 198 for(int r=repeat; r>0; r=r-1)
GAT27 5:3fadc61598bc 199 {
GAT27 5:3fadc61598bc 200 LowB = read_reg(ALS_VIS_DATA0,1);
GAT27 5:3fadc61598bc 201 HighB = read_reg(ALS_VIS_DATA1,1);
GAT27 5:3fadc61598bc 202 VIS = stack + (HighB * 256) + LowB;
GAT27 5:3fadc61598bc 203 }
GAT27 5:3fadc61598bc 204 VIS = stack / repeat;
GAT27 5:3fadc61598bc 205
GAT27 5:3fadc61598bc 206 return VIS;
GAT27 5:3fadc61598bc 207 }
GAT27 4:af8f820733e0 208
GAT27 5:3fadc61598bc 209 int SI1143::get_ir(int repeat) // Read the data for infrared light
GAT27 5:3fadc61598bc 210 {
GAT27 5:3fadc61598bc 211 int stack = 0;
GAT27 5:3fadc61598bc 212
GAT27 5:3fadc61598bc 213 command(PSALS_FORCE);
GAT27 5:3fadc61598bc 214
GAT27 5:3fadc61598bc 215 for(int r=repeat; r>0; r=r-1)
GAT27 5:3fadc61598bc 216 {
GAT27 5:3fadc61598bc 217 LowB = read_reg(ALS_IR_DATA0,1);
GAT27 5:3fadc61598bc 218 HighB = read_reg(ALS_IR_DATA1,1);
GAT27 5:3fadc61598bc 219 IR = stack + (HighB * 256) + LowB;
GAT27 5:3fadc61598bc 220 }
GAT27 5:3fadc61598bc 221 IR = stack / repeat;
GAT27 5:3fadc61598bc 222
GAT27 5:3fadc61598bc 223 return IR;
GAT27 5:3fadc61598bc 224 }