more work on examples; documentation is only changed up to exampleServer

exampleDatabase/src/Makefile

@@ -0,0 +1,38 @@
+TOP=..
+
+include $(TOP)/configure/CONFIG
+#----------------------------------------
+#  ADD MACRO DEFINITIONS AFTER THIS LINE
+#=============================
+
+#==================================================
+# Build an IOC support library
+#
+
+
+PROD_HOST += exampleDatabaseMain
+exampleDatabaseMain_SRCS += exampleDatabaseMain.cpp
+exampleDatabaseMain_LIBS += Com
+exampleDatabaseMain_LIBS += pvData
+exampleDatabaseMain_LIBS += pvAccess
+exampleDatabaseMain_LIBS += pvDatabase
+exampleDatabaseMain_LIBS += exampleDatabase
+
+DBD += exampleDatabase.dbd
+
+INC += exampleDatabase.h
+
+LIBRARY_IOC += exampleDatabase
+exampleDatabase_SRCS += exampleDatabase.cpp
+exampleDatabase_SRCS += exampleDatabaseRegister.cpp
+exampleDatabase_LIBS += pvData
+exampleDatabase_LIBS += pvAccess
+exampleDatabase_LIBS += pvDatabase
+exampleDatabase_LIBS += $(EPICS_BASE_IOC_LIBS)
+
+#===========================
+
+include $(TOP)/configure/RULES
+#----------------------------------------
+#  ADD RULES AFTER THIS LINE
+

exampleDatabase/src/exampleDatabase.cpp

