boards: add quark_d2000_crb documentation

Change-Id: Idb4ed43c8639cee2673dff24b18ff2ccd76a1396
Signed-off-by: Anas Nashif <anas.nashif@intel.com>

boards/boards.rst

@@ -3,6 +3,13 @@
 Supported Boards
 ################
 
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   **/*
+
 A list of additional supported boards can be found on the `Zephyr project wiki`_.
 
 To add a new board, please use the template available under

boards/x86/quark_d2000_crb/doc/quark_d2000_crb.rst

@@ -0,0 +1,129 @@
+.. _quark_d2000_devboard:
+
+Quark D2000 Development Board
+#############################
+
+Overview
+========
+
+The Intel® Quark ™ microcontroller D2000 package is shipped as a 40-pin QFN
+component.
+
+Intel™ Quark® microcontroller D2000 contains the following items:
+
+- On-board components:
+
+  - Accelerometer/Magnetometer sensor
+  - UART/JTAG to USB convert for USB debug port
+
+- Expansion options:
+
+  - “Arduino Uno” compatible SIL sockets ( 3.3V IO Only )
+
+- Other connectors:
+
+  - 1x USB 2.0 Device Port – micro Type B
+  - On-board coin cell battery holder
+  - 5V input a screw terminal/header (external power or Li-ion)
+  - EEMBC power input header
+
+Hardware
+========
+
+General information for the board can be found at the `Intel Website`_,
+which includes both `schematics`_ and BRD files.
+
+The Intel® Quark™ Microcontroller D2000 Development Platform supports the
+familiar open standard Arduino Uno Rev 3.0 physical interface and is
+mechanically compatible with Uno Rev 3.0. It does not support the 6 pin ICSP
+Header.
+
+
+Supported Features
+-------------------
+
++-----------+------------+-----------------------+
+| Interface | Controller | Driver/Component      |
++===========+============+=======================+
+| MVIC      | on-chip    | interrupt_controller  |
++-----------+------------+-----------------------+
+| UART      | on-chip    | serial port-polling;  |
+|           |            | serial port-interrupt |
++-----------+------------+-----------------------+
+| SPI       | on-chip    | spi                   |
++-----------+------------+-----------------------+
+| I2C       | on-chip    | i2c                   |
++-----------+------------+-----------------------+
+| GPIO      | on-chip    | gpio                  |
++-----------+------------+-----------------------+
+| PWM       | on-chip    | pwm                   |
++-----------+------------+-----------------------+
+
+
+Programming and Debugging
+=========================
+
+The D2000 board configuration details are found in the project's tree at
+:file:`boards/x86/quark_d2000_crb`.
+
+To build an application for this board, the following call is needed:
+
+.. code-block:: console
+
+   $ make BOARD=quark_d2000_crb <make target>
+
+Flashing
+--------
+
+#. Since the board has a built-in JTAG; it is possible to flash the device
+   through the USB only.  Set the following jumpers to enable the built-in JTAG:
+
+   +--------+------+--------+------+------+
+   | Jumper | UART | Common | JTAG | Name |
+   +========+======+========+======+======+
+   | J9     | Open |   X    |  X   | TDO  |
+   +--------+------+--------+------+------+
+   | J10    | Open |   X    |  X   | TDI  |
+   +--------+------+--------+------+------+
+   | J11    | Open |   X    |  X   | TRST |
+   +--------+------+--------+------+------+
+   | J12    |  X   |  N/A   |  X   | TMS  |
+   +--------+------+--------+------+------+
+   | J17    |  X   |  N/A   |  X   | TCK  |
+   +--------+------+--------+------+------+
+
+#. Connect the D2000 via USB to the host computer.
+
+#. Once the binary is built, it can be flashed to the device by:
+
+   .. code-block:: console
+
+      $ make BOARD=quark_d2000_crb flash
+
+Debugging
+---------
+
+To debug an application on the Quark D2000 board, follow these steps.  As an
+example, we are using the hello_world application.
+
+#. Go to the application's folder:.
+
+   .. code-block:: console
+
+      $ cd $ZEPHYR_BASE/samples/hello_world
+
+#. Verify the final binary is in :file:`outdir/quark_d2000_crb/zephyr.elf`.
+
+#. To enable the debug process, enter:
+
+   .. code-block:: console
+
+      $ make BOARD=quark_d2000_crb debug
+
+
+.. _Intel Website:
+   http://www.intel.com/content/www/us/en/embedded/products/quark/mcu/d2000/quark-d2000-crb-user-guide.html
+
+.. _schematics:
+   http://www.intel.com/content/www/us/en/embedded/products/quark/mcu/d2000/quark-d2000-crb-schematics.html
+

samples/basic/button/README.rst

@@ -28,7 +28,7 @@ The following boards currently define the above variables:
 - nrf52840_pca10056
 - nrf52_pca10040
 - nucleo_f103rb
-- quark_d2000_crb
+- :ref:`quark_d2000_devboard`
 - quark_se_c1000_devboard
 - quark_se_c1000_ss_devboard