openblt/Host/Source/LibOpenBLT/bindings/python
Frank Voorburg bbd3055477 Refs #560. Updated version numbers of all components (where applicable) and rebuild the Windows binaries in preparation for the next release.
git-svn-id: https://svn.code.sf.net/p/openblt/code/trunk@529 5dc33758-31d5-4daf-9ae8-b24bf3d40d73
2018-07-03 10:22:04 +00:00
..
openblt Refs #384. Updated python bindings package for LibOpenBLT, such that it can load the shared library file from the current working directory, if it is present there. 2018-03-08 10:19:42 +00:00
README.rst Refs #489. Added readme to LibOpenBLT's Pascal bindings. 2018-03-08 14:28:07 +00:00
setup.py Refs #560. Updated version numbers of all components (where applicable) and rebuild the Windows binaries in preparation for the next release. 2018-07-03 10:22:04 +00:00

README.rst

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Python wrapper for LibOpenBLT
=============================
The OpenBLT Host Library (`LibOpenBLT <https://www.feaser.com/openblt/doku.php?id=manual:libopenblt>`_) contains an application programming interface (API) for communicating with a microcontroller target, running the OpenBLT bootloader, for making firmware updates on the target. The goal of the OpenBLT Host Library is to empower you to quickly and efficiently create your own firmware update tool, in case you dont prefer the standard MicroBoot and BootCommander tools that are included in the OpenBLT bootloader package.

This package contains the python wrapper for LibOpenBLT, which enables you to quickly develop your own firmware update tool in the Python programming language.

Install the package
-------------------
Run the following command from the directory that contains the **setup.py** file (assuming setuptools is installed):

::

    python setup.py install

Alternatively, you can use **pip** by running this command from the directory that contains the **setup.py** file:

::

    pip install .


Using the package
-----------------
Basic code snippet to call the BltVersionGetString()-function which displays the version of LibOpenBLT:

::

    import openblt

    print('LibOpenBLT version:', openblt.version_get_string())

Have a look at the function headers inside openblt.lib for details on how to call the functions, including examples.


Run-time libraries
------------------
Copy the LibOpenBLT related run-time libraries into your python program's directory. Refer to the following section on the OpenBLT Wiki for a overview of these run-time libraries:

https://www.feaser.com/openblt/doku.php?id=manual:libopenblt#run-time_libraries.

These run-time libraries can be found in the ./Host directory of the OpenBLT bootloader package. These run-time libraries should also be included, when distributing your program.