Fix README. Add asyncio example.

Author: AlexanderWells-diamond

README.rst

@@ -15,10 +15,36 @@ Source code    https://github.com/dls-controls/pythonIoc
 Documentation  https://dls-controls.github.io/pythonIoc
 ============== ==============================================================
 
-A simple example of the use of this library is the following:
+A simple example of the use of this library:
 
-.. literalinclude:: examples/example_cothread_ioc.py    
+.. code:: python
 
+    # Import the basic framework components.
+    from softioc import softioc, builder
+    import cothread
+
+    # Set the record prefix
+    builder.SetDeviceName("MY-DEVICE-PREFIX")
+
+    # Create some records
+    ai = builder.aIn('AI', initial_value=5)
+    ao = builder.aOut('AO', initial_value=12.45, on_update=lambda v: ai.set(v))
+
+    # Boilerplate get the IOC started
+    builder.LoadDatabase()
+    softioc.iocInit()
+
+    # Start processes required to be run after iocInit
+    def update():
+        while True:
+            ai.set(ai.get() + 1)
+            cothread.Sleep(1)
+
+
+    cothread.Spawn(update)
+
+    # Finally leave the IOC running with an interactive shell.
+    softioc.interactive_ioc(globals())
 
 .. |code_ci| image:: https://github.com/dls-controls/pythonIoc/workflows/Code%20CI/badge.svg?branch=master
     :target: https://github.com/dls-controls/pythonIoc/actions?query=workflow%3A%22Code+CI%22

docs/examples/example_asyncio_ioc.py

@@ -0,0 +1,30 @@
+# Import the basic framework components.
+import atexit
+from softioc import softioc, builder
+from aioca import caget, caput, _catools
+import asyncio
+
+# Set the record prefix
+builder.SetDeviceName("MY-DEVICE-PREFIX")
+
+# Create some records
+ai = builder.aIn('AI', initial_value=5)
+
+async def update(val):
+    ai.set(val)
+
+ao = builder.aOut('AO', initial_value=12.45, on_update=update)
+
+# Boilerplate get the IOC started
+builder.LoadDatabase()
+softioc.iocInit()
+
+# Perform some reading/writing to the PVs
+async def do_read_write():
+    ai_val = await caget("MY-DEVICE-PREFIX:AI")
+    await caput("MY-DEVICE-PREFIX:AO", "999")
+
+
+asyncio.run(do_read_write())
+
+