Tagwell for SoftPLC® Runtime

# TagWell Driver Configuration for SoftPLC Runtime Software.
# This file uses an "s-expression" format, which is like XML but uses
# parentheses instead of angle bracketed keywords.  The syntax of s-expression
# files is well documented and can be googled.  The grammar, on the other hand,
# unlike the syntax, is application specific.  SoftPLC uses '#' to indicate
# a single line comment. If the first non-blank character is #, then this
# line is a single line comment.  Single line comments cannot follow
# any other token on the same line.  Multiline 'C' style comments are also
# supported.  Its best to use these also only as the first non-blank combo:
# /* followed by an eventual */
#
# S-expressions are thought to be more human readable than XML
# and are easy to parse with a programming language.  Parentheses are balanced.
#
# The supported grammar is documented in the next several lines of comments.
# Grammar rules are declared like this, for example:
# (timeout_mult <4 | 8 | 16 | 32 | 64 | 128 | 256 | 512 > )
# This means "timeout_mul" is a keyword and it can be followed with
#   4, 8, 16, 32, 64, 128, 256, or 512.  The '|' means "or". e.g. (timeout_mult 4)
#
# If something is wrapped in square brackets [] in a grammar rule, this means
# whatever appears in the brackets is optional.  If omitted, then a default value
# will be used and the default is defined in the grammar rule by a comment following
# a ':'.  The square brackets, being only part of the grammar definition,
# are never actually used in real configuration statements.
#
# If something is wrapped in angle brackets <> in a grammar rule, this means
# it is a grouping.  Only one of the choices in a grouping may actually be used.
# Angle brackets, being only part of the grammar definition, are never actually
# used in real configuration statements.
#
# White spaces includeing tabs and newlines (CR, LF, etc.) are all ignored.
# Numbers may be provided either in decimal or in hex with a prefix of 0x.

#------ Grammar Rules: ----------
# (tagwell                      ` is the master containing element and it may contain
#                               ` the indicated top level nested elements.
#                               ` Every nested element is contained within this
#                               ` master element.
#   (driver_version ...)        ` configuration file revision, use 2 : 2 is default
#   (debug                      ` marks the start of optional flags whose presence
#                               ` enables various debug print statements.
#     [config]                  ` show tag regex resolution and group membership
#     [sockets]                 ` show usage of ethernet sockets
#     [payload]                 ` show details (xml) of packet payloads
#     )
#
#   (group                      ` indicates the start of tag group
#     ( name <group_name>)      ` the name of the group
#     [(on_poll [tags_only])]   ` When Tagwell polls,
#                               ` tags_only means respond without data, only
#                               ` include tags in the response.  Omit it if
#                               ` you want a normal full response.
#     <tag_regex> ...           ` a sequence of tag names or tag regexs that
#                               ` indicate which tags are included in this group
#                               ` Those tags that match any regular expression
#                               ` will be included in the group payload.
#                               ` see http://regexlib.com/CheatSheet.aspx?AspxAutoDetectCookieSupport=1
#     )
#     :                         ` optional additional (group) elements
#     :
#   )       /* end of "tagwell s-expression element */


# Each group will be assigned a zero based group index that can be referenced
# in the TLI.  Commenting out a group will renumber the group indices for groups
# which follow it. The group indices are contiguous.  At this time group (name <>)
# is required but is not used.  A future TLI may use this instead of the group index.

(tagwell
  (driver_version 2)

  (debug
    #config
    #sockets
    #payload
    )

  # group index 0
  (group
    (name outputs)
    (on_poll tags_only)                 /* tags in this group flow FROM tagwell to remote */
    tgw_out.+                           /* any tag name starting with "tgw_out" */
    oops_and_this_one_too
    "sexpr_strings_can_be_quoted"       /* quotes may be necessary if a regex confuses the lexer */
    )

  # group index 1
  (group
    (name inputs)
    tgw_in.+
    )
  )

.+      ; matches all defined tags.

TWD_.+  ; would include all tagnames that begin with the characters “TWD_”.

[REGEXS]
;.+       ; match all tags
TWD_.+