12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 |
- #ifndef PCIPYWRAP_H
- #define PCIPYWRAP_H
- #include "pci.h"
- #include "error.h"
- #include <Python.h>
- typedef struct {
- void* ctx;
- int shared;
- } pcipywrap;
- /*!
- * \brief Redirect pcilib standart log stream to exeption text.
- * Logger will accumulate errors untill get message, starts with "#E".
- * After that, logger will write last error, and all accumulated errors
- * to Python exeption text
- */
- void redirect_logs_to_exeption();
- /*!
- * \brief Wraps for pcilib_open function.
- * \param[in] fpga_device path to the device file [/dev/fpga0]
- * \param[in] model specifies the model of hardware, autodetected if NULL is passed
- * \return Pointer to pcilib_t, created by pcilib_open; NULL with exeption text, if failed.
- */
- PyObject* create_pcilib_instance(const char *fpga_device, const char *model);
- pcipywrap *new_pcipywrap(const char* fpga_device, const char* model);
- pcipywrap *create_pcipywrap(PyObject* ctx);
- void delete_pcipywrap(pcipywrap *self);
- /*!
- * \brief Reads register value. Wrap for pcilib_read_register function.
- * \param[in] regname the name of the register
- * \param[in] bank should specify the bank name if register with the same name may occur in multiple banks, NULL otherwise
- * \return register value, can be integer or float type; NULL with exeption text, if failed.
- */
- PyObject* pcipywrap_read_register(pcipywrap *self, const char *regname, const char *bank);
- /*!
- * \brief Writes value to register. Wrap for pcilib_write_register function.
- * \param[in] val Register value, that needs to be set. Can be int, float or string.
- * \param[in] regname the name of the register
- * \param[in] bank should specify the bank name if register with the same name may occur in multiple banks, NULL otherwise
- * \return 1, serialized to PyObject or NULL with exeption text, if failed.
- */
- PyObject* pcipywrap_write_register(pcipywrap *self, PyObject* val, const char *regname, const char *bank);
- /*!
- * \brief Reads propety value. Wrap for pcilib_get_property function.
- * \param[in] prop property name (full name including path)
- * \return property value, can be integer or float type; NULL with exeption text, if failed.
- */
- PyObject* pcipywrap_get_property(pcipywrap *self, const char *prop);
- /*!
- * \brief Writes value to property. Wrap for pcilib_set_property function.
- * \param[in] prop property name (full name including path)
- * \param[in] val Property value, that needs to be set. Can be int, float or string.
- * \return 1, serialized to PyObject or NULL with exeption text, if failed.
- */
- PyObject* pcipywrap_set_property(pcipywrap *self, PyObject* val, const char *prop);
- PyObject* pcipywrap_get_registers_list(pcipywrap *self, const char *bank);
- PyObject* pcipywrap_get_register_info(pcipywrap *self, const char* reg,const char *bank);
- PyObject* pcipywrap_get_property_list(pcipywrap *self, const char* branch);
- PyObject* pcipywrap_read_dma(pcipywrap *self, unsigned char dma, size_t size);
- PyObject* pcipywrap_lock_global(pcipywrap *self);
- void pcipywrap_unlock_global(pcipywrap *self);
- /*!
- * \brief Wrap for pcilib_lock
- * \param lock_id lock identificator
- * \warning This function should be called only under Python standart threading lock.
- * Otherwise it will stuck with more than 1 threads. See /xml/test/test_prop4.py
- * for example.
- * \return 1, serialized to PyObject or NULL with exeption text, if failed.
- */
- PyObject* pcipywrap_lock(pcipywrap *self, const char *lock_id);
- PyObject* pcipywrap_lock_persistent(pcipywrap *self, const char *lock_id);
- PyObject* pcipywrap_try_lock(pcipywrap *self, const char *lock_id);
- PyObject* pcipywrap_try_lock_persistent(pcipywrap *self, const char *lock_id);
- PyObject* pcipywrap_unlock(pcipywrap *self, const char *lock_id);
- PyObject* pcipywrap_unlock_persistent(pcipywrap *self, const char *lock_id);
- #endif /* PCIPYWRAP_H */
|