Skip to content
Snippets Groups Projects
Forked from card10 / firmware
1398 commits behind the upstream repository.
Rahix's avatar
rahix authored
The vector table's alignment requirements depend on the number of
interrupts [1].  In our case, we have 0x6E(=110) interrupts and thus an
alignment requirement of 0x80(=128).

To satisfy this requirement, this commit moves the IVT to the beginning
of .text and enforces a 128 byte alignment.  Please note that the
headers which come before .text will push the IVT to 0x100 instead of
having it directly in the beginning at 0x00.

[1]: https://developer.arm.com/docs/dui0553/a/cortex-m4-peripherals/system-control-block/vector-table-offset-register



Signed-off-by: default avatarRahix <rahix@rahix.de>
1067d234
History

card10 Firmware Readme

Firmware for the card10 badge for the Chaos Communication Camp 2019.

We keep documentation in the Documentation/ subdirectory. You can find a rendered version over at https://firmware.card10.badge.events.ccc.de/.

How To Help

If you want to help us ensure the card10 will have been exactly as we reconstructed from the audio-logs we recovered, please head over to our wiki, or directly to the issue tracker.

How To Build

A full guide for building is available in the docs as How To Build.

Last Artifacts from Gitlab-CI: pipeline status

How To Flash

Flasing with or without a debugger is described in detail in How To Flash.

Debugger

If you have a debugger, head over to our Debugger page to learn how to use it.

License

Unless otherwise noted in a file, the contents of this repository are licensed under the MIT license. See COPYING for more details.


Old README Contents:

TODO: Move over into new docs

Serial Console

Learn more about card10's Serial Console.

Bootloader

The bootloader is used to flash card10 without an external debugger. It exposes the file system via USB and accepts a card10.bin file as firmware image.

To flash the bootloader, go to the bootloader directory and follow the steps above.

To execute the bootloader, turn off card10, press the lower right button and turn on. Connect card10 via a USB cable to a computer and mount the file system. You can now copy your card10.bin file to the file system. Eject the drive (IMPORTANT!) via your operating system (umount and sync is not enough). Turn card10 off and back on again. It will try to boot the image.

IMPORTANT: The prototypes have the USB data lines reversed. Use the provided USB adapter to connect card10.

Building card10.bin

Run ./build_image. TODO: Add to meson

The tool uses Python to generate a CRC. Make sure to have python-crc16 installed.