javax.bluetooth.DeviceClass Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of microemu-jsr-82 Show documentation

jsr-82 - Java APIs for Bluetooth

The newest version!

/**
 *  Java docs licensed under the Apache License, Version 2.0
 *  http://www.apache.org/licenses/LICENSE-2.0 
 *   (c) Copyright 2001, 2002 Motorola, Inc.  ALL RIGHTS RESERVED.
 *
 *
 *  @version $Id: DeviceClass.java 1379 2007-10-13 02:00:43Z vlads $
 */ 
 
package javax.bluetooth;

/**
 * The DeviceClass class represents the class of device (CoD)
 * record as defined by the Bluetooth specification.  This record is defined in
 * the Bluetooth Assigned Numbers document
 * and contains information on the type of the device and the type of services
 * available on the device.
 * 
 * The Bluetooth Assigned Numbers document
 * (
 * http://www.bluetooth.org/assigned-numbers/baseband.htm)
 * defines the service class, major device class, and minor device class.  The
 * table below provides some examples of possible return values and their
 * meaning:
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * Method Return Value Class of Device
getServiceClasses() 0x22000 Networking and Limited Discoverable Major Service Classes
getServiceClasses() 0x100000 Object Transfer Major Service Class
getMajorDeviceClass() 0x00 Miscellaneous Major Device Class
getMajorDeviceClass() 0x200 Phone Major Device Class
getMinorDeviceClass() 0x0C With a Computer Major Device Class,
 *   Laptop Minor Device Class
getMinorDeviceClass() 0x04 With a Phone Major Device Class,
 *   Cellular Minor Device Class
 *
 * @version 1.0 February 11, 2002
 */

public class DeviceClass {

	private static final int SERVICE_MASK = 0xffe000;

	private static final int MAJOR_MASK = 0x001f00;

	private static final int MINOR_MASK = 0x0000fc;

	private int record;

    /**
     * Creates a DeviceClass from the class of device record
     * provided.  record must follow the format of the
     * class of device record in the Bluetooth specification.
     *
     * @param record describes the classes of a device
     *
     * @exception IllegalArgumentException if record has any bits
     * between 24 and 31 set
	 */

	public DeviceClass(int record) {
		
		this.record = record;

		if ((record & 0xff000000) != 0)
			throw new IllegalArgumentException();
	}

	/**
	 * Retrieves the major service classes. A device may have multiple major
     * service classes.  When this occurs, the major service classes are
     * bitwise OR'ed together.
     *
     * @return the major service classes
	 */

	public int getServiceClasses() {
		return record & SERVICE_MASK;
	}

    /**
	 * Retrieves the major device class. A device may have only a single major
     * device class.
     *
     * @return the major device class
	 */

	public int getMajorDeviceClass() {
		return record & MAJOR_MASK;
	}

    /**
     * Retrieves the minor device class.
     *
     * @return the minor device class
	 */

	public int getMinorDeviceClass() {
		return record & MINOR_MASK;
	}

}

Method	Return Value	Class of Device
`getServiceClasses()`	0x22000	Networking and Limited Discoverable Major Service Classes
`getServiceClasses()`	0x100000	Object Transfer Major Service Class
`getMajorDeviceClass()`	0x00	Miscellaneous Major Device Class
`getMajorDeviceClass()`	0x200	Phone Major Device Class
`getMinorDeviceClass()`	0x0C	With a Computer Major Device Class, * Laptop Minor Device Class
`getMinorDeviceClass()`	0x04	With a Phone Major Device Class, * Cellular Minor Device Class