Changes between Initial Version and Version 1 of epics/softIoc

Timestamp:

03/31/18 14:08:54 (8 years ago)

Author:

Takashi Obina

Comment:

--

epics/softIoc

@@ +1 @@
+= softIoc コマンドで簡単に ioc データベースをテストする =
+
+(KEKB佐々木さんからネタ提供。それにいくつかデータベース例を加えてwikiに掲載）
+
+簡単にレコードのテストをしたいときに便利。
+seqencerを使う場合は makeBaseApp して application を作る必用があるが、
+データベースの単体テストであれば "softIoc" コマンドがお手軽で便利。
+dbLoadTemplateなどの検証にも使用可能。
+
+
+== 使用例１ ==
+dbファイルを用意する。例えば、単にカウントアップするレコードとして
+{{{
+record(calc,"test:count") {
+    field(SCAN, ".1 second")
+    field(INPA, "test:count.VAL")
+    field(CALC, "A+1")
+}
+}}}
+こんなファイルを作成して test.db として保存する。
+
+単純に使うならば、-dオプションでdbファイルを指定して実行するのみ。
+{{{
+$ softIoc -d test.db
+Starting iocInit
+############################################################################
+## EPICS R3.15.5
+## EPICS Base built Jan 24 2018
+############################################################################
+iocRun: All initialization complete
+epics> dbl
+test:count
+epics>
+epics> dbpr test:count
+A: 44               ASG:                B: 0                C: 0
+CALC: A+1           D: 0                DESC:               DISA: 0
+DISP: 0             DISV: 1             E: 0                F: 0
+G: 0                H: 0                I: 0                J: 0
+K: 0                L: 0                NAME: test:count    SEVR: NO_ALARM
+STAT: NO_ALARM      TPRO: 0             VAL: 45
+epics>
+}}}
+
+別の端末を開いて camonitor で確認
+{{{
+$ camonitor test:count
+test:count                     2018-03-31 13:38:04.648396 82
+test:count                     2018-03-31 13:38:05.649164 83
+test:count                     2018-03-31 13:38:06.648305 84
+test:count                     2018-03-31 13:38:07.648437 85
+}}}
+ちゃんと１秒ごとにカウントアップしている。
+
+
+== コマンドのインストール場所、オプション ==
+softIoc コマンドは、caget, caput などと同じフォルダにインストールされているので、確認。
+{{{
+$ which caget
+/opt/epics/R315.5/base/bin/linux-x86_64/caget
+$ which softIoc
+/opt/epics/R315.5/base/bin/linux-x86_64/softIoc
+}}}
+
+オプション類は -h で確認。
+{{{
+$ softIoc -h
+Usage: softIoc [-D softIoc.dbd] [-h] [-S] [-a ascf]
+        [-m macro=value,macro2=value2] [-d file.db]
+        [-x prefix] [st.cmd]
+Compiled-in path to softIoc.dbd is:
+        /opt/epics/R315.5/base/dbd/softIoc.dbd
+}}}
+
+
+== 使用例２ ==
+FLNK の使い方の例：count レコードのスキャン時間を 0.1 sec にして、sin とつなげる
+{{{
+record(calc,"test:count") {
+    field(SCAN, ".1 second")
+    field(INPA, "test:count.VAL")
+    field(CALC, "A+1")
+    field(FLNK, "test:sin1")
+}
+record(calc, "test:sin1") {
+    field(SCAN, "Passive")
+    field(INPA, "test:count.VAL")
+    field(CALC, "sin(A/10.0)")
+}
+}}}
+このようなレコードを作っておくと、磁石をsinで振ったり、あるいは単にGUIやプログラム（スクリプト）のテストを
+したいときなどに便利です。
+当然ですがハードリアルタイムOSでない場合は確実に動く保証はありませんし、"確実に動く" and/or "きれいな"sin波形を作りたいならば
+ハードウェアベースで別途検討する必要があります.....が、実際のところこの程度でもテストには十分な場合が多いです。
+例えばマグネット電源に出力する場合は calcOut レコードに変更すればより簡単に記述できるでしょう。
+
+
+== 使用例３ ==
+独自のdbdファイルを使いたいときには、-D オプションでdbdファイルを指定する。例えば SCAN 20 sec を作りたい場合を例とすると、
+/opt/epics/R315.5/base/dbd/softIoc.dbdをコピーしてきて、menuScanを下のように編集して、custom.dbd として保存。
+{{{
+menu(menuScan) {
+    choice(menuScanPassive, "Passive")
+    choice(menuScanEvent, "Event")
+    choice(menuScanI_O_Intr, "I/O Intr")
+    choice(menuScan20_second, "20 second")  <------- これを追加する
+    choice(menuScan10_second, "10 second")
+    choice(menuScan5_second, "5 second")
+    choice(menuScan2_second, "2 second")
+    choice(menuScan1_second, "1 second")
+    choice(menuScan_5_second, ".5 second")
+    choice(menuScan_2_second, ".2 second")
+    choice(menuScan_1_second, ".1 second")
+}
+}}}
+
+softIoc実行
+{{{
+$ softIoc -D custom.dbd -d test1.db
+Starting iocInit
+############################################################################
+## EPICS R3.15.5
+## EPICS Base built Jan 24 2018
+############################################################################
+iocRun: All initialization complete
+epics> dbl
+test:count
+epics> dbpr test:count, 4
+A: 1                ACKS: NO_ALARM      ACKT: YES           ADEL: 0
+....
+RPRO: 0             RSET: 0x7f333a9f2820                    SCAN: 20 second
+....
+}}}
+確認
+{{{
+$ camonitor test:count
+test:count                     2018-03-31 13:58:08.453467 1
+test:count                     2018-03-31 13:58:28.454018 2
+test:count                     2018-03-31 13:58:48.454025 3
+test:count                     2018-03-31 13:59:08.453544 4
+}}}