|
1 | | -# python_ics |
| 1 | + |
2 | 2 |
|
3 | | -Python C Code module for interfacing to the icsneo40 dynamic library. Code tries to respect PEP 8 (https://www.python.org/dev/peps/pep-0008/). Function naming convention does not follow the tradition c style icsneo40 naming convention as the python_ics module name acts as the namespace (icsneo portion of the function) and function names are suppose to be lowercase with underscores instead of mixedCase like icsneo API. |
| 3 | + |
| 4 | + |
| 5 | +# Description |
| 6 | + |
| 7 | +Python wrapper for interfacing to IntrepidCS Hardware. |
4 | 8 |
|
5 | 9 | # Installing |
6 | 10 |
|
7 | 11 | - `pip install python_ics` |
8 | 12 |
|
9 | | -- Placing icsneo40.dll in the system path as the api uses this DLL extensively. |
| 13 | +## Platform specific Installation notes |
10 | 14 |
|
11 | | -# How to use |
| 15 | +### Windows |
12 | 16 |
|
13 | | -#### Documentation |
| 17 | +- Windows requires icsneo40.dll to be installed in the PATH. This can be obtained through vspy3 or our hardware installation kit found here: https://cdn.intrepidcs.net/updates/files/RP1210KitInstall.zip |
14 | 18 |
|
15 | | -http://python-ics.readthedocs.io/ |
| 19 | +### Linux |
16 | 20 |
|
17 | | -#### C API can be mimiced almost identically by doing the following: |
| 21 | +- Linux builds use [libicsneo](https://github.com/intrepidcs/libicsneo) and are built against [manylinux](https://github.com/pypa/manylinux) using cibuildwheel. |
18 | 22 |
|
19 | | - >>> import ics as icsneo |
20 | | - >>> devices = icsneo.FindNeoDevices() |
21 | | - >>> for device in devices: |
22 | | - ... print(device.Name, device.SerialNumber) |
23 | | - ... |
24 | | - neoVI FIRE 59886 |
25 | | - |
26 | | -#### Recommended Python way by doing the following: |
| 23 | +### MacOS |
27 | 24 |
|
28 | | - >>> import ics |
29 | | - >>> devices = ics.find_devices() |
30 | | - >>> for device in devices: |
31 | | - ... print(device.Name, device.SerialNumber) |
32 | | - ... |
33 | | - neoVI FIRE 59886 |
| 25 | +- Mac builds use [libicsneo](https://github.com/intrepidcs/libicsneo) and are built using cibuildwheel |
34 | 26 |
|
35 | | -It should be noted that `ics.NeoDevice` is used a little bit differently than the C API. `ics.NeoDevice` contains two extra members: |
| 27 | +# Documentation |
| 28 | + |
| 29 | +http://python-ics.readthedocs.io/ |
36 | 30 |
|
37 | | -`ics.NeoDevice.AutoHandleClose` and `ics.NeoDevice._Handle` |
38 | | -The handle normally returned from `icsneoOpenNeoDevice()` is stored inside `_Handle` and setting `AutoHandleClose` to `True` (Default) will automatically close the handle when the `ics.NeoDevice` goes out of scope. |
39 | 31 |
|
40 | 32 | # License - MIT |
41 | 33 |
|
|
0 commit comments