@@ -0,0 +1,138 @@
+/*exampleDatabase.cpp */
+/**
+ * Copyright - See the COPYRIGHT that is included with this distribution.
+ * EPICS pvData is distributed subject to a Software License Agreement found
+ * in file LICENSE that is included with this distribution.
+ */
+/**
+ * @author mrk
+ * @date 2013.07.24
+ */
+
+/* Author: Marty Kraimer */
+
+#include <cstddef>
+#include <cstdlib>
+#include <cstddef>
+#include <string>
+#include <cstdio>
+#include <memory>
+#include <vector>
+#include <iostream>
+
+#include <pv/standardField.h>
+#include <pv/standardPVField.h>
+#include <pv/powerSupplyRecordTest.h>
+#include <pv/channelProviderLocal.h>
+#include <pv/recordList.h>
+#include <pv/traceRecord.h>
+#include <pv/exampleDatabase.h>
+
+using namespace std;
+using std::tr1::static_pointer_cast;
+using namespace epics::pvData;
+using namespace epics::pvAccess;
+using namespace epics::pvDatabase;
+
+static FieldCreatePtr fieldCreate = getFieldCreate();
+static StandardFieldPtr standardField = getStandardField();
+static PVDataCreatePtr pvDataCreate = getPVDataCreate();
+static StandardPVFieldPtr standardPVField = getStandardPVField();
+
+static PVStructurePtr createPowerSupply()
+{
+    size_t nfields = 5;
+    StringArray names;
+    names.reserve(nfields);
+    FieldConstPtrArray powerSupply;
+    powerSupply.reserve(nfields);
+    names.push_back("alarm");
+    powerSupply.push_back(standardField->alarm());
+    names.push_back("timeStamp");
+    powerSupply.push_back(standardField->timeStamp());
+    String properties("alarm,display");
+    names.push_back("voltage");
+    powerSupply.push_back(standardField->scalar(pvDouble,properties));
+    names.push_back("power");
+    powerSupply.push_back(standardField->scalar(pvDouble,properties));
+    names.push_back("current");
+    powerSupply.push_back(standardField->scalar(pvDouble,properties));
+    return pvDataCreate->createPVStructure(
+            fieldCreate->createStructure(names,powerSupply));
+}
+
+static void createStructureArrayRecord(
+    PVDatabasePtr const &master,
+    ScalarType scalarType,
+    String const &recordName)
+{
+    StructureConstPtr structure = standardField->scalar(
+        pvDouble,
+        String("value,alarm,timeStamp"));
+    StringArray names(2);
+    FieldConstPtrArray fields(2);
+    names[0] = "timeStamp";
+    names[1] = "value";
+    fields[0] = standardField->timeStamp();
+    fields[1] = fieldCreate->createStructureArray(structure);
+    StructureConstPtr top = fieldCreate->createStructure(names,fields);
+    PVStructurePtr pvStructure = pvDataCreate->createPVStructure(top);
+    PVRecordPtr pvRecord = PVRecord::create(recordName,pvStructure);
+    bool result = master->addRecord(pvRecord);
+    if(!result) cout<< "record " << recordName << " not added" << endl;
+}
+
+static void createRecords(
+    PVDatabasePtr const &master,
+    ScalarType scalarType,
+    String const &recordNamePrefix,
+    String const &properties)
+{
+    String recordName = recordNamePrefix;
+    PVStructurePtr pvStructure = standardPVField->scalar(scalarType,properties);
+    PVRecordPtr pvRecord = PVRecord::create(recordName,pvStructure);
+    bool result = master->addRecord(pvRecord);
+    if(!result) cout<< "record " << recordName << " not added" << endl;
+    recordName += "Array";
+    pvStructure = standardPVField->scalarArray(scalarType,properties);
+    pvRecord = PVRecord::create(recordName,pvStructure);
+    result = master->addRecord(pvRecord);
+}
+
+void ExampleDatabase::create()
+{
+    PVDatabasePtr master = PVDatabase::getMaster();
+    PVRecordPtr pvRecord;
+    String recordName;
+    bool result(false);
+    recordName = "traceRecordPGRPC";
+    pvRecord = TraceRecord::create(recordName);
+    result = master->addRecord(pvRecord);
+    if(!result) cout<< "record " << recordName << " not added" << endl;
+    String properties;
+    properties = "alarm,timeStamp";
+    createRecords(master,pvBoolean,"exampleBoolean",properties);
+    createRecords(master,pvByte,"exampleByte",properties);
+    createRecords(master,pvShort,"exampleShort",properties);
+    createRecords(master,pvInt,"exampleInt",properties);
+    createRecords(master,pvLong,"exampleLong",properties);
+    createRecords(master,pvFloat,"exampleFloat",properties);
+    createRecords(master,pvDouble,"exampleDouble",properties);
+    createRecords(master,pvString,"exampleString",properties);
+    createStructureArrayRecord(master,pvDouble,"exampleStructureArray");
+    recordName = "examplePowerSupply";
+    PVStructurePtr pvStructure = createPowerSupply();
+    PowerSupplyRecordTestPtr psr =
+        PowerSupplyRecordTest::create(recordName,pvStructure);
+    if(psr.get()==NULL) {
+        cout << "PowerSupplyRecordTest::create failed" << endl;
+        return;
+    }
+    result = master->addRecord(psr);
+    if(!result) cout<< "record " << recordName << " not added" << endl;
+    recordName = "laptoprecordListPGRPC";
+    pvRecord = RecordListRecord::create(recordName);
+    result = master->addRecord(pvRecord);
+    if(!result) cout<< "record " << recordName << " not added" << endl;
+}
+

exampleDatabase/src/exampleDatabase.h

@@ -0,0 +1,27 @@
+/* exampleDatabase.h */
+/**
+ * Copyright - See the COPYRIGHT that is included with this distribution.
+ * EPICS pvData is distributed subject to a Software License Agreement found
+ * in file LICENSE that is included with this distribution.
+ */
+/**
+ * @author mrk
+ * @date 2013.07.24
+ */
+#ifndef EXAMPLEDATABASE_H
+#define EXAMPLEDATABASE_H
+
+
+#include <pv/pvDatabase.h>
+
+namespace epics { namespace pvDatabase { 
+
+class ExampleDatabase{
+public:
+    static void create();
+};
+
+
+}}
+
+#endif  /* EXAMPLEDATABASE_H */

exampleDatabase/src/exampleDatabaseInclude.dbd

@@ -0,0 +1 @@
+registrar("exampleDatabaseRegister")

