Compare commits
16 Commits
Author | SHA1 | Date | |
---|---|---|---|
da281ebf97 | |||
c832efbcb6 | |||
b7b3bc0af0 | |||
4a42c3d43a | |||
624cc0134a | |||
d9d5d5f55d | |||
53ea75dc80 | |||
b1f4c2a7d9 | |||
d87e9cedd2 | |||
32d93d9028 | |||
3d30827798 | |||
b688f14c22 | |||
9e972d3f33 | |||
f5da2ea6b3 | |||
4edd2f2eff | |||
846b884eb5 |
@ -1,6 +1,6 @@
|
|||||||
# StreamDevice
|
# StreamDevice
|
||||||
|
|
||||||
_StreamDevice_ is a generic [EPICS](https://www.aps.anl.gov/epics)
|
_StreamDevice_ is a generic [EPICS](https://epics.anl.gov/)
|
||||||
device support for devices with a "byte stream" based
|
device support for devices with a "byte stream" based
|
||||||
communication interface.
|
communication interface.
|
||||||
That means devices that can be controlled by sending and receiving
|
That means devices that can be controlled by sending and receiving
|
||||||
|
@ -53,7 +53,7 @@ RegisterConverter(MyConverter,"Q");
|
|||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
<a name="theory"></a>
|
<a name="theory"></a>
|
||||||
<h2>Theroy of Operation</h2>
|
<h2>Theory of Operation</h2>
|
||||||
|
|
||||||
<a name="registration"></a>
|
<a name="registration"></a>
|
||||||
<h3>Registration </h3>
|
<h3>Registration </h3>
|
||||||
|
@ -15,7 +15,7 @@
|
|||||||
<h2>What is <em>StreamDevice</em>?</h2>
|
<h2>What is <em>StreamDevice</em>?</h2>
|
||||||
<p>
|
<p>
|
||||||
<em>StreamDevice</em> is a generic
|
<em>StreamDevice</em> is a generic
|
||||||
<a href="https://www.aps.anl.gov/epics" target="ex">EPICS</a>
|
<a href="https://epics.anl.gov/" target="ex">EPICS</a>
|
||||||
device support for devices with a "byte stream" based
|
device support for devices with a "byte stream" based
|
||||||
communication interface.
|
communication interface.
|
||||||
That means devices that can be controlled by sending and
|
That means devices that can be controlled by sending and
|
||||||
|
@ -16,7 +16,7 @@
|
|||||||
<h2>1. Normal Processing</h2>
|
<h2>1. Normal Processing</h2>
|
||||||
<p>
|
<p>
|
||||||
<em>StreamDevice</em> is an asynchronous device support
|
<em>StreamDevice</em> is an asynchronous device support
|
||||||
(see <a href="http://www.aps.anl.gov/epics/base/R3-14/8-docs/AppDevGuide.pdf"
|
(see <a href="http://www.aps.anl.gov/epics/base/R3-14/12-docs/AppDevGuide.pdf"
|
||||||
target="ex">IOC Application Developer's Guide</a> chapter 12:
|
target="ex">IOC Application Developer's Guide</a> chapter 12:
|
||||||
Device Support).
|
Device Support).
|
||||||
Whenever the record is processed, the <a href="protocol.html">protocol</a>
|
Whenever the record is processed, the <a href="protocol.html">protocol</a>
|
||||||
|
@ -15,7 +15,7 @@
|
|||||||
<p>
|
<p>
|
||||||
<b>Note:</b> The scalcout record is part of the <i>calc</i> module of
|
<b>Note:</b> The scalcout record is part of the <i>calc</i> module of
|
||||||
the <a target="ex"
|
the <a target="ex"
|
||||||
href="http://www.aps.anl.gov/aod/bcda/synApps/index.php"
|
href="https://www.aps.anl.gov/BCDA/synApps"
|
||||||
><em>synApps</em></a> package.
|
><em>synApps</em></a> package.
|
||||||
Device support for scalcout records is only available for <i>calc</i>
|
Device support for scalcout records is only available for <i>calc</i>
|
||||||
module release 2-4 or higher.
|
module release 2-4 or higher.
|
||||||
|
@ -73,7 +73,7 @@ public:
|
|||||||
{init(NULL, size);}
|
{init(NULL, size);}
|
||||||
|
|
||||||
~StreamBuffer()
|
~StreamBuffer()
|
||||||
{if (buffer != local) delete buffer;}
|
{if (buffer != local) delete [] buffer;}
|
||||||
|
|
||||||
// operator (): get char* pointing to index
|
// operator (): get char* pointing to index
|
||||||
const char* operator()(ssize_t index=0) const
|
const char* operator()(ssize_t index=0) const
|
||||||
|
@ -1315,12 +1315,12 @@ normal_format:
|
|||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
case StreamProtocolParser::skip:
|
case StreamProtocolParser::skip:
|
||||||
// ignore next input byte
|
// ignore next input byte (if exists)
|
||||||
consumedInput++;
|
if (consumedInput < inputLine.length()) consumedInput++;
|
||||||
break;
|
break;
|
||||||
case StreamProtocolParser::whitespace:
|
case StreamProtocolParser::whitespace:
|
||||||
// any number of whitespace (including 0)
|
// any number of whitespace (including 0)
|
||||||
while (isspace(inputLine[consumedInput])) consumedInput++;
|
while (consumedInput < inputLine.length() && isspace(inputLine[consumedInput])) consumedInput++;
|
||||||
break;
|
break;
|
||||||
case esc:
|
case esc:
|
||||||
// escaped literal byte
|
// escaped literal byte
|
||||||
|
@ -534,11 +534,11 @@ long streamInitRecord(dbCommon* record, const struct link *ioLink,
|
|||||||
streamIoFunction readData, streamIoFunction writeData)
|
streamIoFunction readData, streamIoFunction writeData)
|
||||||
{
|
{
|
||||||
long status;
|
long status;
|
||||||
char filename[80];
|
char filename[256];
|
||||||
char protocol[80];
|
char protocol[256];
|
||||||
char busname[80];
|
char busname[256];
|
||||||
int addr = -1;
|
int addr = -1;
|
||||||
char busparam[80];
|
char busparam[256];
|
||||||
memset(busparam, 0 ,sizeof(busparam));
|
memset(busparam, 0 ,sizeof(busparam));
|
||||||
|
|
||||||
debug("streamInitRecord(%s): SEVR=%d\n", record->name, record->sevr);
|
debug("streamInitRecord(%s): SEVR=%d\n", record->name, record->sevr);
|
||||||
@ -831,7 +831,7 @@ initRecord(const char* filename, const char* protocol,
|
|||||||
return ERROR;
|
return ERROR;
|
||||||
}
|
}
|
||||||
debug("Stream::initRecord %s: initialized. %s\n",
|
debug("Stream::initRecord %s: initialized. %s\n",
|
||||||
name(), convert==2 ?
|
name(), convert == DO_NOT_CONVERT ?
|
||||||
"convert" : "don't convert");
|
"convert" : "don't convert");
|
||||||
return convert;
|
return convert;
|
||||||
}
|
}
|
||||||
@ -843,6 +843,7 @@ process()
|
|||||||
debug("Stream::process(%s)\n", name());
|
debug("Stream::process(%s)\n", name());
|
||||||
if (record->pact || record->scan == SCAN_IO_EVENT)
|
if (record->pact || record->scan == SCAN_IO_EVENT)
|
||||||
{
|
{
|
||||||
|
record->proc = 0;
|
||||||
if (status != NO_ALARM)
|
if (status != NO_ALARM)
|
||||||
{
|
{
|
||||||
debug("Stream::process(%s) error status=%s (%d)\n",
|
debug("Stream::process(%s) error status=%s (%d)\n",
|
||||||
@ -854,7 +855,7 @@ process()
|
|||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
debug("Stream::process(%s) ready. %s\n",
|
debug("Stream::process(%s) ready. %s\n",
|
||||||
name(), convert==2 ?
|
name(), convert == DO_NOT_CONVERT ?
|
||||||
"convert" : "don't convert");
|
"convert" : "don't convert");
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
@ -868,11 +869,15 @@ process()
|
|||||||
debug("Stream::process(%s) start\n", name());
|
debug("Stream::process(%s) start\n", name());
|
||||||
status = NO_ALARM;
|
status = NO_ALARM;
|
||||||
convert = OK;
|
convert = OK;
|
||||||
if (!startProtocol(record->proc==2 ? StreamCore::StartInit : StreamCore::StartNormal))
|
if (!startProtocol(record->proc == 2 ? StreamCore::StartInit : StreamCore::StartNormal))
|
||||||
{
|
{
|
||||||
debug("Stream::process(%s): could not start %sprotocol, status=%d\n",
|
debug("Stream::process(%s): could not start %sprotocol, status=%s (%d)\n",
|
||||||
name(), record->proc==2 ? "@init " : "", status);
|
name(), record->proc == 2 ? "@init " : "",
|
||||||
|
status >= 0 && status < ALARM_NSTATUS ?
|
||||||
|
epicsAlarmConditionStrings[status] : "ERROR",
|
||||||
|
status);
|
||||||
(void) recGblSetSevr(record, status ? status : UDF_ALARM, INVALID_ALARM);
|
(void) recGblSetSevr(record, status ? status : UDF_ALARM, INVALID_ALARM);
|
||||||
|
record->proc = 0;
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
debug("Stream::process(%s): protocol started\n", name());
|
debug("Stream::process(%s): protocol started\n", name());
|
||||||
@ -920,7 +925,7 @@ scan(format_t *format, void* value, size_t maxStringSize)
|
|||||||
currentValueLength = scanValue(*format->priv, *(double*)value);
|
currentValueLength = scanValue(*format->priv, *(double*)value);
|
||||||
break;
|
break;
|
||||||
case DBF_STRING:
|
case DBF_STRING:
|
||||||
currentValueLength = scanValue(*format->priv, (char*)value, size);
|
currentValueLength = scanValue(*format->priv, (char*)value, size);
|
||||||
break;
|
break;
|
||||||
default:
|
default:
|
||||||
error("INTERNAL ERROR (%s): Illegal format type %d\n",
|
error("INTERNAL ERROR (%s): Illegal format type %d\n",
|
||||||
|
@ -116,17 +116,11 @@ static long readData(dbCommon *record, format_t *format)
|
|||||||
if ((length = streamScanfN(record, format,
|
if ((length = streamScanfN(record, format,
|
||||||
(char *)aai->bptr, aai->nelm)) == ERROR)
|
(char *)aai->bptr, aai->nelm)) == ERROR)
|
||||||
{
|
{
|
||||||
memset(aai->bptr, 0, aai->nelm);
|
|
||||||
return ERROR;
|
return ERROR;
|
||||||
}
|
}
|
||||||
if (lval < (ssize_t)aai->nelm)
|
if (length < (ssize_t)aai->nelm)
|
||||||
{
|
{
|
||||||
memset(((char*)aai->bptr)+lval , 0, aai->nelm-lval);
|
((char*)aai->bptr)[length] = 0;
|
||||||
lval++;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
((char*)aai->bptr)[aai->nelm-1] = 0;
|
|
||||||
}
|
}
|
||||||
aai->nord = (long)length;
|
aai->nord = (long)length;
|
||||||
return OK;
|
return OK;
|
||||||
|
@ -108,22 +108,16 @@ static long readData(dbCommon *record, format_t *format)
|
|||||||
case DBF_CHAR:
|
case DBF_CHAR:
|
||||||
case DBF_UCHAR:
|
case DBF_UCHAR:
|
||||||
{
|
{
|
||||||
ssize_t length;
|
ssize_t length;
|
||||||
aao->nord = 0;
|
aao->nord = 0;
|
||||||
if ((length = streamScanfN(record, format,
|
if ((length = streamScanfN(record, format,
|
||||||
(char *)aao->bptr, aao->nelm)) == ERROR)
|
(char *)aao->bptr, aao->nelm)) == ERROR)
|
||||||
{
|
{
|
||||||
memset(aao->bptr, 0, aao->nelm);
|
|
||||||
return ERROR;
|
return ERROR;
|
||||||
}
|
}
|
||||||
if (length < (ssize_t)aao->nelm)
|
if (length < (ssize_t)aao->nelm)
|
||||||
{
|
{
|
||||||
memset(((char*)aao->bptr)+lval , 0, aao->nelm-lval);
|
((char*)aao->bptr)[length] = 0;
|
||||||
lval++;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
((char*)aao->bptr)[aao->nelm-1] = 0;
|
|
||||||
}
|
}
|
||||||
aao->nord = (long)length;
|
aao->nord = (long)length;
|
||||||
goto end_no_check;
|
goto end_no_check;
|
||||||
|
@ -23,30 +23,27 @@
|
|||||||
static long readData(dbCommon *record, format_t *format)
|
static long readData(dbCommon *record, format_t *format)
|
||||||
{
|
{
|
||||||
lsiRecord *lsi = (lsiRecord *)record;
|
lsiRecord *lsi = (lsiRecord *)record;
|
||||||
|
ssize_t length;
|
||||||
|
|
||||||
if (format->type == DBF_STRING)
|
if (format->type != DBF_STRING) return ERROR;
|
||||||
|
if ((length = streamScanfN(record, format, lsi->val, (long)lsi->sizv)) == ERROR)
|
||||||
{
|
{
|
||||||
long len;
|
return ERROR;
|
||||||
if ((len = streamScanfN(record, format, lsi->val, lsi->sizv) == ERROR))
|
|
||||||
{
|
|
||||||
lsi->len = 0;
|
|
||||||
return ERROR;
|
|
||||||
}
|
|
||||||
lsi->len = len;
|
|
||||||
return OK;
|
|
||||||
}
|
}
|
||||||
return ERROR;
|
if (length < (ssize_t)lsi->sizv)
|
||||||
|
{
|
||||||
|
lsi->val[length] = 0;
|
||||||
|
}
|
||||||
|
lsi->len = length;
|
||||||
|
return OK;
|
||||||
}
|
}
|
||||||
|
|
||||||
static long writeData(dbCommon *record, format_t *format)
|
static long writeData(dbCommon *record, format_t *format)
|
||||||
{
|
{
|
||||||
lsiRecord *lsi = (lsiRecord *)record;
|
lsiRecord *lsi = (lsiRecord *)record;
|
||||||
|
|
||||||
if (format->type == DBF_STRING)
|
if (format->type != DBF_STRING) return ERROR;
|
||||||
{
|
return streamPrintf(record, format, lsi->val);
|
||||||
return streamPrintf(record, format, lsi->val);
|
|
||||||
}
|
|
||||||
return ERROR;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
static long initRecord(dbCommon *record)
|
static long initRecord(dbCommon *record)
|
||||||
|
@ -24,17 +24,19 @@
|
|||||||
static long readData(dbCommon *record, format_t *format)
|
static long readData(dbCommon *record, format_t *format)
|
||||||
{
|
{
|
||||||
lsoRecord *lso = (lsoRecord *)record;
|
lsoRecord *lso = (lsoRecord *)record;
|
||||||
long len;
|
ssize_t length;
|
||||||
unsigned short monitor_mask;
|
unsigned short monitor_mask;
|
||||||
|
|
||||||
if (format->type != DBF_STRING)
|
if (format->type != DBF_STRING) return ERROR;
|
||||||
return ERROR;
|
if ((length = streamScanfN(record, format, lso->val, lso->sizv)) == ERROR)
|
||||||
if ((len = streamScanfN(record, format, lso->val, lso->sizv) == ERROR))
|
|
||||||
{
|
{
|
||||||
lso->len = 0;
|
|
||||||
return ERROR;
|
return ERROR;
|
||||||
}
|
}
|
||||||
lso->len = len;
|
if (length < (ssize_t)lso->sizv)
|
||||||
|
{
|
||||||
|
lso->val[length] = 0;
|
||||||
|
}
|
||||||
|
lso->len = length;
|
||||||
if (record->pact) return OK;
|
if (record->pact) return OK;
|
||||||
/* In @init handler, no processing, enforce monitor updates. */
|
/* In @init handler, no processing, enforce monitor updates. */
|
||||||
monitor_mask = recGblResetAlarms(record);
|
monitor_mask = recGblResetAlarms(record);
|
||||||
@ -60,11 +62,8 @@ static long writeData(dbCommon *record, format_t *format)
|
|||||||
{
|
{
|
||||||
lsoRecord *lso = (lsoRecord *)record;
|
lsoRecord *lso = (lsoRecord *)record;
|
||||||
|
|
||||||
if (format->type == DBF_STRING)
|
if (format->type != DBF_STRING) return ERROR;
|
||||||
{
|
return streamPrintf(record, format, lso->val);
|
||||||
return streamPrintf(record, format, lso->val);
|
|
||||||
}
|
|
||||||
return ERROR;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
static long initRecord(dbCommon *record)
|
static long initRecord(dbCommon *record)
|
||||||
|
@ -42,7 +42,7 @@ static long readData(dbCommon *record, format_t *format)
|
|||||||
return OK;
|
return OK;
|
||||||
}
|
}
|
||||||
case DBF_LONG:
|
case DBF_LONG:
|
||||||
case DBF_UONG:
|
case DBF_ULONG:
|
||||||
case DBF_ENUM:
|
case DBF_ENUM:
|
||||||
{
|
{
|
||||||
long lval;
|
long lval;
|
||||||
@ -72,7 +72,7 @@ static long writeData(dbCommon *record, format_t *format)
|
|||||||
return streamPrintf(record, format, sco->oval);
|
return streamPrintf(record, format, sco->oval);
|
||||||
}
|
}
|
||||||
case DBF_LONG:
|
case DBF_LONG:
|
||||||
case DBF_UONG:
|
case DBF_ULONG:
|
||||||
case DBF_ENUM:
|
case DBF_ENUM:
|
||||||
{
|
{
|
||||||
return streamPrintf(record, format, (long)sco->oval);
|
return streamPrintf(record, format, (long)sco->oval);
|
||||||
|
@ -117,21 +117,15 @@ static long readData(dbCommon *record, format_t *format)
|
|||||||
if ((length = streamScanfN(record, format,
|
if ((length = streamScanfN(record, format,
|
||||||
(char *)wf->bptr, wf->nelm)) == ERROR)
|
(char *)wf->bptr, wf->nelm)) == ERROR)
|
||||||
{
|
{
|
||||||
memset(wf->bptr, 0, wf->nelm);
|
|
||||||
return ERROR;
|
return ERROR;
|
||||||
}
|
}
|
||||||
if (length < (ssize_t)wf->nelm)
|
if (length < (ssize_t)wf->nelm)
|
||||||
{
|
{
|
||||||
memset(((char*)wf->bptr)+lval , 0, wf->nelm-lval);
|
((char*)wf->bptr)[length] = 0;
|
||||||
lval++;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
((char*)wf->bptr)[wf->nelm-1] = 0;
|
|
||||||
}
|
}
|
||||||
wf->nord = (long)length;
|
wf->nord = (long)length;
|
||||||
return OK;
|
return OK;
|
||||||
}
|
}
|
||||||
default:
|
default:
|
||||||
errlogSevPrintf(errlogFatal,
|
errlogSevPrintf(errlogFatal,
|
||||||
"readData %s: can't convert from string to %s\n",
|
"readData %s: can't convert from string to %s\n",
|
||||||
|
Reference in New Issue
Block a user