# Device API

### Device Information

#### `getDeviceName()`

Returns the device name.

#### `getManufacturer()`

Returns the sensor manufacturer (AMS).

#### `setI2cAddress(I2cAddr newAddress)`

Sets a new I2C address for the device.

#### `getI2cAddress()`

Gets the current I2C address.

#### `doInitialize()`

Performs internal initialization and verifies sensor communication.

### Color & Light Functions

#### `classifyColor()`

Classifies perceived color using RGB thresholds. Returns:\
`"Red"`, `"Green"`, `"Blue"`, `"Yellow"`, `"Cyan"`, `"Magenta"`, `"White"`, `"Black"`, `"Unknown"`.

#### `argb()`

Returns packed 32-bit Android-style ARGB color.

#### `getNormalizedColors()`

Returns normalized alpha, red, green, and blue in \[0,1] range.

#### `alpha()`

Reads the clear (ambient) light channel.

#### `getRawLightDetected()`

Returns normalized ambient light intensity.

#### `getLightDetected()`

Returns normalized light detection (same as above).

#### `getRawLightDetectedMax()`

Returns max possible raw light value (65535).

#### `red()`

Reads the red channel.

#### `green()`

Reads the green channel.

#### `blue()`

Reads the blue channel.

### Distance & Proximity Functions

#### `getDistance(DistanceUnit unit)`

Returns calibrated proximity-based distance in specified units.

#### `getProximity()`

Returns raw proximity value (0–255).

#### `setProximityGain(ProximityGain gain)`

Sets proximity gain (1x, 2x, 4x, 8x).

#### `setProximityLedPulses(int pulses)`

Sets number of IR LED pulses (1–64).

#### `setProximityLedPulseLength(ProximityPulseLength pulseLength)`

Sets IR LED pulse duration (4µs, 8µs, 16µs, 32µs).

#### `configureProximitySettings(ProximityGain gain, int pulses, ProximityPulseLength pulseLength)`

Configures gain, pulse count, and pulse length in one call.

### Utility

#### `String status()`

Returns connection status string.