com.digi.xbee.api.models.WiFiAssociationIndicationStatus Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of xbee-java-library Show documentation
There is a newer version: 1.3.2
/**
 * Copyright 2017, Digi International Inc.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, you can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
package com.digi.xbee.api.models;

import java.util.HashMap;

import com.digi.xbee.api.utils.HexUtils;

/**
 * Enumerates the different association indication status for the Wi-Fi 
 * protocol.
 * 
 * @since 1.2.0
 */
public enum WiFiAssociationIndicationStatus {

	// Enumeration entries
	SUCCESSFULLY_JOINED(0x00, "Successfully joined to access point."),
	INITIALIZING(0x01, "Initialization in progress."),
	INITIALIZED(0x02, "Initialized, but not yet scanning."),
	DISCONNECTING(0x13, "Disconnecting from access point."),
	SSID_NOT_CONFIGURED(0x23, "SSID not configured"),
	INVALID_KEY(0x24, "Encryption key invalid (NULL or invalid length)."),
	JOIN_FAILED(0x27, "SSID found, but join failed."),
	WAITING_FOR_AUTH(0x40, "Waiting for WPA or WPA2 authentication."),
	WAITING_FOR_IP(0x41, "Joined to a network and waiting for IP address."),
	SETTING_UP_SOCKETS(0x42, "Joined to a network and IP configured. Setting up listening sockets."),
	SCANNING_FOR_SSID(0xFF, "Scanning for the configured SSID.");
	
	// Variables
	private final int value;
	
	private final String description;
	
	private final static HashMap lookupTable = new HashMap();
	
	static {
		for (WiFiAssociationIndicationStatus associationIndicationStatus:values())
			lookupTable.put(associationIndicationStatus.getValue(), associationIndicationStatus);
	}
	
	/**
	 * Class constructor. Instantiates a new 
	 * {@code WiFiAssociationIndicationStatus} enumeration entry with the 
	 * given parameters.
	 * 
	 * @param value Wi-Fi association indication status value.
	 * @param description Wi-Fi association indication status description.
	 */
	WiFiAssociationIndicationStatus(int value, String description) {
		this.value = value;
		this.description = description;
	}
	
	/**
	 * Returns the Wi-Fi association indication status value.
	 * 
	 * @return The Wi-Fi association indication status value.
	 */
	public int getValue() {
		return value;
	}
	
	/**
	 * Returns the Wi-Fi association indication status description.
	 * 
	 * @return The Wi-Fi association indication status description.
	 */
	public String getDescription() {
		return description;
	}
	
	/**
	 * Returns the {@code WiFiAssociationIndicationStatus} associated to 
	 * the given value.
	 * 
	 * @param value Value of the Wi-Fi association indication status to 
	 *              retrieve.
	 * 
	 * @return The Wi-Fi association indication status of the associated 
	 *         value, {@code null} if it could not be found in the table.
	 */
	public static WiFiAssociationIndicationStatus get(int value) {
		return lookupTable.get(value);
	}
	
	/*
	 * (non-Javadoc)
	 * @see java.lang.Enum#toString()
	 */
	@Override
	public String toString() {
		return HexUtils.byteToHexString((byte)value) + ": " + description;
	}
}