diff --git a/boards/boards.rst b/boards/boards.rst index b9af5ddc9c6..e1d812a9213 100644 --- a/boards/boards.rst +++ b/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 diff --git a/boards/x86/quark_d2000_crb/doc/quark_d2000_crb.rst b/boards/x86/quark_d2000_crb/doc/quark_d2000_crb.rst new file mode 100644 index 00000000000..612f9fc5671 --- /dev/null +++ b/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 + +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 + diff --git a/samples/basic/button/README.rst b/samples/basic/button/README.rst index 50e9acf6d40..0c75e638993 100644 --- a/samples/basic/button/README.rst +++ b/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