com.embeddedunveiled.serial.usb.SerialComUSBdevice Maven / Gradle / Ivy

Go to download
/*
 * Author : Rishi Gupta
 * 
 * This file is part of 'serial communication manager' library.
 * Copyright (C) <2014-2016>  
 *
 * This 'serial communication manager' is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by the Free Software 
 * Foundation, either version 3 of the License, or (at your option) any later version.
 *
 * The 'serial communication manager' is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 
 * A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with 'serial communication manager'.  If not, see .
 */

package com.embeddedunveiled.serial.usb;

import com.embeddedunveiled.serial.SerialComException;
import com.embeddedunveiled.serial.util.SerialComUtil;

/**
 * Represents a USB device with information about it.
 * 
 * @author Rishi Gupta
 */
public final class SerialComUSBdevice {

	private final String idVendor;
	private final String idProduct;
	private final String serial;
	private final String product;
	private final String manufacturer;
	private final String location;

	/**
	 * Construct and allocates a new SerialComUSBdevice object with the given details.
	 * 
	 * @param idVendor USB-IF unique vendor id of this device.
	 * @param idProduct USB product id of this device.
	 * @param serial serial number of this device.
	 * @param product product identifier/description of this device.
	 * @param manufacturer company manufacturing of this device.
	 * @param location location information of this device.
	 * @throws SerialComException if the object can not be constructed.
	 */
	public SerialComUSBdevice(String idVendor, String idProduct, String serial, String product, 
			String manufacturer, String location) {
		this.idVendor = idVendor;
		this.idProduct = idProduct;
		this.serial = serial;
		this.product = product;
		this.manufacturer = manufacturer;
		this.location = location;
	}

	/** 
	 * Retrieves the vendor id of the USB device.
	 * 
	 * @return vendor id of the USB device.
	 * @throws NumberFormatException if the USB vendor id hex string can not be converted into 
	 *          numerical representation.
	 */
	public int getVendorID() {
		if("---".equals(idVendor)) {
			return 0;
		}
		return (int) SerialComUtil.hexStrToLongNumber(idVendor);
	}

	/** 
	 * Retrieves the product id of the USB device.
	 * 
	 * @return product id of the USB device.
	 * @throws NumberFormatException if the USB product id hex string can not be converted into 
	 *          numerical representation.
	 */
	public int getProductID() {
		if("---".equals(idProduct)) {
			return 0;
		}
		return (int) SerialComUtil.hexStrToLongNumber(idProduct);
	}

	/** 
	 * Retrieves the serial number string of the USB device.
	 * 
	 * @return serial number string of the USB device.
	 */
	public String getSerialNumber() {
		return serial;
	}

	/** 
	 * Retrieves the product string of the USB device.
	 * 
	 * @return serial number string of the USB device.
	 */
	public String getProductString() {
		return product;
	}

	/** 
	 * Retrieves the manufacturer string of the USB device.
	 * 
	 * @return serial number string of the USB device.
	 */
	public String getManufacturerString() {
		return manufacturer;
	}

	/** 
	 * Retrieves the location information of this usb device.
	 * 
	 * @return location information about this USB device.
	 */
	public String getLocation() {
		return location;
	}

	/** 
	 * Prints information about this device on console.
	 */
	public void dumpDeviceInfo() {
		System.out.println(
				"\nVendor id : 0x" + idVendor + 
				"\nProduct id : 0x" + idProduct + 
				"\nSerial number : " + serial + 
				"\nProduct : " + product + 
				"\nManufacturer : " + manufacturer +
				"\nLocation : " + location);
	}
}