From 8085e7d646d29564154459d0024b3731987bec94 Mon Sep 17 00:00:00 2001 From: Sebastien Bourdeauducq Date: Sat, 11 Jul 2020 19:00:19 +0800 Subject: [PATCH] README: document config --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 28f9d326..d91d15ae 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,19 @@ How to use 7. Power up the board. After the firmware starts successfully, it should respond to ping at its IP addresses, and boot messages can be observed from its UART at 115200bps. 8. Create and use an ARTIQ device database as usual, but set ``"target": "cortexa9"`` in the arguments of the core device. +Configuration +------------- + +Configuring the device is done using the ``config.txt`` text file at the root of the SD card, plus the content of the ``config`` folder. When searching for a configuration key, the firmware first looks for a file named ``/config/[key].bin`` and, if it exists, returns the contents of that file. If not, it looks into ``config.txt``, which contains a list of ``key=value`` pairs, one per line. The ``config`` folder allows configuration values to consist in binary data. + +The following configuration keys are available: + +- ``mac``: Ethernet MAC address. +- ``ip``: IPv4 address. +- ``ip6``: IPv6 address. +- ``startup``: startup kernel in ELF format (as produced by ``artiq_compile``). +- ``rtioclk``: source of RTIO clock; valid values are ``external`` and ``internal``. + Development instructions ------------------------