2009-07-15 20:07:00 +00:00
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
README
|
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
2009-07-15 16:59:07 +00:00
|
|
|
The libopenstm32 project aims to create an open-source firmware library for
|
2009-07-15 22:01:41 +00:00
|
|
|
STM32 microcontrollers.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Building
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
$ make
|
|
|
|
|
|
2009-07-15 23:23:48 +00:00
|
|
|
You may want to override the toolchain (e.g., arm-elf or arm-none-eabi):
|
|
|
|
|
|
|
|
|
|
$ PREFIX=arm-none-eabi make
|
|
|
|
|
|
2009-07-16 16:33:32 +00:00
|
|
|
For a more verbose build you can use
|
|
|
|
|
|
|
|
|
|
$ make V=1
|
|
|
|
|
|
2009-07-15 22:01:41 +00:00
|
|
|
|
2010-01-15 12:33:58 +00:00
|
|
|
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/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.
|
|
|
|
|
|
|
|
|
|
|
2009-07-15 22:01:41 +00:00
|
|
|
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
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
The whole library is programmed using the Linux kernel coding style, see
|
|
|
|
|
http://lxr.linux.no/linux/Documentation/CodingStyle for details.
|
|
|
|
|
|
|
|
|
|
Please use the same style for any code contributions, thanks!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
License
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
The libopenstm32 code is released under the terms of the GNU General
|
2009-07-18 14:27:47 +00:00
|
|
|
Public License (GPL), version 3 or later.
|
2009-07-15 22:01:41 +00:00
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
2009-07-15 23:30:45 +00:00
|
|
|
http://sourceforge.net/projects/libopenstm32/
|
2009-07-15 16:59:07 +00:00
|
|
|
|
