epicsdev 2.1.1__tar.gz → 2.1.2__tar.gz

{epicsdev-2.1.1 → epicsdev-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: epicsdev
-Version: 2.1.1
+Version: 2.1.2
 Summary: Helper module for creating EPICS PVAccess servers using p4p
 Project-URL: Homepage, https://github.com/ASukhanov/epicsdev
 Project-URL: Bug Tracker, https://github.com/ASukhanov/epicsdev
@@ -31,7 +31,7 @@ python -m pypeto -c config -f epicsdev
 ## Multi-channel waveform generator
 Module **epicdev.multiadc** can generate large amount of data for stress-testing
 the EPICS environment. For example the following command will generate 10000 of 
-100-pont noisy waveforms and 40000 of scalar parameters per second.
+100-point noisy waveforms and 40000 of scalar parameters per second.
 ```
 python -m epicsdev.multiadc -s0.1 -c10000 -n100
 ```
@@ -43,3 +43,16 @@ The graphs should look like this:
 [plots](docs/epicsdev_pvplot.jpg).
 
 Example of [Phoebus display](docs/phoebus_epicsdev.jpg), as defined in config/epicsdev.bob.
+
+## Using AI to generate PVAccess server for arbitrary instruments.
+The epicsdev module is designed to be suitable for automatic development using AI agents.<br>
+The roadmap to create a server for new instrument using copilot at github:
+- Create new repository.
+- In the prompt section enter something like this:<br>
+'Build device support for Tektronix MSO oscilloscopes using epicsdev_rigol_scope as a template and programming manual at < link to a pdf file >.'
+- In 20-40 minutes the copilot will create a pull request.
+- Follow instructions to review, commit and merge.
+
+As an example, the generated server for Tektronix MSO oscilloscope was 99% correct and it reqiured very minor modifications.
+
+

epicsdev-2.1.2/README.md

@@ -0,0 +1,43 @@
+# epicsdev
+Helper module for creating EPICS PVAccess servers.
+
+Demo:
+```
+python pip install epicsdev
+python -m epicsdev.epicsdev
+```
+
+To control and plot:
+```
+python pip install pypeto,pvplot
+python -m pypeto -c config -f epicsdev
+```
+
+## Multi-channel waveform generator
+Module **epicdev.multiadc** can generate large amount of data for stress-testing
+the EPICS environment. For example the following command will generate 10000 of 
+100-point noisy waveforms and 40000 of scalar parameters per second.
+```
+python -m epicsdev.multiadc -s0.1 -c10000 -n100
+```
+The GUI for monitoring:<br>
+```python -m pypeto -c config -f multiadc```
+
+The graphs should look like this: 
+[control page](docs/epicsdev_pypet.png),
+[plots](docs/epicsdev_pvplot.jpg).
+
+Example of [Phoebus display](docs/phoebus_epicsdev.jpg), as defined in config/epicsdev.bob.
+
+## Using AI to generate PVAccess server for arbitrary instruments.
+The epicsdev module is designed to be suitable for automatic development using AI agents.<br>
+The roadmap to create a server for new instrument using copilot at github:
+- Create new repository.
+- In the prompt section enter something like this:<br>
+'Build device support for Tektronix MSO oscilloscopes using epicsdev_rigol_scope as a template and programming manual at < link to a pdf file >.'
+- In 20-40 minutes the copilot will create a pull request.
+- Follow instructions to review, commit and merge.
+
+As an example, the generated server for Tektronix MSO oscilloscope was 99% correct and it reqiured very minor modifications.
+
+

{epicsdev-2.1.1 → epicsdev-2.1.2}/epicsdev/epicsdev.py

@@ -1,6 +1,6 @@
 """Skeleton and helper functions for creating EPICS PVAccess server"""
 # pylint: disable=invalid-name
-__version__= 'v2.1.1 26-02-05'# sleep() returns False if a periodic update occurred. Simplified waveform randomization.
+__version__= 'v2.1.2 26-02-07'# do nothing in sleep() if stopped.
 #Issue: There is no way in PVAccess to specify if string PV is writable.
 # As a workaround we append description with suffix ' Features: W' to indicate that.
 
@@ -163,14 +163,18 @@ def _create_PVs(pvDefs):
             spv.post(ivalue, timestamp=ts)
         else:
             v['display.description'] = desc
-            for field in extra.keys():              
-                if field in ['limitLow','limitHigh','format','units']:
-                    v[f'display.{field}'] = extra[field]
-                    if field.startswith('limit'):
-                        v[f'control.{field}'] = extra[field]
-                if field == 'valueAlarm':
-                    for key,value in extra[field].items():
-                        v[f'valueAlarm.{key}'] = value
+            for field in extra.keys():
+                try:
+                    if field in ['limitLow','limitHigh','format','units']:
+                        v[f'display.{field}'] = extra[field]
+                        if field.startswith('limit'):
+                            v[f'control.{field}'] = extra[field]
+                    if field == 'valueAlarm':
+                        for key,value in extra[field].items():
+                            v[f'valueAlarm.{key}'] = value
+                except  KeyError as e:
+                    print(f'Cannot set {field} for {pname}: {e}')
+                    sys.exit(1)
             spv.post(v)
 
         # add new attributes.
@@ -335,13 +339,15 @@ def sleep():
     Returns False if a periodic update occurred.
     """
     time.sleep(pvv('sleep'))
+    sleeping = True
+    if serverState().startswith('Stop'):
+        return sleeping
     tnow = timer()
     C_.cycleTimeSum += tnow - C_.lastCycleTime
     C_.lastCycleTime = tnow
     C_.cyclesAfterUpdate += 1
     C_.cycle += 1
     printv(f'cycle {C_.cycle}')
-    sleeping = True
     if tnow - C_.lastUpdateTime > PeriodicUpdateInterval:
         avgCycleTime = C_.cycleTimeSum / C_.cyclesAfterUpdate
         printv(f'Average cycle time: {avgCycleTime:.6f} S.')

{epicsdev-2.1.1 → epicsdev-2.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "epicsdev"
-version = "2.1.1"
+version = "2.1.2"
 authors = [
   { name="Andrey Sukhanov", email="sukhanov@bnl.gov" },
 ]

epicsdev-2.1.1/README.md

@@ -1,30 +0,0 @@
-# epicsdev
-Helper module for creating EPICS PVAccess servers.
-
-Demo:
-```
-python pip install epicsdev
-python -m epicsdev.epicsdev
-```
-
-To control and plot:
-```
-python pip install pypeto,pvplot
-python -m pypeto -c config -f epicsdev
-```
-
-## Multi-channel waveform generator
-Module **epicdev.multiadc** can generate large amount of data for stress-testing
-the EPICS environment. For example the following command will generate 10000 of 
-100-pont noisy waveforms and 40000 of scalar parameters per second.
-```
-python -m epicsdev.multiadc -s0.1 -c10000 -n100
-```
-The GUI for monitoring:<br>
-```python -m pypeto -c config -f multiadc```
-
-The graphs should look like this: 
-[control page](docs/epicsdev_pypet.png),
-[plots](docs/epicsdev_pvplot.jpg).
-
-Example of [Phoebus display](docs/phoebus_epicsdev.jpg), as defined in config/epicsdev.bob.