ch.aplu.ev3

Class PrototypeSensor

java.lang.Object

ch.aplu.ev3.Part

ch.aplu.ev3.Sensor

ch.aplu.ev3.PrototypeSensor

public class PrototypeSensor
extends Sensor

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
java.lang.String	getProductID() Returns the product identifier (if available).
java.lang.String	getVersion() Returns the sensor version number (if available).
void	read(int[] ain, int[] din) Reads the sensor.
void	readAnalog(int[] ain) Reads the sensor.
void	readDigital(int[] din) Reads the sensor.
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	writeByte(int value) Writes the given byte to the digital output channels.

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

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

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

getProductID

public java.lang.String getProductID()

Returns the product identifier (if available).

Returns:

the product identifier (PID)

getVersion

public java.lang.String getVersion()

Returns the sensor version number (if available).

Returns:

the sensor version number