public final class ChannelAccessValueFactory
extends java.lang.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(java.util.Collection<java.lang.String> value,
java.nio.charset.Charset charset,
ChannelAccessAlarmSeverity currentAlarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
boolean explicitlyAcknowledgeTransientAlarms,
ChannelAccessAlarmSeverity unackowledgedAlarmSeverity)
Creates a value of type
DBR_STSACK_STRING . |
static ChannelAccessAlarmOnlyChar |
createAlarmChar(byte[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_CHAR . |
static ChannelAccessAlarmOnlyDouble |
createAlarmDouble(double[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_DOUBLE . |
static ChannelAccessAlarmOnlyEnum |
createAlarmEnum(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_ENUM . |
static ChannelAccessAlarmOnlyFloat |
createAlarmFloat(float[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_FLOAT . |
static ChannelAccessAlarmOnlyLong |
createAlarmLong(int[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_LONG . |
static ChannelAccessAlarmOnlyShort |
createAlarmShort(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_SHORT . |
static ChannelAccessAlarmOnlyString |
createAlarmString(java.util.Collection<java.lang.String> value,
java.nio.charset.Charset charset,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
Creates a value of type
DBR_STS_STRING . |
static ChannelAccessSimpleOnlyChar |
createChar(byte[] value)
Creates a value of type
DBR_CHAR . |
static ChannelAccessClassName |
createClassName(java.util.Collection<java.lang.String> value,
java.nio.charset.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,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
byte lowerAlarmLimit,
byte upperAlarmLimit,
byte lowerWarningLimit,
byte upperWarningLimit,
byte lowerDisplayLimit,
byte upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
byte lowerControlLimit,
byte upperControlLimit)
Creates a value of type
DBR_CTRL_CHAR . |
static ChannelAccessControlsDouble |
createControlsDouble(double[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
double lowerAlarmLimit,
double upperAlarmLimit,
double lowerWarningLimit,
double upperWarningLimit,
double lowerDisplayLimit,
double upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
short precision,
double lowerControlLimit,
double upperControlLimit)
Creates a value of type
DBR_CTRL_DOUBLE . |
static ChannelAccessGraphicsEnum |
createControlsEnum(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
java.util.Collection<java.lang.String> labels,
java.nio.charset.Charset charset)
Creates a value of type
DBR_CTRL_ENUM . |
static ChannelAccessControlsFloat |
createControlsFloat(float[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
float lowerAlarmLimit,
float upperAlarmLimit,
float lowerWarningLimit,
float upperWarningLimit,
float lowerDisplayLimit,
float upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
short precision,
float lowerControlLimit,
float upperControlLimit)
Creates a value of type
DBR_CTRL_FLOAT . |
static ChannelAccessControlsLong |
createControlsLong(int[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int lowerAlarmLimit,
int upperAlarmLimit,
int lowerWarningLimit,
int upperWarningLimit,
int lowerDisplayLimit,
int upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
int lowerControlLimit,
int upperControlLimit)
Creates a value of type
DBR_CTRL_LONG . |
static ChannelAccessControlsShort |
createControlsShort(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
short lowerAlarmLimit,
short upperAlarmLimit,
short lowerWarningLimit,
short upperWarningLimit,
short lowerDisplayLimit,
short upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
short lowerControlLimit,
short upperControlLimit)
Creates a value of type
DBR_CTRL_SHORT . |
static ChannelAccessAlarmOnlyString |
createControlsString(java.util.Collection<java.lang.String> value,
java.nio.charset.Charset charset,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
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,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
byte lowerAlarmLimit,
byte upperAlarmLimit,
byte lowerWarningLimit,
byte upperWarningLimit,
byte lowerDisplayLimit,
byte upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset)
Creates a value of type
DBR_GR_CHAR . |
static ChannelAccessGraphicsOnlyDouble |
createGraphicsDouble(double[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
double lowerAlarmLimit,
double upperAlarmLimit,
double lowerWarningLimit,
double upperWarningLimit,
double lowerDisplayLimit,
double upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
short precision)
Creates a value of type
DBR_GR_DOUBLE . |
static ChannelAccessGraphicsEnum |
createGraphicsEnum(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
java.util.Collection<java.lang.String> labels,
java.nio.charset.Charset charset)
Creates a value of type
DBR_GR_ENUM . |
static ChannelAccessGraphicsOnlyFloat |
createGraphicsFloat(float[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
float lowerAlarmLimit,
float upperAlarmLimit,
float lowerWarningLimit,
float upperWarningLimit,
float lowerDisplayLimit,
float upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset,
short precision)
Creates a value of type
DBR_GR_FLOAT . |
static ChannelAccessGraphicsOnlyLong |
createGraphicsLong(int[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int lowerAlarmLimit,
int upperAlarmLimit,
int lowerWarningLimit,
int upperWarningLimit,
int lowerDisplayLimit,
int upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset)
Creates a value of type
DBR_GR_LONG . |
static ChannelAccessGraphicsOnlyShort |
createGraphicsShort(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
short lowerAlarmLimit,
short upperAlarmLimit,
short lowerWarningLimit,
short upperWarningLimit,
short lowerDisplayLimit,
short upperDisplayLimit,
java.lang.String engineeringUnits,
java.nio.charset.Charset charset)
Creates a value of type
DBR_GR_SHORT . |
static ChannelAccessAlarmOnlyString |
createGraphicsString(java.util.Collection<java.lang.String> value,
java.nio.charset.Charset charset,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus)
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(java.util.Collection<java.lang.String> value,
java.nio.charset.Charset charset)
Creates a value of type
DBR_STRING . |
static ChannelAccessTimeChar |
createTimeChar(byte[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_CHAR . |
static ChannelAccessTimeDouble |
createTimeDouble(double[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_DOUBLE . |
static ChannelAccessTimeEnum |
createTimeEnum(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_ENUM . |
static ChannelAccessTimeFloat |
createTimeFloat(float[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_FLOAT . |
static ChannelAccessTimeLong |
createTimeLong(int[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_LONG . |
static ChannelAccessTimeShort |
createTimeShort(short[] value,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
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(java.util.Collection<java.lang.String> value,
java.nio.charset.Charset charset,
ChannelAccessAlarmSeverity alarmSeverity,
ChannelAccessAlarmStatus alarmStatus,
int timeStampSeconds,
int timeStampNanoSeconds)
Creates a value of type
DBR_TIME_STRING . |
static ChannelAccessValue<?> |
createValue(ChannelAccessValueType valueType,
java.nio.charset.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, java.nio.charset.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(java.util.Collection<java.lang.String> value, java.nio.charset.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(java.util.Collection<java.lang.String> value, java.nio.charset.Charset charset, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.charset
- encoding used for encoding and decoding strings (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_STRING
type.public static ChannelAccessTimeString createTimeString(java.util.Collection<java.lang.String> value, java.nio.charset.Charset charset, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, int timeStampSeconds, int timeStampNanoSeconds)
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.charset
- encoding used for encoding and decoding strings (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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_STRING
type.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessAlarmOnlyString createGraphicsString(java.util.Collection<java.lang.String> value, java.nio.charset.Charset charset, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.charset
- encoding used for encoding and decoding strings (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_GR_STRING
type.public static ChannelAccessAlarmOnlyString createControlsString(java.util.Collection<java.lang.String> value, java.nio.charset.Charset charset, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.charset
- encoding used for encoding and decoding strings (never
null
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (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, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_SHORT
type.public static ChannelAccessTimeShort createTimeShort(short[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, 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
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyShort createGraphicsShort(short[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, short lowerAlarmLimit, short upperAlarmLimit, short lowerWarningLimit, short upperWarningLimit, short lowerDisplayLimit, short upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_SHORT
type.public static ChannelAccessControlsShort createControlsShort(short[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, short lowerAlarmLimit, short upperAlarmLimit, short lowerWarningLimit, short upperWarningLimit, short lowerDisplayLimit, short upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, short lowerControlLimit, short upperControlLimit)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the valu (never
null
)e.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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (never
null
).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.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.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, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_FLOAT
type.public static ChannelAccessTimeFloat createTimeFloat(float[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, 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
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyFloat createGraphicsFloat(float[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, float lowerAlarmLimit, float upperAlarmLimit, float lowerWarningLimit, float upperWarningLimit, float lowerDisplayLimit, float upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, short precision)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (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.DBR_GR_FLOAT
type.public static ChannelAccessControlsFloat createControlsFloat(float[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, float lowerAlarmLimit, float upperAlarmLimit, float lowerWarningLimit, float upperWarningLimit, float lowerDisplayLimit, float upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, short precision, float lowerControlLimit, float upperControlLimit)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (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.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.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.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, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_ENUM
type.public static ChannelAccessTimeEnum createTimeEnum(short[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, 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
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsEnum createGraphicsEnum(short[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, java.util.Collection<java.lang.String> labels, java.nio.charset.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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if labels
has more than 16 elements.public static ChannelAccessGraphicsEnum createControlsEnum(short[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, java.util.Collection<java.lang.String> labels, java.nio.charset.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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.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, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_CHAR
type.public static ChannelAccessTimeChar createTimeChar(byte[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, 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
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyChar createGraphicsChar(byte[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, byte lowerAlarmLimit, byte upperAlarmLimit, byte lowerWarningLimit, byte upperWarningLimit, byte lowerDisplayLimit, byte upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_CHAR
type.public static ChannelAccessControlsChar createControlsChar(byte[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, byte lowerAlarmLimit, byte upperAlarmLimit, byte lowerWarningLimit, byte upperWarningLimit, byte lowerDisplayLimit, byte upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, byte lowerControlLimit, byte upperControlLimit)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (never
null
).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.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.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, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_LONG
type.public static ChannelAccessTimeLong createTimeLong(int[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, 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
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyLong createGraphicsLong(int[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, int lowerAlarmLimit, int upperAlarmLimit, int lowerWarningLimit, int upperWarningLimit, int lowerDisplayLimit, int upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (never
null
).DBR_GR_LONG
type.public static ChannelAccessControlsLong createControlsLong(int[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, int lowerAlarmLimit, int upperAlarmLimit, int lowerWarningLimit, int upperWarningLimit, int lowerDisplayLimit, int upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, int lowerControlLimit, int upperControlLimit)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (never
null
).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.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.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, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).DBR_STS_DOUBLE
type.public static ChannelAccessTimeDouble createTimeDouble(double[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, 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
).alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status 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.java.lang.IllegalArgumentException
- if timeStampNanoSeconds
is out of range.public static ChannelAccessGraphicsOnlyDouble createGraphicsDouble(double[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, double lowerAlarmLimit, double upperAlarmLimit, double lowerWarningLimit, double upperWarningLimit, double lowerDisplayLimit, double upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, short precision)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (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.DBR_GR_DOUBLE
type.public static ChannelAccessControlsDouble createControlsDouble(double[] value, ChannelAccessAlarmSeverity alarmSeverity, ChannelAccessAlarmStatus alarmStatus, double lowerAlarmLimit, double upperAlarmLimit, double lowerWarningLimit, double upperWarningLimit, double lowerDisplayLimit, double upperDisplayLimit, java.lang.String engineeringUnits, java.nio.charset.Charset charset, short precision, double lowerControlLimit, double upperControlLimit)
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.alarmSeverity
- the alarm severity associated with the value (never
null
).alarmStatus
- the alarm status associated with the value (never
null
).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.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.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.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.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.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.engineeringUnits
- engineerings units for the value (never null
).charset
- encoding used for encoding and decoding strings (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.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.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.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(java.util.Collection<java.lang.String> value, java.nio.charset.Charset charset, ChannelAccessAlarmSeverity currentAlarmSeverity, ChannelAccessAlarmStatus alarmStatus, boolean explicitlyAcknowledgeTransientAlarms, ChannelAccessAlarmSeverity unackowledgedAlarmSeverity)
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.charset
- encoding used for encoding and decoding strings (never
null
).currentAlarmSeverity
- current alarm severity (never null
).alarmStatus
- current alarm status (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
).DBR_STSACK_STRING
type.public static ChannelAccessClassName createClassName(java.util.Collection<java.lang.String> value, java.nio.charset.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–2019 aquenos GmbH. All rights reserved.