public final class ChannelAccessValueFactory extends Object
Factory for values representing Channel Access types. This factory provides
the methods through which instances of ChannelAccessValue
should be
created. Using those methods ensures that the implementations used are
compatible with ChannelAccessValueCodec
.
If values should be created from their serialized representation, the methods
provided by ChannelAccessValueCodec
should be used instead.
ChannelAccessValue
,
ChannelAccessValueCodec
,
ChannelAccessValueType
Modifier and Type | Method and Description |
---|---|
static ChannelAccessAcknowledgeAlarm |
createAcknowledgeAlarm(ChannelAccessAlarmSeverity acknowledgeAlarmSeverity)
Creates a value of type
DBR_PUT_ACKS . |
static ChannelAccessAlarmAcknowledgementStatus |
createAlarmAcknowledgementStatus(Collection<String> value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity currentAlarmSeverity,
boolean explicitlyAcknowledgeTransientAlarms,
ChannelAccessAlarmSeverity unackowledgedAlarmSeverity,
Charset charset)
Creates a value of type
DBR_STSACK_STRING . |
static ChannelAccessAlarmOnlyChar |
createAlarmChar(byte[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity)
Creates a value of type
DBR_STS_CHAR . |
static ChannelAccessAlarmOnlyDouble |
createAlarmDouble(double[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity)
Creates a value of type
DBR_STS_DOUBLE . |
static ChannelAccessAlarmOnlyEnum |
createAlarmEnum(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity)
Creates a value of type
DBR_STS_ENUM . |
static ChannelAccessAlarmOnlyFloat |
createAlarmFloat(float[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity)
Creates a value of type
DBR_STS_FLOAT . |
static ChannelAccessAlarmOnlyLong |
createAlarmLong(int[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity)
Creates a value of type
DBR_STS_LONG . |
static ChannelAccessAlarmOnlyShort |
createAlarmShort(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity)
Creates a value of type
DBR_STS_SHORT . |
static ChannelAccessAlarmOnlyString |
createAlarmString(Collection<String> value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
Charset charset)
Creates a value of type
DBR_STS_STRING . |
static ChannelAccessSimpleOnlyChar |
createChar(byte[] value)
Creates a value of type
DBR_CHAR . |
static ChannelAccessClassName |
createClassName(Collection<String> value,
Charset charset)
Creates a value of type
DBR_CLASS_NAME . |
static ChannelAccessConfigureAcknowledgeTransientAlarms |
createConfigureAcknowledgeTransientAlarms(boolean explicitlyAcknowledgeTransientAlarms)
Creates a value of type
DBR_PUT_ACKT . |
static ChannelAccessControlsChar |
createControlsChar(byte[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
String engineeringUnits,
byte upperDisplayLimit,
byte lowerDisplayLimit,
byte upperAlarmLimit,
byte upperWarningLimit,
byte lowerWarningLimit,
byte lowerAlarmLimit,
byte upperControlLimit,
byte lowerControlLimit,
Charset charset)
Creates a value of type
DBR_CTRL_CHAR . |
static ChannelAccessControlsDouble |
createControlsDouble(double[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
short precision,
String engineeringUnits,
double upperDisplayLimit,
double lowerDisplayLimit,
double upperAlarmLimit,
double upperWarningLimit,
double lowerWarningLimit,
double lowerAlarmLimit,
double upperControlLimit,
double lowerControlLimit,
Charset charset)
Creates a value of type
DBR_CTRL_DOUBLE . |
static ChannelAccessGraphicsEnum |
createControlsEnum(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
Collection<String> labels,
Charset charset)
Creates a value of type
DBR_CTRL_ENUM . |
static ChannelAccessControlsFloat |
createControlsFloat(float[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
short precision,
String engineeringUnits,
float upperDisplayLimit,
float lowerDisplayLimit,
float upperAlarmLimit,
float upperWarningLimit,
float lowerWarningLimit,
float lowerAlarmLimit,
float upperControlLimit,
float lowerControlLimit,
Charset charset)
Creates a value of type
DBR_CTRL_FLOAT . |
static ChannelAccessControlsLong |
createControlsLong(int[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
String engineeringUnits,
int upperDisplayLimit,
int lowerDisplayLimit,
int upperAlarmLimit,
int upperWarningLimit,
int lowerWarningLimit,
int lowerAlarmLimit,
int upperControlLimit,
int lowerControlLimit,
Charset charset)
Creates a value of type
DBR_CTRL_LONG . |
static ChannelAccessControlsShort |
createControlsShort(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
String engineeringUnits,
short upperDisplayLimit,
short lowerDisplayLimit,
short upperAlarmLimit,
short upperWarningLimit,
short lowerWarningLimit,
short lowerAlarmLimit,
short upperControlLimit,
short lowerControlLimit,
Charset charset)
Creates a value of type
DBR_CTRL_SHORT . |
static ChannelAccessAlarmOnlyString |
createControlsString(Collection<String> value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
Charset charset)
Creates a value of type
DBR_CTRL_STRING . |
static ChannelAccessSimpleOnlyDouble |
createDouble(double[] value)
Creates a value of type
DBR_DOUBLE . |
static ChannelAccessSimpleOnlyEnum |
createEnum(short[] value)
Creates a value of type
DBR_ENUM . |
static ChannelAccessSimpleOnlyFloat |
createFloat(float[] value)
Creates a value of type
DBR_FLOAT . |
static ChannelAccessGraphicsOnlyChar |
createGraphicsChar(byte[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
String engineeringUnits,
byte upperDisplayLimit,
byte lowerDisplayLimit,
byte upperAlarmLimit,
byte upperWarningLimit,
byte lowerWarningLimit,
byte lowerAlarmLimit,
Charset charset)
Creates a value of type
DBR_GR_CHAR . |
static ChannelAccessGraphicsOnlyDouble |
createGraphicsDouble(double[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
short precision,
String engineeringUnits,
double upperDisplayLimit,
double lowerDisplayLimit,
double upperAlarmLimit,
double upperWarningLimit,
double lowerWarningLimit,
double lowerAlarmLimit,
Charset charset)
Creates a value of type
DBR_GR_DOUBLE . |
static ChannelAccessGraphicsEnum |
createGraphicsEnum(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
Collection<String> labels,
Charset charset)
Creates a value of type
DBR_GR_ENUM . |
static ChannelAccessGraphicsOnlyFloat |
createGraphicsFloat(float[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
short precision,
String engineeringUnits,
float upperDisplayLimit,
float lowerDisplayLimit,
float upperAlarmLimit,
float upperWarningLimit,
float lowerWarningLimit,
float lowerAlarmLimit,
Charset charset)
Creates a value of type
DBR_GR_FLOAT . |
static ChannelAccessGraphicsOnlyLong |
createGraphicsLong(int[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
String engineeringUnits,
int upperDisplayLimit,
int lowerDisplayLimit,
int upperAlarmLimit,
int upperWarningLimit,
int lowerWarningLimit,
int lowerAlarmLimit,
Charset charset)
Creates a value of type
DBR_GR_LONG . |
static ChannelAccessGraphicsOnlyShort |
createGraphicsShort(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
String engineeringUnits,
short upperDisplayLimit,
short lowerDisplayLimit,
short upperAlarmLimit,
short upperWarningLimit,
short lowerWarningLimit,
short lowerAlarmLimit,
Charset charset)
Creates a value of type
DBR_GR_SHORT . |
static ChannelAccessAlarmOnlyString |
createGraphicsString(Collection<String> value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
Charset charset)
Creates a value of type
DBR_GR_STRING . |
static ChannelAccessSimpleOnlyLong |
createLong(int[] value)
Creates a value of type
DBR_LONG . |
static ChannelAccessSimpleOnlyShort |
createShort(short[] value)
Creates a value of type
DBR_SHORT . |
static ChannelAccessSimpleOnlyString |
createString(Collection<String> value,
Charset charset)
Creates a value of type
DBR_STRING . |
static ChannelAccessTimeChar |
createTimeChar(byte[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_CHAR . |
static ChannelAccessTimeDouble |
createTimeDouble(double[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_DOUBLE . |
static ChannelAccessTimeEnum |
createTimeEnum(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_ENUM . |
static ChannelAccessTimeFloat |
createTimeFloat(float[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_FLOAT . |
static ChannelAccessTimeLong |
createTimeLong(int[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_LONG . |
static ChannelAccessTimeShort |
createTimeShort(short[] value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_SHORT . |
static ChannelAccessTimeStamp |
createTimeStamp(int seconds,
int nanoseconds)
Creates a time-stamp
seconds seconds and
nanoseconds nanoseconds after EPICS epoch. |
static ChannelAccessTimeString |
createTimeString(Collection<String> value,
ChannelAccessAlarmStatus alarmStatus,
ChannelAccessAlarmSeverity alarmSeverity,
int timeStampSeconds,
int timeStampNanoSeconds,
Charset charset)
Creates a value of type
DBR_TIME_STRING . |
static ChannelAccessValue<?> |
createValue(ChannelAccessValueType valueType,
Charset charset)
Creates a Channel Access value of the specified type.
|
public static ChannelAccessTimeStamp createTimeStamp(int seconds, int nanoseconds)
Creates a time-stamp seconds
seconds and
nanoseconds
nanoseconds after EPICS epoch. The EPICS epoch
is January 1st, 1990, 00:00:00 UTC. EPICS uses unsigned integers, so a
negative value for seconds
actually indicates a value
greater than the maximum positive integer value
.
The nanoseconds
part is restricted to the range of 0 to
999999999. Values outside this range are silently confined to this range.
seconds
- number of seconds since epoch (interpreted as an unsigned
32-bit integer).nanoseconds
- number of nanoseconds to be added for higher precision.null
).public static ChannelAccessValue<?> createValue(ChannelAccessValueType valueType, Charset charset)
DBR_PUT_ACKT
and
DBR_PUT_ACKS
types are
created with on value element (with a value zero).valueType
- type of the Channel Access value that should be created.charset
- charset encoding used for encoding and decoding strings (never
null
).public static ChannelAccessSimpleOnlyString createString(Collection<String> value, Charset charset)
DBR_STRING
. The collection containing the value elements is copied, so
subsequent changes to it will not affect this value and vice versa. The
value
collection must not contain any null
elements. If it does, this causes a NullPointerException
.value
- the strings that should be stored in the value (never
null
). The collection is copied and must not
contain null
elements.charset
- encoding used for encoding and decoding strings (never
null
).DBR_STRING
type.public static ChannelAccessAlarmOnlyString createAlarmString(Collection<String> value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, Charset charset)
DBR_STS_STRING
. The collection containing the value elements is copied,
so subsequent changes to it will not affect this value and vice versa.
The value
collection must not contain any null
elements. If it does, this causes a NullPointerException
.value
- the strings that should be stored in the value (never
null
). The collection is copied and must not
contain null
elements.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_STS_STRING
type.public static ChannelAccessTimeString createTimeString(Collection<String> value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds, Charset charset)
DBR_TIME_STRING
. The collection containing the value elements is copied,
so subsequent changes to it will not affect this value and vice versa.
The value
collection must not contain any null
elements. If it does, this causes a NullPointerException
.value
- the strings that should be stored in the value (never
null
). The collection is copied and must not
contain null
elements.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.charset
- encoding used for encoding and decoding strings (never
null
).DBR_TIME_STRING
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessAlarmOnlyString createGraphicsString(Collection<String> value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, Charset charset)
DBR_GR_STRING
. The collection containing the value elements is copied,
so subsequent changes to it will not affect this value and vice versa.
The value
collection must not contain any null
elements. If it does, this causes a NullPointerException
.value
- the strings that should be stored in the value (never
null
). The collection is copied and must not
contain null
elements.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_STRING
type.public static ChannelAccessAlarmOnlyString createControlsString(Collection<String> value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, Charset charset)
DBR_CTRL_STRING
. The collection containing the value elements is copied,
so subsequent changes to it will not affect this value and vice versa.
The value
collection must not contain any null
elements. If it does, this causes a NullPointerException
.value
- the strings that should be stored in the value (never
null
). The collection is copied and must not
contain null
elements.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_STRING
type.public static ChannelAccessSimpleOnlyShort createShort(short[] value)
DBR_SHORT
. The array is not copied, so subsequent changes in the array
will affect this value and vice versa.value
- the shorts that should be stored in the value (never
null
). The array is not copied.DBR_SHORT
type.public static ChannelAccessAlarmOnlyShort createAlarmShort(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity)
DBR_STS_SHORT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the shorts that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).DBR_STS_SHORT
type.public static ChannelAccessTimeShort createTimeShort(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds)
DBR_TIME_SHORT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the shorts that should be stored in the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.DBR_TIME_SHORT
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyShort createGraphicsShort(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, String engineeringUnits, short upperDisplayLimit, short lowerDisplayLimit, short upperAlarmLimit, short upperWarningLimit, short lowerWarningLimit, short lowerAlarmLimit, Charset charset)
DBR_GR_SHORT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the shorts that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_SHORT
type.public static ChannelAccessControlsShort createControlsShort(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, String engineeringUnits, short upperDisplayLimit, short lowerDisplayLimit, short upperAlarmLimit, short upperWarningLimit, short lowerWarningLimit, short lowerAlarmLimit, short upperControlLimit, short lowerControlLimit, Charset charset)
DBR_CTRL_SHORT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the shorts that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the valu (never
null
)e.alarmSeverity
- the alarm severity associated with the value (never
null
).engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.upperControlLimit
- upper control limit. The upper control limit is the upper
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is greater than this limit. A value of zero typically
indicates that the limit has not been configured and thus
should not be used.lowerControlLimit
- lower control limit. The lower control limit is the lower
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is less than this limit. A value of zero typically indicates
that the limit has not been configured and thus should not be
used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_SHORT
type.public static ChannelAccessSimpleOnlyFloat createFloat(float[] value)
DBR_FLOAT
. The array is not copied, so subsequent changes in the array
will affect this value and vice versa.value
- the floats that should be stored in the value (never
null
). The array is not copied.DBR_FLOAT
type.public static ChannelAccessAlarmOnlyFloat createAlarmFloat(float[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity)
DBR_STS_FLOAT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the floats that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).DBR_STS_FLOAT
type.public static ChannelAccessTimeFloat createTimeFloat(float[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds)
DBR_TIME_FLOAT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the floats that should be stored in the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.DBR_TIME_FLOAT
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyFloat createGraphicsFloat(float[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, short precision, String engineeringUnits, float upperDisplayLimit, float lowerDisplayLimit, float upperAlarmLimit, float upperWarningLimit, float lowerWarningLimit, float lowerAlarmLimit, Charset charset)
DBR_GR_FLOAT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the floats that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).precision
- display precision. The display precision is the number of
digits of the fractional part that should be displayed (number
of digits after the decimal separator). A value of zero
indicates that no display precision has been specified
explicitly and some user-defined default should be used.
Channel Access uses an unsigned 16-bit integer for this
property, so negative values are possible and actually
represent numbers greater than 32767. For practical purposes
however, such values do not make any sense.engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_FLOAT
type.public static ChannelAccessControlsFloat createControlsFloat(float[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, short precision, String engineeringUnits, float upperDisplayLimit, float lowerDisplayLimit, float upperAlarmLimit, float upperWarningLimit, float lowerWarningLimit, float lowerAlarmLimit, float upperControlLimit, float lowerControlLimit, Charset charset)
DBR_CTRL_FLOAT
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the floats that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).precision
- display precision. The display precision is the number of
digits of the fractional part that should be displayed (number
of digits after the decimal separator). A value of zero
indicates that no display precision has been specified
explicitly and some user-defined default should be used.
Channel Access uses an unsigned 16-bit integer for this
property, so negative values are possible and actually
represent numbers greater than 32767. For practical purposes
however, such values do not make any sense.engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.upperControlLimit
- upper control limit. The upper control limit is the upper
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is greater than this limit. A value of zero typically
indicates that the limit has not been configured and thus
should not be used.lowerControlLimit
- lower control limit. The lower control limit is the lower
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is less than this limit. A value of zero typically indicates
that the limit has not been configured and thus should not be
used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_FLOAT
type.public static ChannelAccessSimpleOnlyEnum createEnum(short[] value)
DBR_ENUM
.
The array is not copied, so subsequent changes in the array will affect
this value and vice versa.value
- the enums that should be stored in the value (never
null
). The array is not copied.DBR_ENUM
type.public static ChannelAccessAlarmOnlyEnum createAlarmEnum(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity)
DBR_STS_ENUM
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the enums that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).DBR_STS_ENUM
type.public static ChannelAccessTimeEnum createTimeEnum(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds)
DBR_TIME_ENUM
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the enums that should be stored in the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.DBR_TIME_ENUM
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsEnum createGraphicsEnum(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, Collection<String> labels, Charset charset)
DBR_GR_ENUM
. The value
array is not copied, so subsequent
changes in the array will affect this value and vice versa. The
labels
array, however, is copied.value
- the enums that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).labels
- enum state labels (never null
). Must not contain
null
elements. These are display labels that
serve as the textual representation of up to 16 states. Labels
that are too long are truncated automatically when converting
them to raw strings. However, this does not affect the labels
stored in the Java strings. The collection is copied so that
subsequent modifications do not affect the value created.charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_SHORT
type.IllegalArgumentException
- if labels
has more than 16 elements.public static ChannelAccessGraphicsEnum createControlsEnum(short[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, Collection<String> labels, Charset charset)
DBR_CTRL_ENUM
. The value
array is not copied, so subsequent
changes in the array will affect this value and vice versa. The
labels
array, however, is copied.value
- the enums that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).labels
- enum state labels (never null
). These are display
labels that serve as the textual representation of up to 16
states. Labels that are too long are truncated automatically
when converting them to raw strings. However, this does not
affect the labels stored in the Java strings. The collection
is copied so that subsequent modifications do not affect the
value created.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_SHORT
type.IllegalArgumentException
- if labels
has more than 16 elements.public static ChannelAccessSimpleOnlyChar createChar(byte[] value)
DBR_CHAR
.
The array is not copied, so subsequent changes in the array will affect
this value and vice versa.value
- the bytes that should be stored in the value (never
null
). The array is not copied.DBR_CHAR
type.public static ChannelAccessAlarmOnlyChar createAlarmChar(byte[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity)
DBR_STS_CHAR
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the bytes that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).DBR_STS_CHAR
type.public static ChannelAccessTimeChar createTimeChar(byte[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds)
DBR_TIME_CHAR
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the bytes that should be stored in the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.DBR_TIME_CHAR
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyChar createGraphicsChar(byte[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, String engineeringUnits, byte upperDisplayLimit, byte lowerDisplayLimit, byte upperAlarmLimit, byte upperWarningLimit, byte lowerWarningLimit, byte lowerAlarmLimit, Charset charset)
DBR_GR_CHAR
. The array is not copied, so subsequent changes in the array
will affect this value and vice versa.value
- the bytes that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_CHAR
type.public static ChannelAccessControlsChar createControlsChar(byte[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, String engineeringUnits, byte upperDisplayLimit, byte lowerDisplayLimit, byte upperAlarmLimit, byte upperWarningLimit, byte lowerWarningLimit, byte lowerAlarmLimit, byte upperControlLimit, byte lowerControlLimit, Charset charset)
DBR_CTRL_CHAR
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the bytes that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.upperControlLimit
- upper control limit. The upper control limit is the upper
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is greater than this limit. A value of zero typically
indicates that the limit has not been configured and thus
should not be used.lowerControlLimit
- lower control limit. The lower control limit is the lower
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is less than this limit. A value of zero typically indicates
that the limit has not been configured and thus should not be
used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_CHAR
type.public static ChannelAccessSimpleOnlyLong createLong(int[] value)
DBR_LONG
.
The array is not copied, so subsequent changes in the array will affect
this value and vice versa.value
- the ints that should be stored in the value (never
null
). The array is not copied.DBR_LONG
type.public static ChannelAccessAlarmOnlyLong createAlarmLong(int[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity)
DBR_STS_LONG
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the ints that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).DBR_STS_LONG
type.public static ChannelAccessTimeLong createTimeLong(int[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds)
DBR_TIME_LONG
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the ints that should be stored in the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.DBR_TIME_LONG
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyLong createGraphicsLong(int[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, String engineeringUnits, int upperDisplayLimit, int lowerDisplayLimit, int upperAlarmLimit, int upperWarningLimit, int lowerWarningLimit, int lowerAlarmLimit, Charset charset)
DBR_GR_LONG
. The array is not copied, so subsequent changes in the array
will affect this value and vice versa.value
- the ints that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_LONG
type.public static ChannelAccessControlsLong createControlsLong(int[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, String engineeringUnits, int upperDisplayLimit, int lowerDisplayLimit, int upperAlarmLimit, int upperWarningLimit, int lowerWarningLimit, int lowerAlarmLimit, int upperControlLimit, int lowerControlLimit, Charset charset)
DBR_CTRL_LONG
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the ints that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.upperControlLimit
- upper control limit. The upper control limit is the upper
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is greater than this limit. A value of zero typically
indicates that the limit has not been configured and thus
should not be used.lowerControlLimit
- lower control limit. The lower control limit is the lower
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is less than this limit. A value of zero typically indicates
that the limit has not been configured and thus should not be
used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_LONG
type.public static ChannelAccessSimpleOnlyDouble createDouble(double[] value)
DBR_DOUBLE
. The array is not copied, so subsequent changes in the array
will affect this value and vice versa.value
- the doubles that should be stored in the value (never
null
). The array is not copied.DBR_DOUBLE
type.public static ChannelAccessAlarmOnlyDouble createAlarmDouble(double[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity)
DBR_STS_DOUBLE
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the doubles that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).DBR_STS_DOUBLE
type.public static ChannelAccessTimeDouble createTimeDouble(double[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, int timeStampSeconds, int timeStampNanoSeconds)
DBR_TIME_DOUBLE
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the doubles that should be stored in the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).timeStampSeconds
- seconds part of the time-stamp. These are the seconds since
EPICS epoch (January 1st, 1990, 00:00:00 UTC). EPICS uses
unsigned integers, so a negative value for
timeStampseconds
actually indicates a value
greater than the maximum positive
integer value
.timeStampNanoSeconds
- nanoseconds part of the time-stamp. The nanoseconds are
specified so that the time-stamp can have a higher precision.
This value must be between 0 and 999999999.DBR_TIME_DOUBLE
type.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyDouble createGraphicsDouble(double[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, short precision, String engineeringUnits, double upperDisplayLimit, double lowerDisplayLimit, double upperAlarmLimit, double upperWarningLimit, double lowerWarningLimit, double lowerAlarmLimit, Charset charset)
DBR_GR_DOUBLE
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the doubles that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).precision
- display precision. The display precision is the number of
digits of the fractional part that should be displayed (number
of digits after the decimal separator). A value of zero
indicates that no display precision has been specified
explicitly and some user-defined default should be used.
Channel Access uses an unsigned 16-bit integer for this
property, so negative values are possible and actually
represent numbers greater than 32767. For practical purposes
however, such values do not make any sense.engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_DOUBLE
type.public static ChannelAccessControlsDouble createControlsDouble(double[] value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity alarmSeverity, short precision, String engineeringUnits, double upperDisplayLimit, double lowerDisplayLimit, double upperAlarmLimit, double upperWarningLimit, double lowerWarningLimit, double lowerAlarmLimit, double upperControlLimit, double lowerControlLimit, Charset charset)
DBR_CTRL_DOUBLE
. The array is not copied, so subsequent changes in the
array will affect this value and vice versa.value
- the doubles that should be stored in the value (never
null
). The array is not copied.alarmStatus
- the alarm status associated with the value (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).precision
- display precision. The display precision is the number of
digits of the fractional part that should be displayed (number
of digits after the decimal separator). A value of zero
indicates that no display precision has been specified
explicitly and some user-defined default should be used.
Channel Access uses an unsigned 16-bit integer for this
property, so negative values are possible and actually
represent numbers greater than 32767. For practical purposes
however, such values do not make any sense.engineeringUnits
- engineerings units for the value (never null
).upperDisplayLimit
- upper display limit. The upper display limit is the limit that
the value does typically not exceed and thus is suitable for
choosing the layout of graphic displays (e.g. gauges). A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerDisplayLimit
- lower display limit. The lower display limit is the limit that
the value does typically not undershoot and thus is suitable
for choosing the layout of graphic displays (e.g. gauges). A
value of zero typically indicates that the limit has not been
configured and thus should not be used.upperAlarmLimit
- upper alarm limit. The upper alarm limit is the limit that,
when exceeded, typically raises a major alarm. A value of zero
typically indicates that the limit has not been configured and
thus should not be used.upperWarningLimit
- upper warning limit. The upper warning limit is the limit
that, when exceeded, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerWarningLimit
- lower warning limit. The lower warning limit is the limit
that, when undershot, typically raises a minor alarm. A value
of zero typically indicates that the limit has not been
configured and thus should not be used.lowerAlarmLimit
- lower alarm limit. The lower alarm limit is the limit that,
when undershot, typically raises a major alarm. A value of
zero typically indicates that the limit has not been
configured and thus should not be used.upperControlLimit
- upper control limit. The upper control limit is the upper
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is greater than this limit. A value of zero typically
indicates that the limit has not been configured and thus
should not be used.lowerControlLimit
- lower control limit. The lower control limit is the lower
limit that the server enforces on values. Typically, this
means that the process variable cannot be set to a value that
is less than this limit. A value of zero typically indicates
that the limit has not been configured and thus should not be
used.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CTRL_DOUBLE
type.public static ChannelAccessConfigureAcknowledgeTransientAlarms createConfigureAcknowledgeTransientAlarms(boolean explicitlyAcknowledgeTransientAlarms)
DBR_PUT_ACKT
.explicitlyAcknowledgeTransientAlarms
- true
if transient alarms should have to be
acknowledged explicitly, false
if they should be
automatically acknowledged when they disappear.DBR_PUT_ACKT
type.public static ChannelAccessAcknowledgeAlarm createAcknowledgeAlarm(ChannelAccessAlarmSeverity acknowledgeAlarmSeverity)
DBR_PUT_ACKS
.acknowledgeAlarmSeverity
- highest alarm severity that should be acknowledged (never
null
). This means that the alarm will be
acknowledged if the severity of the unacknowledged alarm is
less than or equal to the specified severity.DBR_PUT_ACKS
type.public static ChannelAccessAlarmAcknowledgementStatus createAlarmAcknowledgementStatus(Collection<String> value, ChannelAccessAlarmStatus alarmStatus, ChannelAccessAlarmSeverity currentAlarmSeverity, boolean explicitlyAcknowledgeTransientAlarms, ChannelAccessAlarmSeverity unackowledgedAlarmSeverity, Charset charset)
DBR_STSACK_STRING
. The collection containing the value elements is
copied, so subsequent changes to it will not affect this value and vice
versa. The value
collection must not contain any
null
elements. If it does, this causes a
NullPointerException
.value
- strings representing the channel's current value (never
null
). The collection is copied and must not
contain null
elements.alarmStatus
- current alarm status (never null
).currentAlarmSeverity
- current alarm severity (never null
).explicitlyAcknowledgeTransientAlarms
- configuration for transient alarms. Do transient alarms have
to be acknowledged explicitly (true
) or are they
automatically acknowledged when they disappear (
false
)?unackowledgedAlarmSeverity
- severity of the highest unacknowledged alarm (never
null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_STSACK_STRING
type.public static ChannelAccessClassName createClassName(Collection<String> value, Charset charset)
DBR_CLASS_NAME
. The collection containing the value elements is copied,
so subsequent changes to it will not affect this value and vice versa.
The value
collection must not contain any null
elements. If it does, this causes a NullPointerException
.value
- the strings that should be stored in the value (never
null
). The array is copied and must not contain
null
elements.charset
- encoding used for encoding and decoding strings (never
null
).DBR_CLASS_NAME
type.Copyright © 2014–2017 aquenos GmbH. All rights reserved.