manual:libopenblt
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
manual:libopenblt [2022/02/10 10:47] voorburg [Building on Windows with Microsoft Visual C++] |
manual:libopenblt [2022/03/02 13:11] (current) voorburg |
||
|---|---|---|---|
| Line 2: | Line 2: | ||
| The OpenBLT Host Library 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 don’t prefer the standard MicroBoot and BootCommander tools that are included in the OpenBLT bootloader package. | The OpenBLT Host Library 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 don’t prefer the standard MicroBoot and BootCommander tools that are included in the OpenBLT bootloader package. | ||
| + | |||
| + | Note that LibOpenBLT was designed for PCs and embedded Linux devices. If you would like to integrate similar functionality on a microcontroller, have a look at [[manual:libmicroblt|LibMicroBLT]]. | ||
| {{:manual:libopenblt_architecture.png?nolink&|}} | {{:manual:libopenblt_architecture.png?nolink&|}} | ||
| Line 31: | Line 33: | ||
| * If you develop your custom program in C#, set the __Platform target__ to __x64__. | * If you develop your custom program in C#, set the __Platform target__ to __x64__. | ||
| * Etc. | * Etc. | ||
| + | |||
| + | If you use the LibOpenBLT shared library from before OpenBLT version 1.14, or if you rebuilt it yourself as 32-bit, then your own custom program must also be built as a 32-bit application. | ||
| + | |||
| ===== Building LibOpenBLT from sources ===== | ===== Building LibOpenBLT from sources ===== | ||
| Line 66: | Line 71: | ||
| After a successful build, the shared library **libopenblt.dll** is located in the **./Host** directory. | After a successful build, the shared library **libopenblt.dll** is located in the **./Host** directory. | ||
| - | Note that if you want to build a 32-bit version of LibOpenBLT, generate the build environment with command "**cmake -A Win32 ..**" instead. | + | Note that if you want to build a 32-bit version of LibOpenBLT, generate the build environment with command "**cmake -A Win32 ..**" instead. This is recommended if you use OpenBLT from before version 1.14. |
| ==== Building on Windows with MinGW ==== | ==== Building on Windows with MinGW ==== | ||
| - | This method assumes that the MinGW compiler toolchain is installed on your PC. The installer can be downloaded from https://sourceforge.net/projects/mingw-w64/. | + | This method assumes that the MinGW compiler toolchain is installed on your PC. A convenient way to install it, is by downloading the installer that bundles the Code::Blocks IDE together with MinGW. When using OpenBLT version 1.14 or newer, it is recommended to download the [[https://sourceforge.net/projects/codeblocks/files/Binaries/20.03/Windows/codeblocks-20.03mingw-setup.exe/download|64-bit installer version]], because all included PC binaries are 64-bit as well. Otherwise you can download the [[https://sourceforge.net/projects/codeblocks/files/Binaries/20.03/Windows/32bit/codeblocks-20.03-32bit-mingw-32bit-setup.exe/download|32-bit installer version]]. |
| Make sure the **.\bin** directory of the MinGW installation directory is added to your path in Windows. A quick way to verify that this is the case, run the following command from the Command Prompt in Windows and make sure the program could be found: | Make sure the **.\bin** directory of the MinGW installation directory is added to your path in Windows. A quick way to verify that this is the case, run the following command from the Command Prompt in Windows and make sure the program could be found: | ||
| Line 79: | Line 84: | ||
| <code> | <code> | ||
| - | cmake -G "MinGW Makefiles" .. | + | cmake -G "CodeBlocks - MinGW Makefiles" .. |
| mingw32-make | mingw32-make | ||
| </code> | </code> | ||
| Line 113: | Line 118: | ||
| https://sourceforge.net/p/openblt/code/HEAD/tree/trunk/Host/Source/LibOpenBLT/bindings/pascal/ | https://sourceforge.net/p/openblt/code/HEAD/tree/trunk/Host/Source/LibOpenBLT/bindings/pascal/ | ||
| + | Note that the [[manual:microboot|MicroBoot]] firmware update tool itself is developed using Lazarus, using exactly these bindings. The OpenBLT download package includes the full source code for MicroBoot. You can use it as a reference on how to use the Pascal bindings for LibOpenBLT. | ||
manual/libopenblt.1644486462.txt.gz · Last modified: 2022/02/10 10:47 by voorburg
Page Tools
