add WIP TGDS setup notes

1 files changed, 33 insertions, 0 deletions

diff --git a/hb/readme.md b/hb/readme.md
new file mode 100644
index 0000000..365d61c
--- /dev/null
+++ b/hb/readme.md
@@ -0,0 +1,33 @@
+# homebrew
+
+homebrew pictochat client WIP
+
+This project uses [TGDS][toolchaingenericds]
+
+
+## toolchain notes
+
+Setting up the toolchain was not straightforward :(
+
+- The provided readme\.md files are not properly formatted as markdown, and I
+  recommend you open them in a text editor/raw view instead of previewing them
+  on GitLab/GitHub.
+- To fix [newlib-nds][newlib-nds] not building (required for building
+  `toolchaingenericds`)
+    - First run `make` in the `newlib-nds` folder (inside the `newlib-nds`
+      repository)
+    - `cd` into the `temp/Coto88-toolchaingenericds-utils-*` folder
+    - Manually specify the target `libz.a` in the recursive `make` call inside
+      the `installzlib` target (i.e. append `libz.a` to the end of the line
+      containing `$(MAKE)` under `installzlib:`)
+    - Manually add a declaration for `crc32_z` at the top of `minizip.c`:
+      ```c
+      unsigned long crc32_z(unsigned long, const unsigned char *, unsigned long long);
+      ```
+    - Run `make` inside this folder (this will automatically install the
+      `toolchaingenericds-utils` binary under `/usr/arm-none-eabi/bin`)
+
+
+[toolchaingenericds]: https://bitbucket.org/Coto88/toolchaingenericds
+[newlib-nds]: https://bitbucket.org/Coto88/newlib-nds
+