ch.aplu.ev3

Class PrototypeSensor

java.lang.Object

ch.aplu.ev3.Part

ch.aplu.ev3.Sensor

ch.aplu.ev3.I2CSensor

ch.aplu.ev3.PrototypeSensor

public class PrototypeSensor
extends I2CSensor

Class that represents a prototype sensor (HiTechnic NXT Prototype Board). The following register layout is assumed:
Device address 0x02
0x00-0x07 Version number
0x08-0x0F Manufacturer
0x10-0x17 Sensor type
0x42 Analog channel 0, pin A0, upper 8bits
0x43 Analog channel 0, pin A0, lower 2bits
0x44 Analog channel 1, pin A1, upper 8bits
0x45 Analog channel 1, pin A1, lower 2bits
0x46 Analog channel 2, pin A2, upper 8bits
0x47 Analog channel 2, pin A2, lower 2bits
0x48 Analog channel 3, pin A3, upper 8bits
0x49 Analog channel 3, pin A3, lower 2bits
0x4A Analog channel 4, pin A4, upper 8bits
0x4B Analog channel 4, pin A4, lower 2bits
0x4C Digital input channels, bits 0..5
0x4D Digitag output channels, bits 0..5
0x4E Digital control, bits 0..5, low: input (default), high: output
0x4F Sampling time 4..100(ms)

Analog inputs in range 0..3.3V, 10 bit (0..1023)
Digital inputs/outputs 0/3.3V, pins B0..B5, max. 12mA per output (high or low)
The inputs must stay within the 0 - 3.3V range. If this is not observed, damage will occur. The inputs are 3.3V CMOS compatible: low: < 1.0V high: > 2.3V

Constructor Summary

Constructors

Constructor and Description
PrototypeSensor() Creates a sensor instance connected to port S1.
PrototypeSensor(SensorPort port) Creates a sensor instance connected to the given port.

Method Summary

Methods

Modifier and Type	Method and Description
void	read(int[] ain, int[] din) Reads the sensor.
void	readAnalog(int[] ain) Reads the sensor.
void	readDigital(int[] din) Reads the sensor.
void	setDIO(int[] ioControl) Sets the direction of the 6 digital input/output channels.
void	setDIOMask(int mask) Sets the direction of the 6 digital input/output channels.
void	setSamplingPeriod(int period) Sets the sampling period of the ADC (4..100 ms, default 4 ms).
void	write(int[] dout) Writes the given bit state (low/high) to the digital output channels.
void	writeByte(int value) Writes the given byte to the digital output channels.

Methods inherited from class ch.aplu.ev3.I2CSensor

getData, getData, getLejosI2CSensor, getProductID, getVersion, sendData, sendData, sendData

Methods inherited from class ch.aplu.ev3.Sensor

getLejosPort

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PrototypeSensor

public PrototypeSensor(SensorPort port)

Creates a sensor instance connected to the given port. (default: all digital channels as input)

Parameters:

port - the port where the sensor is plugged-in

PrototypeSensor

public PrototypeSensor()

Creates a sensor instance connected to port S1. (default: all digital channels as input)

Method Detail

setDIO

public void setDIO(int[] ioControl)

Sets the direction of the 6 digital input/output channels. (default: all digital channels as input)-

Parameters:

ioControl - the direction of each channel. 0: input, 1: output

setDIOMask

public void setDIOMask(int mask)

Sets the direction of the 6 digital input/output channels. The bit #n corresponds to channel #n; bit value 0: input, 1: output (default: all digital channels as input)

Parameters:

mask - the bit mask

readAnalog

public void readAnalog(int[] ain)

Reads the sensor. Analog input data 0..1023 (corresponding to 0..3.3 V) are returned in the given ain.

Parameters:

ain - an integer array of length 5 where to get the analog values

readDigital

public void readDigital(int[] din)

Reads the sensor. Digital input data 0 (corresponds to low state, 0 V) or 1 (corresponds to high state, 3.3 V) is returned in the given din. For digital channels defined as outputs -1 is returned.

Parameters:

din - an integer array of length 6 where to get the digital values

read

public void read(int[] ain,
        int[] din)

Reads the sensor. Analog input data 0..1023 (corresponding to 0..3.3 V) are returned in the given ain, digital input data (0, 1) in the given din. For digital channels defined as outputs -1 is returned.

Parameters:

ain - an integer array of length 5 where to get the analog values

din - an integer array of length 6 where to get the digital values

write

public void write(int[] dout)

Writes the given bit state (low/high) to the digital output channels. Only channels set as output will be affected. Input channel bits are ignored.

Parameters:

dout - an integer array of length 6 that holds the bit state: 0->low, 1->high

writeByte

public void writeByte(int value)

Writes the given byte to the digital output channels. Only channels set as output will be affected. Input channel bits are ignored.

Parameters:

value - a byte (lower 8 bits of int) that holds the bit state: 0->low, 1->high. Only bit 0 to bit 5 are used.

setSamplingPeriod

public void setSamplingPeriod(int period)

Sets the sampling period of the ADC (4..100 ms, default 4 ms).

Parameters:

period - the new sampling period