103 lines
2.5 KiB
Plaintext
103 lines
2.5 KiB
Plaintext
------------------------------------------------------------------------------
|
|
README
|
|
------------------------------------------------------------------------------
|
|
|
|
The libopenstm32 project aims to create an open-source firmware library for
|
|
STM32 microcontrollers.
|
|
|
|
It is written completely from scratch based on the STM32 datasheets,
|
|
programming manuals, and application notes. The code is meant to be used
|
|
with a GCC toolchain for ARM (arm-elf or arm-none-eabi), flashing of the
|
|
code to an STM32 device can be done using the OpenOCD ARM JTAG software.
|
|
|
|
|
|
Status and API
|
|
--------------
|
|
|
|
The libopenstm32 project is currently work in progress. Not all subsystems
|
|
of the STM32 are supported, yet.
|
|
|
|
IMPORTANT: The API of the library is NOT yet considered stable! Please do
|
|
not rely on it, yet! Changes to function names, macro names etc.
|
|
can happen at any time without prior notice!
|
|
|
|
Building
|
|
--------
|
|
|
|
$ make
|
|
|
|
You may want to override the toolchain (e.g., arm-elf or arm-none-eabi):
|
|
|
|
$ PREFIX=arm-none-eabi make
|
|
|
|
For a more verbose build you can use
|
|
|
|
$ make V=1
|
|
|
|
|
|
Example projects
|
|
----------------
|
|
|
|
The library ships with a few small example projects which illustrate how
|
|
individual subsystems of the SMT32 can be configured and used with
|
|
libopenstm32.
|
|
|
|
For flashing the 'miniblink' example (after you built libopenstm32 and the
|
|
examples by typing 'make' at the top-level directory) you can execute:
|
|
|
|
$ cd examples/stm32-h103/miniblink
|
|
$ make flash
|
|
|
|
The Makefiles of the examples are configured to use a certain OpenOCD
|
|
flash programmer, you might need to change some of the variables in the
|
|
Makefile if you use a different one.
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
$ make install
|
|
|
|
This will install the library in /usr/local. If you want to install it
|
|
elsewhere, use the following syntax:
|
|
|
|
$ DESTDIR=/opt make install
|
|
|
|
|
|
Coding style and development guidelines
|
|
---------------------------------------
|
|
|
|
See HACKING.
|
|
|
|
|
|
License
|
|
-------
|
|
|
|
The libopenstm32 code is released under the terms of the GNU General
|
|
Public License (GPL), version 3 or later.
|
|
|
|
See COPYING for details.
|
|
|
|
|
|
Mailing lists
|
|
-------------
|
|
|
|
* Developer mailing list (for patches and discussions):
|
|
https://lists.sourceforge.net/lists/listinfo/libopenstm32-devel
|
|
|
|
* Commits mailing list (receives one mail per 'git push'):
|
|
https://lists.sourceforge.net/lists/listinfo/libopenstm32-commits
|
|
|
|
|
|
Website
|
|
-------
|
|
|
|
The official website is:
|
|
|
|
http://sourceforge.net/projects/libopenstm32/
|
|
|
|
There's a wiki at:
|
|
|
|
http://sourceforge.net/apps/mediawiki/libopenstm32/
|
|
|