aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorXavier ASUS <xavi92psx@gmail.com>2019-10-29 23:25:59 +0100
committerXavier ASUS <xavi92psx@gmail.com>2019-10-29 23:25:59 +0100
commit7c2ecfe5d0effb87f436d3b9b908f79d751d96ff (patch)
tree365d19970145f521603fbca142d6f34b5972a147
parentfb0ec944206a38db7d2d3f6985558f73959340f7 (diff)
parent858c50339ff503545fbccfd6da45cbc8a937b23c (diff)
Merge branch 'master' of https://github.com/XaviDCR92/stm8-binutils-gdb
-rw-r--r--README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..67412a1
--- /dev/null
+++ b/README.md
@@ -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.