Package org.osgi.service.zigbee
Class APSException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.lang.RuntimeException
-
- org.osgi.service.zigbee.ZigBeeException
-
- org.osgi.service.zigbee.APSException
-
- All Implemented Interfaces:
java.io.Serializable
public class APSException extends ZigBeeException
This exception class is specialized for the APS errors. See "Table 2.26 APS Sub-layer Status Values" of the ZigBee specification 1_053474r17ZB_TSC-ZigBee-Specification.pdf.- Author:
- $Id: 062f2177cad281a7bda9a2e5bd9a830fbea7b72e $
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static int
ASDU_TOO_LONG
A transmit request failed since the ASDU is too large and fragmentation is not supported.static int
DEFRAG_DEFERRED
A received fragmented frame could not be defragmented at the current time.static int
DEFRAG_UNSUPPORTED
A received fragmented frame could not be defragmented since the device does not support fragmentation.static int
ILLEGAL_REQUEST
A parameter value was out of range.static int
INVALID_BINDING
An APSME-UNBIND.request failed due to the requested binding link not existing in the binding table.static int
INVALID_GROUP
An APSME-REMOVE-GROUP.request has been issued with a group identifier that does not appear in the group table.static int
INVALID_PARAMETER
A parameter value was invalid or out of range.static int
NO_ACK
An APSDE-DATA.request requesting acknowledged transmission failed due to no acknowledgment being received.static int
NO_BOUND_DEVICE
An APSDE-DATA.request with a destination addressing mode set to 0x00 failed due to there being no devices bound to this device.static int
NO_SHORT_ADDRESS
An APSDE-DATA.request with a destination addressing mode set to 0x03 failed due to no corresponding short address found in the address map table.static int
NOT_SUPPORTED
An APSDE-DATA.request with a destination addressing mode set to 0x00 failed due to a binding table not being supported on the device.static int
SECURED_LINK_KEY
An ASDU was received that was secured using a link key.static int
SECURED_NWK_KEY
An ASDU was received that was secured using a network key.static int
SECURITY_FAIL
An APSDE-DATA.request requesting security has resulted in an error during the corresponding security processing.static int
SUCCESS
A request has been executed successfully.static int
TABLE_FULL
An APSME-BIND.request or APSME.ADDGROUP.static int
UNSECURED
An ASDU was received without any security.static int
UNSUPPORTED_ATTRIBUTE
An APSME-GET.request or APSMESET.-
Fields inherited from class org.osgi.service.zigbee.ZigBeeException
errorCode, OSGI_EXISTING_ID, OSGI_MULTIPLE_HOSTS, TIMEOUT, UNKNOWN_ERROR, zigBeeErrorCode
-
-
Constructor Summary
Constructors Constructor Description APSException(int errorCode, int zigBeeErrorCode, java.lang.String errorDesc)
APSException(int errorCode, java.lang.String errorDesc)
Creates a APSException containing a specificerrorCode
.APSException(java.lang.String errorDesc)
Creates a APSException containing only a description, but no error codes.
-
Method Summary
-
Methods inherited from class org.osgi.service.zigbee.ZigBeeException
getErrorCode, getZigBeeErrorCode, hasZigBeeErrorCode
-
-
-
-
Field Detail
-
SUCCESS
public static final int SUCCESS
A request has been executed successfully.- See Also:
- Constant Field Values
-
ASDU_TOO_LONG
public static final int ASDU_TOO_LONG
A transmit request failed since the ASDU is too large and fragmentation is not supported.- See Also:
- Constant Field Values
-
DEFRAG_DEFERRED
public static final int DEFRAG_DEFERRED
A received fragmented frame could not be defragmented at the current time.- See Also:
- Constant Field Values
-
DEFRAG_UNSUPPORTED
public static final int DEFRAG_UNSUPPORTED
A received fragmented frame could not be defragmented since the device does not support fragmentation.- See Also:
- Constant Field Values
-
ILLEGAL_REQUEST
public static final int ILLEGAL_REQUEST
A parameter value was out of range.- See Also:
- Constant Field Values
-
INVALID_BINDING
public static final int INVALID_BINDING
An APSME-UNBIND.request failed due to the requested binding link not existing in the binding table.- See Also:
- Constant Field Values
-
INVALID_GROUP
public static final int INVALID_GROUP
An APSME-REMOVE-GROUP.request has been issued with a group identifier that does not appear in the group table.- See Also:
- Constant Field Values
-
INVALID_PARAMETER
public static final int INVALID_PARAMETER
A parameter value was invalid or out of range.- See Also:
- Constant Field Values
-
NO_ACK
public static final int NO_ACK
An APSDE-DATA.request requesting acknowledged transmission failed due to no acknowledgment being received.- See Also:
- Constant Field Values
-
NO_BOUND_DEVICE
public static final int NO_BOUND_DEVICE
An APSDE-DATA.request with a destination addressing mode set to 0x00 failed due to there being no devices bound to this device.- See Also:
- Constant Field Values
-
NO_SHORT_ADDRESS
public static final int NO_SHORT_ADDRESS
An APSDE-DATA.request with a destination addressing mode set to 0x03 failed due to no corresponding short address found in the address map table.- See Also:
- Constant Field Values
-
NOT_SUPPORTED
public static final int NOT_SUPPORTED
An APSDE-DATA.request with a destination addressing mode set to 0x00 failed due to a binding table not being supported on the device.- See Also:
- Constant Field Values
-
SECURED_LINK_KEY
public static final int SECURED_LINK_KEY
An ASDU was received that was secured using a link key.- See Also:
- Constant Field Values
-
SECURED_NWK_KEY
public static final int SECURED_NWK_KEY
An ASDU was received that was secured using a network key.- See Also:
- Constant Field Values
-
SECURITY_FAIL
public static final int SECURITY_FAIL
An APSDE-DATA.request requesting security has resulted in an error during the corresponding security processing.- See Also:
- Constant Field Values
-
TABLE_FULL
public static final int TABLE_FULL
An APSME-BIND.request or APSME.ADDGROUP. request issued when the binding or group tables, respectively, were full.- See Also:
- Constant Field Values
-
UNSECURED
public static final int UNSECURED
An ASDU was received without any security.- See Also:
- Constant Field Values
-
UNSUPPORTED_ATTRIBUTE
public static final int UNSUPPORTED_ATTRIBUTE
An APSME-GET.request or APSMESET. request has been issued with an unknown attribute identifier.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
APSException
public APSException(java.lang.String errorDesc)
Creates a APSException containing only a description, but no error codes. If issued on this exception theZigBeeException.getErrorCode()
andZigBeeException.getZigBeeErrorCode()
methods return theZigBeeException.UNKNOWN_ERROR
constant.- Parameters:
errorDesc
- exception an error description.
-
APSException
public APSException(int errorCode, java.lang.String errorDesc)
Creates a APSException containing a specificerrorCode
. Using this constructor witherrorCode
set toZigBeeException.UNKNOWN_ERROR
is equivalent to callAPSException(String)
.- Parameters:
errorCode
- One of the error codes defined in this interface orZigBeeException.UNKNOWN_ERROR
if the actual error is not listed in this interface. In this case if the native ZigBee error code is known, it is preferred to use theAPSException(int, int, String)
constructor, passingZigBeeException.UNKNOWN_ERROR
as first parameter and the native ZigBee error as the second.errorDesc
- An error description which explain the type of problem.
-
APSException
public APSException(int errorCode, int zigBeeErrorCode, java.lang.String errorDesc)
Creates a APSException containing a specificerrorCode
orzigBeeErrorCode
. Using this constructor with both theerrorCode
andzigBeeErrorCode
set toZigBeeException.UNKNOWN_ERROR
is equivalent to callAPSException(String)
.- Parameters:
errorCode
- One of the error codes defined in this interface orZigBeeException.UNKNOWN_ERROR
the actual error is not covered in this interface. In this case thezigBeeErrorCode
parameter must be the actual status code returned by the ZigBee stack.zigBeeErrorCode
- The actual APS status code orZigBeeException.UNKNOWN_ERROR
if this status is unknown.errorDesc
- An error description which explain the type of problem.
-
-