exampleDatabase/src/exampleDatabaseMain.cpp

@@ -0,0 +1,60 @@
+/*exampleDatabaseMain.cpp */
+/**
+ * Copyright - See the COPYRIGHT that is included with this distribution.
+ * EPICS pvData is distributed subject to a Software License Agreement found
+ * in file LICENSE that is included with this distribution.
+ */
+/**
+ * @author mrk
+ */
+
+/* Author: Marty Kraimer */
+
+#include <cstddef>
+#include <cstdlib>
+#include <cstddef>
+#include <string>
+#include <cstdio>
+#include <memory>
+#include <vector>
+#include <iostream>
+
+#include <pv/channelProviderLocal.h>
+#include <pv/exampleDatabase.h>
+#include <pv/serverContext.h>
+
+using namespace std;
+using std::tr1::static_pointer_cast;
+using namespace epics::pvData;
+using namespace epics::pvAccess;
+using namespace epics::pvDatabase;
+
+
+int main(int argc,char *argv[])
+{
+    PVDatabasePtr master = PVDatabase::getMaster();
+    ChannelProviderLocalPtr channelProvider = getChannelProviderLocal();
+    ExampleDatabase::create();
+    ServerContext::shared_pointer ctx =
+        startPVAServer(PVACCESS_ALL_PROVIDERS,0,true,true);
+    cout << "exampleDatabase\n";
+    PVStringArrayPtr pvNames = master->getRecordNames();
+    String buffer;
+    pvNames->toString(&buffer);
+    cout << "recordNames" << endl << buffer << endl;
+    PVRecordPtr pvRecord = master->findRecord("laptoprecordListPGRPC");
+    PVStructurePtr pvStructure = pvRecord->getPVRecordStructure()->getPVStructure();
+    cout << "PVStructure" << endl << pvStructure->dumpValue(cout) << endl;
+    string str;
+    while(true) {
+        cout << "Type exit to stop: \n";
+        getline(cin,str);
+        if(str.compare("exit")==0) break;
+
+    }
+    ctx->destroy();
+    epicsThreadSleep(1.0);
+    channelProvider->destroy();
+    return 0;
+}
+

exampleDatabase/src/exampleDatabaseRegister.cpp

@@ -0,0 +1,60 @@
+/*exampleDatabase.cpp */
+/**
+ * Copyright - See the COPYRIGHT that is included with this distribution.
+ * EPICS pvData is distributed subject to a Software License Agreement found
+ * in file LICENSE that is included with this distribution.
+ */
+/**
+ * @author mrk
+ * @date 2013.07.24
+ */
+
+
+/* Author: Marty Kraimer */
+
+#include <cstddef>
+#include <cstdlib>
+#include <cstddef>
+#include <string>
+#include <cstdio>
+#include <memory>
+
+#include <cantProceed.h>
+#include <epicsStdio.h>
+#include <epicsMutex.h>
+#include <epicsEvent.h>
+#include <epicsThread.h>
+#include <iocsh.h>
+
+#include <epicsExport.h>
+
+#include <pv/pvIntrospect.h>
+#include <pv/pvData.h>
+#include <pv/pvAccess.h>
+#include <pv/pvDatabase.h>
+#include <pv/exampleDatabase.h>
+
+using namespace epics::pvData;
+using namespace epics::pvAccess;
+using namespace epics::pvDatabase;
+
+static const iocshArg testArg0 = { "prefix", iocshArgString };
+static const iocshArg *testArgs[] = {
+    &testArg0};
+
+static const iocshFuncDef exampleDatabaseFuncDef = {
+    "exampleDatabase", 1, testArgs};
+static void exampleDatabaseCallFunc(const iocshArgBuf *args)
+{
+    ExampleDatabase::create();
+}
+
+static void exampleDatabaseRegister(void)
+{
+    static int firstTime = 1;
+    if (firstTime) {
+        firstTime = 0;
+        iocshRegister(&exampleDatabaseFuncDef, exampleDatabaseCallFunc);
+    }
+}
+epicsExportRegistrar(exampleDatabaseRegister);