From e3dd0a319ae536b5f94ff98f0900998e93c10640 Mon Sep 17 00:00:00 2001 From: zimoch Date: Mon, 19 Sep 2011 09:30:00 +0000 Subject: [PATCH] updates --- doc/EPICS.gif | Bin 453 -> 0 bytes doc/SLS.gif | Bin 2285 -> 0 bytes doc/aai.html | 4 +- doc/aao.html | 4 +- doc/ai.html | 6 +- doc/ao.html | 6 +- doc/bg.gif | Bin 868 -> 0 bytes doc/bi.html | 4 +- doc/bo.html | 4 +- doc/businterface.html | 4 +- doc/calcout.html | 4 +- doc/epics3_13.html | 4 +- doc/favicon.ico | Bin 0 -> 1078 bytes doc/formatconverter.html | 209 +++++++++++++++++++++- doc/formats.html | 231 +++++++++++++++++++----- doc/head.html | 32 ---- doc/index.html | 124 +++++++++++-- doc/longin.html | 6 +- doc/longout.html | 6 +- doc/mbbi.html | 4 +- doc/mbbiDirect.html | 4 +- doc/mbbo.html | 4 +- doc/mbboDirect.html | 4 +- doc/nav.html | 375 +++++++++++++++++++-------------------- doc/osinterface.html | 4 +- doc/printer.gif | Bin 1274 -> 0 bytes doc/processing.html | 4 +- doc/protocol.html | 80 ++++++--- doc/recordinterface.html | 4 +- doc/recordtypes.html | 4 +- doc/scalcout.html | 4 +- doc/setup.html | 192 ++++++++++++++------ doc/sls_icon.ico | Bin 318 -> 0 bytes doc/space.gif | Bin 807 -> 0 bytes doc/stream.css | 82 +++++++-- doc/stream.html | 92 ---------- doc/stream.js | 5 - doc/stringin.html | 4 +- doc/stringout.html | 4 +- doc/tipsandtricks.html | 34 ++-- doc/waveform.html | 4 +- 41 files changed, 1014 insertions(+), 542 deletions(-) delete mode 100644 doc/EPICS.gif delete mode 100644 doc/SLS.gif delete mode 100644 doc/bg.gif create mode 100644 doc/favicon.ico delete mode 100644 doc/head.html delete mode 100644 doc/printer.gif delete mode 100644 doc/sls_icon.ico delete mode 100644 doc/space.gif delete mode 100644 doc/stream.html delete mode 100644 doc/stream.js diff --git a/doc/EPICS.gif b/doc/EPICS.gif deleted file mode 100644 index 1d4a4b7af934c1162d19189b609811459e2b6589..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 453 zcmV;$0XqIiNk%w1VKM+R0P_q0000000RI6007*$zZEaPOlB%}0s4`lI>5*}Di#Xu5028N3!yBJF#(~c(Dl4^kHhKB`^ z5LZ(b0|X2ZF*10D%Mvk#nQ&dP4Gv`hQg=ER30oZnd=ytjAczxrGzE%+aUF{jjeSoY zFb7&!Xo+nmn~X%DHa`n#jx@ z0n^k0$sG&X+6&3V($&+~0NdK#!{6ZI+Qkl)%xW40rN)< z;5LE32*!Ix51}t)@*qZo7HAnWM!W1??2~aL290wcJwAg-vLr>5C{q%;2-1qkA{}31 z)YY;W$%+>5os?)3fPkMse{$)dps3NJ4taG58gwXtqeqiw^vP7HC8AJ~)_h2{s?)4m vjV-Mz;44_EG`li2n-y)Yv0kq}J-f9R+_iGSDsZdeW;16!cT$x3D*^yJuYb%` diff --git a/doc/SLS.gif b/doc/SLS.gif deleted file mode 100644 index 08a8734cceb0777913e573794bbf1dc5d9bbb4fd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2285 zcmd5*`#Y5T7GLwu%$^s?U}m!Srd(piq&Cs6NA30-gNcfe7^5vkqE52YQA&fvkRq21 zax2nAQP{E@W6I@C6mp9&-Bh}qNu6%Wd&WNJ{C56;v!3;=XMMlx^Q>omKI{8+S?j!F z`PNgg96o~D2wUj1wIxE-9zsaeE+HhHM5l!4R7ZlCy$z8NheZFQHmxH5f}kiW1R64~ zZU!KSIS~I2{5U|x029H-9{|w>Kmq8$Q2qx393UxCk`ZMp1$|BhvWQaL4*5*bMFB-| z4O{_CraA**gQ4mfS3Ck#GGG{pDB2>NJ*@x^6EJm0oDbt;KoB68^PX*&jU?%iX&8p$ z6kKsj!DKSSt&hR%R7#K|dDd^yiI zOm+g*p`jSMLKJv+S~Z8m01*k=|3ae>8tSVYACt@F3C`B2+X)JdhLgcuRe_A>D+ygh zj;=$Z5g1bffq;AquM3sMQFLfPQ2{sr=+BD5Q-SO;=n#O(8|HJ41f%P z0Z&AE*bW2};c|$BY~!cr3mSy zc!~zgL%Pb+n8R&%uf{KMgP^Hu4p+qvPYf~L#`lsnOHjy^g+&&@hE=hD>60S$}b z$~t?mKE!=yTYIeGJ7L!F;(|T94qTsprSh_$*YN(^r|dYJMNWIR#t*!^Y4Wt_u&ktg z)bsAQkA|*{Pwhnq-|M0yd)doQ8;4BUM0ti^(zRQIe8<2rg#10dSYys)s-tT+vB z`pj|7C){(sQ!je>bA`;!hYboTihu&A{vEl?f-IYJS&WGCl0$6`l~Ox_H&nHxaJy^E zJS|^fX4DakUsu(VxBg7xb`o--DaHKCoxBcq8R^3PTY`QoUU<(4J3i_1Fc@MCkm zrs4Ic^{m=O|F{Y(3^(SSoG^Szp}A>XbvbH-&tE`QqR=B)j#OY=pO|NNEo`k1*L?|Y$|yAhe5*fj~br{T^Sd9)3t zmmeA88_5^9`Aho@wDv*H+?(MwIh)+~E$ct|NAfO7fc}S#8=jT*XHFa(`S#(wR*^we zjo)n}U4-ei^6CwWWJ`KLzCbV%TR7Nsty6mA%%l2ME@@NuTYbDgx23lYKf7zE`;&cI z;?F0zcaBJ7ZQpW7ZU^P*b9DOP(#3-6;qNT9f0^v@+>UkJOp=>k@#-0!ekY?vh}K*u zTd(REaI_nYo#vuq+k8Sc{b~X zYS4E60B)>7KU-oTv2_`)j`Hr^>eB6G8*X$eWUHw;#O#p$8g}nQ<)EX1nsUdArpW}O z1LynFgB6Q3GmA)lddGeE8(x`cWou+{0 zf4qB-vA*cJn3C>lH$x9jJlgBwW$Cf`694>ttw%;qE|s^JWk`e8ijp;}eURFys&I2Y zq9=kV))Pk*UlgDl0kSXImk;z`Bu$1vV{hGM8dURO%FR+T3 A!vFvP diff --git a/doc/aai.html b/doc/aai.html index f50e3d9..8c1008f 100644 --- a/doc/aai.html +++ b/doc/aai.html @@ -3,12 +3,13 @@ StreamDevice: aai Records - + +

StreamDevice: aai Records

Note: aai record support is disabled per default. @@ -123,6 +124,5 @@ the written or read value. scalcout

Dirk Zimoch, 2006

- diff --git a/doc/aao.html b/doc/aao.html index 24c4ba4..51a7f68 100644 --- a/doc/aao.html +++ b/doc/aao.html @@ -3,12 +3,13 @@ StreamDevice: aao Records - + +

StreamDevice: aao Records

Note: aao record support is disabled per default. @@ -123,6 +124,5 @@ the written or read value. scalcout

Dirk Zimoch, 2006

- diff --git a/doc/ai.html b/doc/ai.html index 51be662..52399d5 100644 --- a/doc/ai.html +++ b/doc/ai.html @@ -3,12 +3,13 @@ StreamDevice: ai Records - + +

StreamDevice: ai Records

Normal Operation

@@ -38,6 +39,8 @@ written or read value. definition. StreamDevice does not set it. For example, EOFF=-10 and ESLO=0.000305180437934 (=20.0/0xFFFF) maps 0x0000 to -10.0, 0x7FFF to 0.0 and 0xFFFF to 10.0. + Using unsigned formats with values ≥ 0x800000 gives different results + on 64 bit machines.
ENUM format (e.g. %{):
@@ -76,6 +79,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/ao.html b/doc/ao.html index 75c88fb..88ebbda 100644 --- a/doc/ao.html +++ b/doc/ao.html @@ -3,12 +3,13 @@ StreamDevice: ao Records - + +

StreamDevice: ao Records

Normal Operation

@@ -37,6 +38,8 @@ written or read value. might be set in the record definition. StreamDevice does not set it. For example, EOFF=-10 and ESLO=0.000305180437934 (=20.0/0xFFFF) maps -10.0 to 0x0000, 0.0 to 0x7FFF and 10.0 to 0xFFFF. + Using unsigned formats with values ≥ 0x800000 gives different results + on 64 bit machines.
ENUM format (e.g. %{):
@@ -77,6 +80,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/bg.gif b/doc/bg.gif deleted file mode 100644 index e86e76c39a936c966f8a4c586ea5288ba70ca397..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 868 zcmZ?wbhEHb StreamDevice: bi Records - + +

StreamDevice: bi Records

Normal Operation

@@ -72,6 +73,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/bo.html b/doc/bo.html index 638621b..00c4a74 100644 --- a/doc/bo.html +++ b/doc/bo.html @@ -3,12 +3,13 @@ StreamDevice: bo Records - + +

StreamDevice: bo Records

Normal Operation

@@ -71,6 +72,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/businterface.html b/doc/businterface.html index ff77a01..eef0ac9 100644 --- a/doc/businterface.html +++ b/doc/businterface.html @@ -3,12 +3,13 @@ StreamDevice: Bus API - + +

Bus API

@@ -640,6 +641,5 @@ other request method like writeRequest().

Dirk Zimoch, 2007

- diff --git a/doc/calcout.html b/doc/calcout.html index 5376631..49ace51 100644 --- a/doc/calcout.html +++ b/doc/calcout.html @@ -3,12 +3,13 @@ StreamDevice: calcout Records - + +

StreamDevice: calcout Records

@@ -78,6 +79,5 @@ Different record fields are used for output and input. The variable scalcout

Dirk Zimoch, 2005

- diff --git a/doc/epics3_13.html b/doc/epics3_13.html index 674da8b..acdbd12 100644 --- a/doc/epics3_13.html +++ b/doc/epics3_13.html @@ -3,12 +3,13 @@ StreamDevice: Using EPICS 3.13 - + +

StreamDevice: Using EPICS 3.13

@@ -219,6 +220,5 @@ asynSetOption ("PS1", 0, "stop", "1")

Dirk Zimoch, 2006

- diff --git a/doc/favicon.ico b/doc/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..67381a6b47ac66639dda344dfeb7e6577b61abba GIT binary patch literal 1078 zcmd5*y-LGi6g~YJsw5EKpg2f}4njwlJb{aYQY`cl>Lf~sj-rTFQ2cag=vvyb5^dpw z7UGaVmWqR!>fqWZsQ2cl25Ideh=<%8&b{Y;Ik_Z20!e6^M)x#w319<2HXHDdB(P1j z9Mv?gQ?PCkjt`G;c5;e)aR;MeplLMGX?M_j>OuB<7!HOQjb1Pwzhg3)U^<;HI%;lR zv3*EI&zF%-OFNTSY${r@h@G_KPLdFD`L=eS>DBfmW-HZubGE`RMP;vYvmnE3)u+@I222 zr2v4-7bPDm5vNStp|*71RH&|3p$S$~Qr*{@cTgzkLWn-`%sFu*m@P#-kotPR|D9j0 z(`cQB!g*6Tu4f8SVNTDB>DADRG4nIC8u?}U7XmB)DARwl6taR;6gB=F7l3;bqzz-~ H!6f(u@c2D# literal 0 HcmV?d00001 diff --git a/doc/formatconverter.html b/doc/formatconverter.html index 54e9cc1..83619f9 100644 --- a/doc/formatconverter.html +++ b/doc/formatconverter.html @@ -3,18 +3,219 @@ StreamDevice: Format Converter API - + +

StreamDevice: Format Converter API

-

Sorry, this documentation is still missing.

+ +

Converter Class

+

+A user defined converter class inherits public from +StreamFormatConverter and handles one or more conversion characters. +It is not necessary that a given conversion character supports both, +printing and scanning. +But if it does, both must be handled by the same converter class. +

+

+Any conversion corresponds to one data type. The converter class must +implement print and/or scan methods for this data type. It must also +implement a parse method to analyse the format string. +

+

+A converter class must be registered with a call to RegisterConverter() +in the global file context. +

+

+The converter must not contain any class variables, because there will be +only one global instance for each conversion character - not one for each +format string! +

+ +

Example: LONG converter for %Q

+
+#include "StreamFormatConverter.h"
+
+class MyConverter : public StreamFormatConverter
+{
+    int parse(const StreamFormat&, StreamBuffer&, const char*&, bool);
+    bool printLong(const StreamFormat&, StreamBuffer&, long);
+    int scanLong(const StreamFormat&, const char*, long&);
+};
+
+RegisterConverter(MyConverter,"Q");
+
+// ... (implementation)
+
+ + +

Theroy of Operation

+ + +

Registration

+
+RegisterConverter(converterClass, "characters"); +
+

+This macro registers the converter class for all given conversion +characters. In most cases, you will give only one character. +The macro must be called once for each class in the global file context. +

+

+HINT: Do not branch depending on the conversion character. +Provide multiple classes, that's more efficient. +

+ + +

Parsing

+
+int parse (const StreamFormat& fmt, StreamBuffer& info, +const char*& source, bool scanFormat); +
+
+struct StreamFormat { +char conv; +StreamFormatType type; +unsigned char flags; +short prec; +unsigned short width; +unsigned short infolen; +const char* info; +}; +
+ +

+During initialization, parse() is called whenever one of the +conversion characters handled by your converter class is found in a protocol. +The fields fmt.conv, fmt.flags, +fmt.prec, and fmt.width have +already been filled in. If a scan format is parsed, scanFormat +is true. If a print format is parsed, scanFormat +is false. +

+

+The fmt.flags field is a bitset and can have any of the following +flags set: +

+
    +
  • left_flag: the format contained a -. + This is normaly used to indicate that the value should be printed + left-aligned. +
    • +
  • sign_flag: the format contained a +. + This normaly requests to print a sign even for positive numbers. +
    • +
  • space_flag: the format contained a ' ' (space). + This normaly requests to print a space instead of a sign for positive numbers. +
    • +
  • alt_flag: the format contained a #. + This indicated the request to use an alternative format. For example in + %#x the hex number is preficed with 0x. +
    • +
  • zero_flag: the format contained a 0. + This normaly requests to pad a numerical value with leading zeros + instead of leading spaces. +
  • skip_flag: the format contained a *. + The value is parsed and checked but then discarded. +
+

+It is not necessary that these flags have exactly the same meaning in your +formats, but a similar and intuitive meaning helpful for the user. +

+

+There are two additional flags, default_flag indicating a +? and compare_flag indicating a = +int the format, that are handled internally by StreamDevice and +are not of interest to the converter class. +

+

+The source pointer points to the character of the format string +just after the conversion character. You can parse additional characters if +they belong to the format string handled by your class. +Move the source pointer so that is points to the first character +after your format string. +This is done for example in the builtin formats +%[charset] or %{enum0|enum1}. +However, many formats don't need additional characters. + +

+

Example

+
+ source       source
+ before       after
+ parse()      parse()
+     |         |
+"%39[0-9a-zA-Z]constant text"
+    |
+ conversion
+ character
+
+ +

+You can write any data you may need later in print*() or +scan*() to the +Streambuffer info. +This will probably be necessary if you have parsed additional characters +from the format string as in the above example
+

+

+Return long_format, double_format, +string_format, or enum_format depending on the +datatype associated with the conversion character. +It is not necessary to return the same value for print and for scan +formats. +You can even return different values depending on the format string, +but I can't imagine why anyone should do that. +

+

+If the format is not a real data conversion but does other things with +the data (append or check a checksum, encode or decode the data,...), +return pseudo_format. +

+

+Return false if there is any parse error or if print or scan +is requested but not supported by this conversion. +

+ + +

Printing and Scanning

+

+Provide a print[Long|Double|String|Pseudo]() and/or +scan[Long|Double|String|Pseudo]() method appropriate +for the data type you have returned in the parse() method. +That method is called whenever the conversion appears in an output or input, +respectively. +You only need to implement the flavour of print and/or scan suitable for +the datatype returned by parse(). +

+

+Now, fmt.type contains the value returned by parse(). +With fmt.info() get access to the string you have written to +info in parse() (null terminated). +

+

+The length of the info string can be found in fmt.infolen. +

+

+In print*(), append the converted value to output. +Do not modify what is already in output (unless you really know what you're +doing). +Return true on success, false on failure. +

+

+In scan*(), read the value from input and return the number of +consumed bytes. +In the string version, don't write more bytes than maxlen! +If the skip_flag is set, you don't need to write to +value, since the value will be discarded anyway. +Return -1 on failure. +

-

Dirk Zimoch, 2006

- +

Dirk Zimoch, 2007

diff --git a/doc/formats.html b/doc/formats.html index 6e6adb8..40b7055 100644 --- a/doc/formats.html +++ b/doc/formats.html @@ -3,12 +3,13 @@ StreamDevice: Format Converters - + +

StreamDevice: Format Converters

@@ -27,8 +28,8 @@ A format converter consists of

  • The % character
    • -
  • Optionally a field name in ()
    • -
  • Optionally flags out of the characters *# +0-
    • +
  • Optionally a field or record name in ()
    • +
  • Optionally flags out of the characters *# +0-?=
  • Optionally an integer width field
  • Optionally a period character (.) followed by an integer precision field (input ony for most formats)
    • @@ -36,6 +37,11 @@ A format converter consists of
  • Additional information required by some converters
+

+The flags *# +0- work like in the C functions +printf() and scanf(). +The flags ? and = are extensions. +

The * flag skips data in input formats. Input is consumed and parsed, a mismatch is an error, but the read @@ -61,6 +67,16 @@ The 0 flag says that numbers should be left padded with The - flag specifies that output is left justified if width is larger than required.

+

+The ? flag makes failing input conversions succeed with +a default zero value (0, 0.0, or "", depending on the format type). +

+

+The = flag allows to compare input with current values. +It is only allowed in input formats. +Instead of reading a new value from input, the current value is +formatted (like for output) and then compared to the input. +

Examples:

@@ -84,6 +100,14 @@ The - flag specifies that output is left justified if + + + + + + + +
in "%*i"; skipped integer number
in "%?d";decimal number or nothing (read as 0)
in "%=.3f";compare input to the current value formatted as a float with precision 3
@@ -108,18 +132,24 @@ Thus, data type modifiers like l or h do not exist in StreamDevice formats.

-

Accessing record fields directly

+

Redirection

To use other fields of the record or even fields of other records on the same IOC for the conversion, write the field name in parentheses directly after the %. For example out "%(EGU)s"; outputs the EGU field formatted as a string. -Use in "%(otherrecord.VAL)f"; to write the floating -point input value into the VAL field of -otherrecord. -(You can't skip .VAL here.) -This is very useful when one line of input contains many values that should +Use in "%(otherrecord.RVAL)f"; to write the floating +point input value into the RVAL field of +otherrecord. + +If no field is given for an other record .VAL is assumed. +When a record name conflicts with a field name use .VAL explicitly. + + +

+

+This feature is very useful when one line of input contains many values that should be distributed to many records. If otherrecord is passive and the field has the PP attribute (see @@ -129,6 +159,8 @@ It is your responsibility that the data type of the record field is compatible to the the data type of the converter. Note that using this syntax is by far not as efficient as using the default field. +At the moment it is not possible to set otherrecord to an alarm +state when anything fails.

Pseudo-converters

@@ -144,31 +176,42 @@ No data type corresponds to those pseudo-converters and the

3. Standard DOUBLE Converters (%f, %e, %E, %g, %G)

-In output, %f prints fixed point, %e prints +Output: %f prints fixed point, %e prints exponential notation and %g prints either fixed point or exponential depending on the magnitude of the value. %E and %G use E instead of e to separate the exponent. +

+

With the # flag, output always contains a period character.

-In input, all these formats are equivalent. -Leading whitespaces are skipped. +Input: All these formats are equivalent. Leading whitespaces are skipped. +

+

+With the # flag additional whitespace between sign and number +is accepted. +

+

+When a maximum field width is given, leading whitespace only counts to the +field witdth when the space flag is given.

4. Standard LONG Converters (%d, %i, %u, %o, %x, %X)

-In output, %d and %i print signed decimal, +Output: %d and %i print signed decimal, %u unsigned decimal, %o unsigned octal, and %x or %X unsigned hexadecimal. %X uses upper case letters. +

+

With the # flag, octal values are prefixed with 0 and hexadecimal values with 0x or 0X.

-In input, %d matches signed decimal, %u matches +Input: %d matches signed decimal, %u matches unsigned decimal, %o unsigned octal. %x and %X both match upper or lower case unsigned hexadecimal. @@ -177,23 +220,40 @@ Octal and hexadecimal values can optionally be prefixed. hexadecimal notation. Leading whitespaces are skipped.

+

+With the - negative octal and hexadecimal values are accepted. +

+

+With the # flag additional whitespace between sign and number +is accepted. +

+

+When a maximum field width is given, leading whitespace only counts to the +field witdth when the space flag is given. +

5. Standard STRING Converters (%s, %c)

-In output, %s prints a string. +Output: %s prints a string. If precision is specified, this is the maximum string length. %c is a LONG format in output, printing one character!

-In input, %s matches a sequence of non-whitespace characters -and %c a sequence of not-null characters. +Input: %s matches a sequence of non-whitespace characters +and %c matches a sequence of not-null characters. The maximum string length is given by width. The default width is infinite for %s and 1 for %c. -Leading whitespaces are skipped with %s but not with -%c. -The empty string matches. +Leading whitespaces are skipped with %s + +except when the space flag is given +but not with %c. +The empty string matches. +

+

+With the # flag %s matches a sequence of not-null +characters instead of non-whitespace characters.

@@ -217,14 +277,24 @@ to z. This format maps an unsigned integer value on a set of strings. The value 0 corresponds to string0 and so on. The strings are separated by |. -If one of the strings contains | or }, -a \ must be used to escape the character.

Example: %{OFF|STANDBY|ON} mapps the string OFF to the value 0, STANDBY to 1 and ON to 2.

+When using the # flag it is allowed to assign integer values +to the strings using =. +

+

+Example: %#{neg=-1|stop=0|pos=1|fast=10}. +

+

+If one of the strings contains | or } +(or = if the # flag is used) +a \ must be used to escape the character. +

+

In output, depending on the value, one of the strings is printed.

@@ -248,12 +318,11 @@ Examples: %B.! or %B\x00\xff. %B01 is equivalent to %b.

-If in output width is larger than the number of significant bits, +In output, if width is larger than the number of significant bits, then the flag 0 means that the value should be padded with with the chosen zero character instead of spaces. If precision is set, it means the number of significant bits. Otherwise, the highest 1 bit defines the number of significant bits. -There is no alternate format when # is used.

In input, leading spaces are skipped. @@ -275,11 +344,9 @@ endian, i.e. least significant byte first. With the 0 flag, the value is unsigned, otherwise signed.

-In output, the width least significant bytes of the value -are written. -If width is larger than the size of a long, -the value is sign extended or zero extended, depending on the -0 flag. +In output, the prec (or sizeof(long) whatever is less) least +significant bytes of the value are sign extended or zero extended +(depending on the 0 flag) to width bytes.

In input, width bytes are read and put into the value. @@ -289,9 +356,25 @@ If width is smaller than the size of a long, the value is sign extended or zero extended, depending on the 0 flag.

+

+Example: out "%.2r" +

+ + +

10. Raw DOUBLE Converter (%R)

+

+The raw converter does not really "convert". +A float or double value is written or read in the internal +(maybe IEEE) representation of the computer. +The normal byte order is big endian, i.e. most significant byte +first. +With the # flag, the byte order is changed to little +endian, i.e. least significant byte first. +The width must be 4 (float) or 8 (double). The default is 4. +

-

10. Packed BCD (Binary Coded Decimal) LONG Converter (%D)

+

11. Packed BCD (Binary Coded Decimal) LONG Converter (%D)

Packed BCD is a format where each byte contains two binary coded decimal digits (0 ... 9). @@ -320,7 +403,7 @@ than 9.

-

11. Checksum Pseudo-Converter (%<checksum>)

+

12. Checksum Pseudo-Converter (%<checksum>)

This is not a normal "converter", because no user data is converted. Instead, a checksum is calculated from the input or output. @@ -399,6 +482,9 @@ In input, the next byte or bytes must match the checksum. href="http://www.joegeluso.com/software/articles/ccitt.htm">correct?) implementation of the CCITT standard 16 bit crc checksum with augment. (poly=0x1021, init=0x1D0F, xorout=0x0000).

+
%<ccitt16x> or %<crc16c> or %<xmodem>
+
Two bytes. The XMODEM checksum. + (poly=0x1021, init=0x0000, xorout=0x0000).
%<crc32>
Four bytes. The standard 32 bit crc checksum. (poly=0x04C11DB7, init=0xFFFFFFFF, xorout=0xFFFFFFFF).
@@ -450,7 +536,7 @@ If prec is given, it specifies the sub-expression whose match is retuned. Otherwise the complete match is returned. In any case, the complete match is consumed from the input buffer. -If the expression contains a / is must be escaped. +If the expression contains a / it must be escaped.

Example: %.1/<title>(.*)<\/title>/ returns @@ -458,23 +544,82 @@ the title of an HTML page, skipps anything before the <title> tag and leaves anything after the </title> tag in the input buffer.

- -

13. Exponential DOUBLE converter (%m)

+ +

13. MantissaExponent DOUBLE converter (%m)

-This experimental input-only format matches numbers in the format -[sign] mantissa sign exponent, e.g +123-4 meaning -123e-4 or 0.0123. Mantissa and exponent are integers. The sign of the -mantissa is optional. Compared to the standard %e format, -this format does not contain the characters . and e. +This exotic and experimental format matches numbers in the format +[sign] mantissa sign exponent, e.g +123-4 meaning +123e-4 or 0.0123. Mantissa and exponent are decimal integers. +The sign of the mantissa is optional. +Compared to the standard %e format, this format does not +contain the characters . and e.

Output formatting is ambigous (e.g. 123-4 versus -1230-5). Until it has been specified how to handle this, -output is not supported. +1230-5). I chose the following convention: +Format precision defines number of digits in mantissa. +No leading '0' in mantissa (except for 0.0 of course). +Number of digits in exponent is at least 2. +Format flags +, -, and space are supported in +the usual way (always sign, left justified, space instead of + sign). +Flags # and 0 are unsupported.

+
+ +

14. Timestamp DOUBLE converter (%T(timeformat))

+

+This format reads or writes timestamps and converts them to a double number. +The value represents the number of seconds since 1970 (the UNIX epoch). +The precision of a double is large enough for microseconds (but not for +nanoseconds). This format is probably used best in combination with a +redirection to the TIME field. In this case, the value is +converted to EPICS timestamps (seconds since 1990 and nanoseconds). +The timestamp format understands the usual converters that the C function +strftime() understands. In addition, fractions of a second can +be specified and the time zone can be set in the format string. +

+

+Example: %(TIME)T(%d %b %Y %H:%M:%.3S %z) may print something like + 3 Sep 2010 15:45:59 +0200. +

+

+Fractions of a second can be specified as %.nS +(seconds with n fractional digits), as %0nf +or %nf (n fractional digits) or as +%N (nanoseconds). +In input, n is the maximum number of digits parsed, there may be +actually less digits in the input. +If n is not specified (%.S or %f) it uses +a default value of 6. +

+

+In input, the time zone can be specified in the format like +%+hhmm or %-hhmm for cases +where the parsed time stamp does not specify the time zone, where +hhmm is a 4 digit number specifying the offset in hours and minutes. +

+

+In output, the system function strftime() is used to format the time. +There may be differences in the implementation between operating systems. +

+

+In input, StreamDevice used its own implementation because many +systems are missing the strptime() function and additional formats +are supported. +

+

+Day of the week can be parsed but is ignored because the information is +redundant when used together with day, month and year and more or less +useless otherwise. No check is done for consistency. +

+

+Because of the complexity of the problem, locales are not supported. +Thus, only the English month names can be used (week day names are +ignored anyway). +

+

Next: Record Processing

-

Dirk Zimoch, 2007

- +

Dirk Zimoch, 2011

diff --git a/doc/head.html b/doc/head.html deleted file mode 100644 index 98913e5..0000000 --- a/doc/head.html +++ /dev/null @@ -1,32 +0,0 @@ - - - -Headbar - - - - - - - - - - - - - - - - - -
PSI
EPICS - StreamDevice
SLS
- - diff --git a/doc/index.html b/doc/index.html index 4c6c671..aa0f43a 100644 --- a/doc/index.html +++ b/doc/index.html @@ -1,20 +1,116 @@ - + -StreamDevice Documentation - +StreamDevice + + - - - - - - - - <a href="stream.html">Click here for no-frames version.</a> - - + + +

EPICS StreamDevice

+ +

What is StreamDevice?

+

+StreamDevice is a generic +EPICS +device support for devices with a "byte stream" based +communication interface. +That means devices that can be controlled by sending and +receiving strings (in the broadest sense, including non-printable +characters and even null-bytes). +Examples for this type of communication interface are +serial line (RS-232, RS-485, ...), +IEEE-488 (also known as GPIB or HP-IB), and telnet-like TCP/IP. +

+

+StreamDevice is not limited to a specific device type or +manufacturer nor is it necessary to re-compile anything to support a +new device type. +Instead, it can be configured for any device type with +protocol files in plain ASCII text +which describes the commands a device understands and the replies it sends. +If the device can be controlled with strings like +"RF:FREQ 499.655 MHZ" StreamDevice can be used. +Formatting and parsing of values is done with +format converters similar to those +known from the C functions printf() and scanf(). +To support other formats, it is possible to +write your own converters. +

+

+Each record with StreamDevice support runs one protocol +from the protocol file to read or write its value. +Protocols can be as simple as just one output string or can +consist of many strings sent to and read from the device. +However, a protocol is linear. +That means it runs from start to end each time the record is +processed. +It does not provide loops or branches. +

+

+StreamDevice comes with an interface to +asynDriver +but can be extended to +support other bus drivers. +Note that StreamDevice is not an alternative or replacement +but a supplement for asynDriver. +StreamDevice converts record values to and from strings but +leaves it to asynDriver (or other bus interfaces) to exchange +these strings with the device. +Thus any bus type supported by asynDriver (to be exact by +asynOctet) can automatically be used with StreamDevice. +

+

+StreamDevice supports all +standard records of EPICS base +which can have device support. +It is also possible to +write support for new record types. +

+ +

What is StreamDevice not?

+

+It is not a programming language for a high-level application. +It is, for example, not possible to write a complete scanning program +in a protocol. +Use other tools for that and use StreamDevice only for the +primitive commands. +

+

+It is not a block oriented device support. +It is not possible to send or receive huge blocks of data that contain +many process variables distributed over many records. +

+ +

Recommended Readings

+

+IOC Application Developer's Guide (PDF) +

+

+EPICS Record Reference Manual +

+ +

Color and Style Conventions

+

+In this document, code is witten in green fixed width font. +This marks text you typically type in configuration files etc. +

+
+Longer code segments are often set in a box.
+
+

+Important modifications and new features are +highlighted with a yellow background. +Obsolete features are highlighted and crossed out. +

+
+

Next: Setup

+

Dirk Zimoch, 2011

+ diff --git a/doc/longin.html b/doc/longin.html index 74dc3a8..94fb373 100644 --- a/doc/longin.html +++ b/doc/longin.html @@ -3,12 +3,13 @@ StreamDevice: longin Records - + +

StreamDevice: longin Records

Normal Operation

@@ -25,6 +26,8 @@ written or read value.
Output: x=VAL
Input: VAL=x + Using unsigned formats with values ≥ 0x800000 gives different results + on 64 bit machines.
ENUM format (e.g. %{):
@@ -63,6 +66,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/longout.html b/doc/longout.html index af8820d..d7e1ab2 100644 --- a/doc/longout.html +++ b/doc/longout.html @@ -3,12 +3,13 @@ StreamDevice: longout Records - + +

StreamDevice: longout Records

Normal Operation

@@ -25,6 +26,8 @@ written or read value.
Output: x=VAL
Input: VAL=x + Using unsigned formats with values ≥ 0x800000 gives different results + on 64 bit machines.
ENUM format (e.g. %{):
@@ -63,6 +66,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/mbbi.html b/doc/mbbi.html index 3e5caba..a2ad2d3 100644 --- a/doc/mbbi.html +++ b/doc/mbbi.html @@ -3,12 +3,13 @@ StreamDevice: mbbi Records - + +

StreamDevice: mbbi Records

Normal Operation

@@ -89,6 +90,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/mbbiDirect.html b/doc/mbbiDirect.html index e7bb376..53a8ff3 100644 --- a/doc/mbbiDirect.html +++ b/doc/mbbiDirect.html @@ -3,12 +3,13 @@ StreamDevice: mbbiDirect Records - + +

StreamDevice: mbbiDirect Records

Normal Operation

@@ -75,6 +76,5 @@ written or read value. calcout

Dirk Zimoch, 2005

- diff --git a/doc/mbbo.html b/doc/mbbo.html index 5c4d961..ed08e0a 100644 --- a/doc/mbbo.html +++ b/doc/mbbo.html @@ -3,12 +3,13 @@ StreamDevice: mbbo Records - + +

StreamDevice: mbbo Records

Normal Operation

@@ -90,6 +91,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/mbboDirect.html b/doc/mbboDirect.html index e7f6d17..b193d6f 100644 --- a/doc/mbboDirect.html +++ b/doc/mbboDirect.html @@ -3,12 +3,13 @@ StreamDevice: mbboDirect Records - + +

StreamDevice: mbboDirect Records

Normal Operation

@@ -77,6 +78,5 @@ written or read value. scalcout

Dirk Zimoch, 2005

- diff --git a/doc/nav.html b/doc/nav.html index 14801f9..40d04de 100644 --- a/doc/nav.html +++ b/doc/nav.html @@ -5,216 +5,209 @@ Navbar - - -

-

-
-

User's Guide

-
- Intro -
-
- Setup - - -
-
- Protocol Files - - -
-
- Format Converters - - -
-
- Record Processing - - -
-
- Record Types - - -
-
- Tips & Tricks - - -
- -

Programmer's Guide

-
- Record API -
-
- Bus API - - -
-
- Format Converter API -
-
- Operating System API + +

User's Guide

+
+ Intro +
+ -

- -

+ + + + + + +

Programmer's Guide

+ + + + diff --git a/doc/osinterface.html b/doc/osinterface.html index 89c9fff..cbe72bf 100644 --- a/doc/osinterface.html +++ b/doc/osinterface.html @@ -3,18 +3,18 @@ StreamDevice: Operating System API - + +

StreamDevice: Operating System API

Sorry, this documentation is still missing.

Dirk Zimoch, 2006

- diff --git a/doc/printer.gif b/doc/printer.gif deleted file mode 100644 index c3ef2ea85592fd5da1cce55c3bfbf4ab8abe344e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1274 zcmZ?wbhEHbRAx|O_|5aAlZBCiL7qVeN=lU@GXpD^fW;TCZHJ;+t<()lXNftsa_R|hdTV|0L+kNI)0h*Hj%%6@vt1FI zv+H0}#9`qNcH0sjHk~_ME}URC;pT&;+1w%l8wwUUu=8;W#B6X__$l_VsKAD_+U*a* zdE?DP5(E}HGGAiT3w9`|WMX>Awt;zpLE(c!_9dn_DlB5Ewm&^}r8WNiJj<2O-Y?e8 zk+7F;e04$Sa{Bdo4xihvpXl8-yT&tg*#Tx@(`nbMX8!yxpVRN^aVwnPVS@wHMooda zj5}kOPj=+rv(2Gpx9zqDRso9%j~XkMwm10k@l6R~`Z)DR11q1$2Zs($g&EWRxJ)Bj*W5Hw=kKCIR{T3H451zzP_fu$I`_Y+8=G$ StreamDevice: Record Processing - + +

StreamDevice: Record Processing

@@ -239,6 +240,5 @@ with "ROI", followed by two floating point numbers.

Next: Supported Record Types

Dirk Zimoch, 2005

- diff --git a/doc/protocol.html b/doc/protocol.html index 56db86e..434e3c1 100644 --- a/doc/protocol.html +++ b/doc/protocol.html @@ -3,12 +3,13 @@ StreamDevice: Protocol Files - + +

StreamDevice: Protocol Files

1. General Information

@@ -241,8 +242,12 @@ that hex value.
that octal value.
\1 to \9 followed by up to two more decimal digits means a byte with that decimal value.
-\? in the argument string of an in -command matches any input byte
+\? in input matches any byte, in output it does not print +anything.
+ +\_ in input matches any amount of white space (including none), +in output it prints a single space.
+ \$ followed by the name of a protocol varible is replaced by the contents of that variable. @@ -251,29 +256,54 @@ variable. For non-printable characters, it is often easier to write sequences of byte values instead of escaped quoted string literals. A byte is written as an unquoted decimal, hexadecimal, or octal -number in the range of -128 to 255 (-0x80 to 0xff, -0200 to 0377). -StreamDevice also defines some symbolic names for frequently -used byte codes as aliases for the numeric byte value:
-EOT means end of transmission (ASCII code 4).
-ACK means acknowledge (ASCII code 6).
-BEL means bell (ASCII code 7).
-BS means backspace (ASCII code 8).
-HT or TAB mean horizontal tabulator -(ASCII code 9).
-LF or NL mean line feed / -new line (ASCII code 10).
-CR means carriage return (ASCII code 13).
-ESC means escape (ASCII code 27).
-DEL means delete (ASCII code 127).
-SKIP in the argument string of an in -command matches any input byte. +number in the range of -128 to 255, +-0x80 to 0xff (not case sesitive), +or -0200 to 0377, respectively. +

+

+StreamDevice also recordgnizes the ASCII symbolic names +(not case sensitive) for several byte codes:
+NUL (= 0x00) null
+SOH (= 0x01) start of heading
+STX (= 0x02) start of text
+ETX (= 0x03) end of text
+EOT (= 0x04) end of transmission
+ENQ (= 0x05) enquiry
+ACK (= 0x06) acknowledge
+BEL (= 0x07) bell
+BS  (= 0x08) backspace
+HT or TAB (= 0x09) horizontal tabulator
+LF or NL (= 0x0A or 10) line feed / new line
+VT  (= 0x0B or 11) vertical tabulator
+FF or NP (= 0x0C or 12) form feed / new page
+CR  (= 0x0D or 13) carriage return
+SO  (= 0x0E or 14) shift out
+SI  (= 0x0F or 15) shift in
+DLE (= 0x10 or 16) data link escape
+DC1 (= 0x11 or 17) device control 1
+DC2 (= 0x12 or 18) device control 2
+DC3 (= 0x13 or 19) device control 3
+DC4 (= 0x14 or 20) device control 4
+NAK (= 0x15 or 21) negative acknowledge
+SYN (= 0x16 or 22) synchronous idle
+ETB (= 0x17 or 23) end of transmission block
+CAN (= 0x18 or 24) cancel
+EM  (= 0x19 or 25) end of medium
+SUB (= 0x1A or 26) substitute
+ESC (= 0x1B or 27) escape
+FS  (= 0x1C or 28) file separator
+GS  (= 0x1D or 29) group separator
+RS  (= 0x1E or 30) record separator
+US  (= 0x1F or 31) unit separator
+DEL (= 0x7F or 127) delete
+SKIP or ? matches any input byte

A single string can be built from several quoted literals and byte values by writing them separated by whitespaces or comma.

-

Example:

+

Examples:

The following lines represent the same string:
"Hello world\r\n"
@@ -408,9 +438,12 @@ what they influence. (see formats and waveform record), what string to write or to expect between values? - If the first character of the Separator is a + + If the first character of the Separator is a space, it matches any number of any whitespace characters in - an in command. + an in command. To match arbitrary amount of + whitespace in input, use "\_". +

ExtraInput = Error;
@@ -546,7 +579,6 @@ settings from the protocol in which the exception occurred.

Next: Format Converters

-

Dirk Zimoch, 2006

- +

Dirk Zimoch, 2011

diff --git a/doc/recordinterface.html b/doc/recordinterface.html index 9cbc871..bbc1396 100644 --- a/doc/recordinterface.html +++ b/doc/recordinterface.html @@ -3,18 +3,18 @@ StreamDevice: Record API - + +

StreamDevice: Record API

Sorry, this documentation is still missing.

Dirk Zimoch, 2006

- diff --git a/doc/recordtypes.html b/doc/recordtypes.html index b1acb28..46b2c69 100644 --- a/doc/recordtypes.html +++ b/doc/recordtypes.html @@ -3,12 +3,13 @@ StreamDevice: Record Types - + +

StreamDevice: Record Types

Supported Record Types

@@ -49,6 +50,5 @@ It is also possible to

Dirk Zimoch, 2005

- diff --git a/doc/scalcout.html b/doc/scalcout.html index 892ea25..846dc18 100644 --- a/doc/scalcout.html +++ b/doc/scalcout.html @@ -3,12 +3,13 @@ StreamDevice: scalcout Records - + +

StreamDevice: scalcout Records

@@ -96,6 +97,5 @@ Different record fields are used for output and input. The variable calcout

Dirk Zimoch, 2005

- diff --git a/doc/setup.html b/doc/setup.html index 1d3b00c..565e7c2 100644 --- a/doc/setup.html +++ b/doc/setup.html @@ -3,79 +3,159 @@ StreamDevice: Setup - + +

StreamDevice: Setup

1. Prerequisites

-StreamDevice requires either +StreamDevice requires either EPICS base R3.14.6 or higher or EPICS base R3.13.7 or higher. How to use StreamDevice on EPICS R3.13 is described on a separate page. -Because StreamDevice comes with an interface to -asynDriver version R4-3 or higher as the -underlying driver layer, -you should have asynDriver installed first. -

-

-StreamDevice has support for the -scalcout record from the -calc module of synApps. -Up to calc release R2-6 (synApps release R5_1), -the scalcout record needs a fix. -(See separate scalcout page.) -Support for the scalcout is optional. StreamDevice works -as well without scalcout or SynApps.

+

Fix required for base R3.14.8.2 and earlier on Windows

Up to release R3.14.8.2, a fix in EPICS base is required to build StreamDevice on Windows (not cygwin). -In src/iocsh/iocsh.h, add the following line +Add the following line to src/iocsh/iocsh.h and rebuild base. 

 epicsShareFunc int epicsShareAPI iocshCmd(const char *command);
+

Configuration

-Make sure that the asyn library (and the calc module of -synApps, if desired) can be found, e.g. by -adding ASYN -and (if installed) CALC or SYNAPPS -to your <top>/configure/RELEASE file: +StreamDevice does not come with its own <top> +location and <top>/configure directory. +It expects to be put into an already existing <top> +directory structure. +You can simply create one with makeBaseApp.pl +(which is part of EPICS base):

+

+mkdir top
+cd top
+makeBaseApp.pl -t support +

+

+When asked for "Application names" just hit Enter. +Then go to the newly created configure subdirectory and +edit the RELEASE file you find there according to the +instructions below. +

+

+After changing any configuration, you should run make +in this directory. +

+

+For details on <top> directories and RELEASE +files please refer to the +IOC Application Developer's Guide chapter 4: +EPICS Build Facility. +

+ +

Support for asynDriver

+

+You most probably want asynDriver support included, because that is the +standard way for StreamDevice to talk to hardware. +First get and install asynDriver version 4-3 or higher before you build StreamDevice. +I have tested StreamDevice with asynDriver versions up to 4-17. +Make sure that the asyn library can be found by adding the path to the +<top> directory of your asyn installation to the +RELEASE file: 

-ASYN=/home/epics/asyn/4-5
-CALC=/home/epics/synApps/calc/2-7
+ASYN=/home/epics/asyn4-17
+
+ +

Support for sCalcout record

+

+The sCalcout record is part of synApps. +If streamDevice should be built with support for this record, +you have to install the calc module from SynApps first. +Add references to the RELEASE file as shown here: +

+CALC=/home/epics/synApps/calc-2-8

+Up to calc release R2-6 (synApps release R5_1), +the sCalcout record needs a fix. +(See separate scalcout page.) +And the calc modue had dependencies on other SynApps +modules. Release R2-8 or newer is recommended. +

+

+Support for the scalcout is optional. StreamDevice works +as well without scalcout or SynApps. +

+ +

Support for regular expression matching

+

If you want to enable regular expression matching, you need the PCRE package. -For most Linux systems, it is already installed. In that case add the locations -of the PCRE header and library to your RELEASE file: +For most Linux systems, it is already installed. +In that case add the locations you have to make the locations of the +PCRE header file and library known. +However, the pre-installed package can only by used for the host architecture. +Thus, add them not to RELEASE but to RELEASE.Common.linux-x86 +(if linux-x86 is your EPICS_HOST_ARCH). +Note that different Linux distributions may locate the files in different directories. 

 PCRE_INCLUDE=/usr/include/pcre
 PCRE_LIB=/usr/lib

-If you want to build StreamDevice for platforms without PCRE support, -it is the easiest to build PCRE as an EPICS application. -Download the PCRE package from www.pcre.org -and compile it with my EPICS compatible -Makefile. -Then define the location of the application in your RELEASE file. +A pre-compiled Windows version of PCRE is available at +sourceforge +

+

+If you want to have PCRE support on platforms that don't support it natively, +e.g. vxWorks, it is probably the easiest to build PCRE as an EPICS application. +

+

+

Building the PCRE package as an EPICS module

+

+

    +
  1. +Download the PCRE package from www.pcre.org. +
    2. +
  2. +Extract the PCRE package in the <top> directory of +StreamDevice or create a separate <top> location using +makeBaseApp.pl. +
    3. +
  3. +Download this Makefile and this +fixforvxworks.pl script and save them to the extracted pcre directory. +
    4. +
  4. +Change into the pcre direcrory and run perl fixforvxworks.pl +
    5. +
  5. +Run make (or gmake) +
    6. +
+

+Define the location of the pcre <top> in the RELEASE file for StreamDevice. 

 PCRE=/home/epics/pcre
@@ -84,25 +164,17 @@ PCRE=/home/epics/pcre
 Regular expressions are optional. If you don't want them, you don't need this.
 

 
-

-For details on <top> directories and RELEASE files,
-please refer to the
-IOC Application Developer's Guide chapter 4:
-EPICS Build Facility.
-

-
 
 
2. Build the StreamDevice Library

 

 Unpack the
 StreamDevice package in a <top> directory
+>StreamDevice package in the <top> directory
 of your application build area.
 (You might probably have done this already.)
 Go to the newly created StreamDevice directory
-and run make (or gmake).
-This will create and install the stream library and the 
+and run make (or gmake).
+This will create and install the stream library and the
 stream.dbd file.
 

 
@@ -121,7 +193,8 @@ PROD_LIBS += asyn

Include the following lines in your xxxAppInclude.dbd file to use -stream and asyn with serial lines and IP sockets: +stream and asyn with serial lines, IP sockets, +and vxi11 ("GPIB over ethernet") support. 

 include "base.dbd"
@@ -129,6 +202,7 @@ include "stream.dbd"
 include "asyn.dbd"
 registrar(drvAsynIPPortRegisterCommands)
 registrar(drvAsynSerialPortRegisterCommands)
+registrar(vxi11RegisterCommands)

You can find an example application in the streamApp @@ -151,7 +225,7 @@ i.e. the current directory.

Also configure the buses (in asynDriver terms: ports) you want to use with StreamDevice. -You can give the buses any name you want, like COM1 or +You can give the buses any name you want, like COM1 or socket, but I recommend to use names related to the connected device.

@@ -189,7 +263,7 @@ drvAsynIPPortConfigure ("PS1", "192.168.164.10:23")

-With a VXI11 (GPIB via TCP/IP) connection, e.g. a +With a VXI11 (GPIB via TCP/IP) connection, e.g. a HP E2050A on IP address 192.168.164.10, it would look like this: 

@@ -211,7 +285,7 @@ During iocInit, streamDevice loads and parses
 the required protocol files.
 If the files contain errors, they are printed on the IOC shell.
 Put the protocol file in one of the directories listed in
-STREAM_PROTOCOL_PATH. 
+STREAM_PROTOCOL_PATH.
 

 
Example:

 

@@ -234,7 +308,7 @@ Terminator = CR LF;
 
 setCurrent {
     out "CURRENT %.2f";
-    @init { 
+    @init {
         out "CURRENT?";
         in "CURRENT %f A";
     }
@@ -270,19 +344,24 @@ See the next chapter for protocol files in depth.
 

 To make a record use StreamDevice, set its DTYP field to
 "stream".
+

+

 The INP or OUT link has the form
 "@file protocol bus [address [parameters]]".
 

 

 Here, file is the name of the protocol file and
 protocol is the name of a protocol defined in this file.
+(See the next chapter.)
+

+

 If the protocol requires arguments,
 specify them enclosed in parentheses:
 protocol(arg1,arg2,...).
 

 

-The communication channel is specified with bus and
-addr.
+The communication channel is specified with bus
+(aka asynDriver "port") and addr.
 If the bus does not have addresses, addr is dispensable.
 Optional parameters are passed to the bus driver.
 

@@ -298,8 +377,8 @@ The bus is called PS1 like the device.
 record (ao, "PS1:I-set")
 {
     field (DESC, "Set current of PS1")
-    field (DTYP, "stream")
-    field (OUT,  "@ExamplePS.proto setCurrent PS1")
+    field (DTYP, "stream")
+    field (OUT,  "@ExamplePS.proto setCurrent PS1")
     field (EGU,  "A")
     field (PREC, "2")
     field (DRVL, "0")
@@ -311,7 +390,6 @@ record (ao, "PS1:I-set")
 
 

 
Next: Protocol Files

-
Dirk Zimoch, 2007

-
+
Dirk Zimoch, 2011

 
 
diff --git a/doc/sls_icon.ico b/doc/sls_icon.ico
deleted file mode 100644
index 9a556f59d01cc38e03162415ee8f79bb9a2ee908..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 318
zcma)%yA8uI3`C!Z7;s6ra80Yy7~aeoAtQJcuaeA=UOu%6{5j!C5RafvkhI)g`-75T
z1d4DGqScR7Wz=OkvM=lTrie*_%uH$UP_9G_ZG0lPpiJbzFx_QG=*%Y0RrP^iN(XZf
R&zHt-(7*NM2iEU@?+ylPCt&~p

diff --git a/doc/space.gif b/doc/space.gif
deleted file mode 100644
index e1e3800acee6970a9798f55d58fb8276e2c73ecb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 807
zcmZ?wbhEHbWMp7u_|5
-
-
-StreamDevice
-
-
-
-
-
-
-
EPICS StreamDevice Documentation

-
-
What is StreamDevice?

-

-StreamDevice is a generic
-EPICS
-device support for devices with a "byte stream" based
-communication interface.
-That means devices that can be controlled by sending and
-receiving strings (in the broadest sense, including non-printable
-characters and even null-bytes). 
-Examples for this type of communication interface are
-serial line (RS-232, RS-485, ...),
-IEEE-488 (also known as GPIB or HP-IB), and TCP/IP.
-StreamDevice comes with an interface to
-asynDriver
-but can be extended to
-support other bus drivers.
-

-

-If the device can be controlled with strings like
-"RF:FREQ 499.655 MHZ", StreamDevice can be used.
-How the strings exactly look like is defined in protocols.
-Formatting and interpretation of values is done with
-format converters similar to those
-known from the C functions printf() and scanf().
-To support other formats, it is possible to
-write your own converters.
-

-

-Each record with StreamDevice support runs one protocol
-to read or write its value.
-All protocols are defined in
-protocol files in plain ASCII text.
-No compiling is necessary to change a protocol or to support new devices.
-Protocols can be as simple as just one output string or can
-consist of many strings sent to and read from the device.
-However, a protocol is linear.
-That means it runs from start to end each time the record is
-processed.
-It does not provide loops or branches.
-

-

-StreamDevice supports all
-standard records of EPICS base
-which can have device support.
-It is also possible to
-write support for new record types.
-

-
-
What is StreamDevice not?

-

-It is not a programming language for a high-level application.
-It is, for example, not possible to write a complete scanning program
-in a protocol.
-Use other tools for that and use StreamDevice only for the
-primitive commands.
-

-

-It is not a block oriented device support.
-It is not possible to send or receive huge blocks of data that contain
-many process variables distributed over many records.
-

-
-
Recommended Readings

-

-IOC Application Developer's Guide (PDF)
-

-

-EPICS Record Reference Manual
-

-
-

-
Next: Setup

-
Dirk Zimoch, 2006

-
-
-
diff --git a/doc/stream.js b/doc/stream.js
deleted file mode 100644
index da8aaf0..0000000
--- a/doc/stream.js
+++ /dev/null
@@ -1,5 +0,0 @@
-if (parent.head) {
-    parent.head.document.getElementById('subtitle').innerHTML=document.title;
-    parent.document.title=document.title;
-    document.getElementsByTagName('h1')[0].style.display="none";
-}
diff --git a/doc/stringin.html b/doc/stringin.html
index 42b48a7..be62172 100644
--- a/doc/stringin.html
+++ b/doc/stringin.html
@@ -3,12 +3,13 @@
 
 
 StreamDevice: stringin Records
-
+
 
 
 
 
 
+
 
StreamDevice: stringin Records

 
 
Normal Operation

@@ -62,6 +63,5 @@ written or read value.
 scalcout
 

 
Dirk Zimoch, 2005

-
 
 
diff --git a/doc/stringout.html b/doc/stringout.html
index a57bc54..c0dbacf 100644
--- a/doc/stringout.html
+++ b/doc/stringout.html
@@ -3,12 +3,13 @@
 
 
 StreamDevice: stringout Records
-
+
 
 
 
 
 
+
 
StreamDevice: stringout Records

 
 
Normal Operation

@@ -62,6 +63,5 @@ written or read value.
 scalcout
 

 
Dirk Zimoch, 2005

-
 
 
diff --git a/doc/tipsandtricks.html b/doc/tipsandtricks.html
index 092d5f1..d1391c3 100644
--- a/doc/tipsandtricks.html
+++ b/doc/tipsandtricks.html
@@ -3,12 +3,13 @@
 
 
 StreamDevice: Tips and Tricks
-
+
 
 
 
 
 
+
 
StreamDevice: Tips and Tricks

 
 
@@ -54,7 +55,7 @@ read {in "new value = %f";}
 
 record (ai, "$(RECORD)") {

   field (DTYP, "stream")

-  field (INP, "@(DEVICETYPE).proto read $(BUS)")

+  field (INP, "@$(DEVICETYPE).proto read $(BUS)")

   field (SCAN, "I/O Intr")

 }
 
@@ -95,10 +96,10 @@ array_out {separator=", "; out "an array: (%.2f)";}
 The format %.2f is repeated for each element of the array.
 All elements are separated by ", ".

 Output will look like this:
+

 
 an array: (3.14, 17.30, -12.34)
 

-

 
B) We have up to 12 numeric values

 

 Use a calcout record and
@@ -121,7 +122,7 @@ record (calcout, "$(RECORD)") {

   field (INPC, "$(C_RECORD)")

   field (CALC, "0")

   field (DTYP, "stream")

-  field (OUT, "@(DEVICETYPE).proto write_ABC $(BUS)")

+  field (OUT, "@$(DEVICETYPE).proto write_ABC $(BUS)")

 }
 
 

@@ -131,14 +132,14 @@ Use record references in the format.
 

 

 
-acquire {out 'ACQUIRE "%(\$1:directory.VAL)s/%s",%(\$1:time.VAL).3f;';}
+acquire {out 'ACQUIRE "%(\$1:directory)s/%s",%(\$1:time).3f;';}
 
 

 

-You must specify the full record.FIELD name,
-even for VAL fields.
-To avoid record names in protocol files use
-protocol arguments.
+You can specify a record name or record.FIELD in parentheses directly
+after the %.
+To avoid plain record names in protocol files use
+protocol arguments like \$1.
 In the link, specify the record name or just the basename of the
 other records (device name) in parentheses.
 

@@ -146,7 +147,7 @@ other records (device name) in parentheses.
 
 record (stringout, "$(DEVICE):getimage") {

   field (DTYP, "stream")

-  field (OUT, "@(DEVICETYPE).proto acquire($(DEVICE)) $(BUS)")

+  field (OUT, "@$(DEVICETYPE).proto acquire($(DEVICE)) $(BUS)")

 }
 
 

@@ -190,12 +191,12 @@ read_B {in "A=%*f, B=%f";}
 
 record (ai, "$(DEVICE):A") {

   field (DTYP, "stream")

-  field (INP, "@(DEVICETYPE).proto read_A $(BUS)")

+  field (INP, "@$(DEVICETYPE).proto read_A $(BUS)")

   field (SCAN, "1 second")

 }

 record (ai, "$(DEVICE):B") {

   field (DTYP, "stream")

-  field (INP, "@(DEVICETYPE).proto read_B $(BUS)")

+  field (INP, "@$(DEVICETYPE).proto read_B $(BUS)")

   field (SCAN, "I/O Intr")

 }
 
@@ -221,14 +222,14 @@ To avoid record names in protocol files, use
 

 

 
-read_AB {out "GET A,B"; in "A=%f, B=%(\$1.VAL)f";}
+read_AB {out "GET A,B"; in "A=%f, B=%(\$1)f";}
 
 

 

 
 record (ai, "$(DEVICE):A") {

   field (DTYP, "stream")

-  field (INP, "@(DEVICETYPE).proto read_AB($(DEVICE):B) $(BUS)")

+  field (INP, "@$(DEVICETYPE).proto read_AB($(DEVICE):B) $(BUS)")

   field (SCAN, "1 second")

 }

 record (ai, "$(DEVICE):B") {

@@ -259,14 +260,14 @@ When asked "CURRENT?", the device send something like
 

 

 
-read_current {out "CURRENT?"; in "CURRENT %f A"; @mismatch {in "%(\1.VAL)39c";}}
+read_current {out "CURRENT?"; in "CURRENT %f A"; @mismatch {in "%(\1)39c";}}
 
 

 

 
 record (ai, "$(DEVICE):readcurrent") {

   field (DTYP, "stream")

-  field (INP, "@(DEVICETYPE).proto read_current($(DEVICE):message) $(BUS)")

+  field (INP, "@$(DEVICETYPE).proto read_current($(DEVICE):message) $(BUS)")

 }

 record (stringin, "$(DEVICE):message") {

 }
@@ -292,6 +293,5 @@ record (stringout, "$(DEVICE):clean_2") {

 
 

 
Dirk Zimoch, 2007

-
 
 
diff --git a/doc/waveform.html b/doc/waveform.html
index 8614972..455ff90 100644
--- a/doc/waveform.html
+++ b/doc/waveform.html
@@ -3,12 +3,13 @@
 
 
 StreamDevice: waveform Records
-
+
 
 
 
 
 
+
 
StreamDevice: waveform Records

 
 
Normal Operation

@@ -121,6 +122,5 @@ the written or read value.
 scalcout
 

 
Dirk Zimoch, 2005

-