Added README.md with usage instructions

This commit is contained in:
Xavi92 2019-10-29 01:50:09 +01:00 committed by GitHub
parent 6c58ed406a
commit 858c50339f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 25 additions and 0 deletions

25
README.md Normal file
View File

@ -0,0 +1,25 @@
# stm8-binutils-gdb
## Overview
This repository implements, via some patches, STM8 support for the GNU binutils package.
It has been forked from https://stm8-binutils-gdb.sourceforge.io/ in order to add support
for unused code elimination at link-time via `--gc-sections`. On the other hand, new relocation
opcodes `hi8()`, `lo8()` and `hh8()` have been implemented for the STM8 port of GNU `as`.
This is meant to be used with a fork of SDCC I created which generates GNU `as`-compatible assembly
files via the new `--gas`, `--function-sections` and `--data-sections` switches. These changes have not been integrated into SDCC's main branch, so you
can find them at https://github.com/XaviDCR92/sdcc-gas .
## Usage
```
./patch_binutils.sh
./configure_binutils.sh
cd binutils-2.30/
make
sudo make install
```
## Examples
You can find a small working code example of the new capabilities provided by this fork at
https://github.com/XaviDCR92/stm8-dce-example .
## Thanks
Thanks to **arehnman**, who created the original package and helped me out **a lot** to get this working.
Also, thanks to the SDCC developers to their hard work in providing an interesting alternative to
existing STM8 propietary compilers.