zephyr/samples/basic/disco

Title: Disco demo

Description

A simple 'disco' demo. The demo assumes that 2 LEDs are connected to
GPIO outputs of the MCU/board.

After startup, the program looks up a predefined GPIO device defined
by 'PORT', and configures pins 'LED1' and 'LED2' in output mode.
During each iteration of the main loop, the state of GPIO lines will
be changed so that one of the lines is in high state, while the other
is in low, thus switching the LEDs on and off in an alternating
pattern.

This project does not output to the serial console, but instead
causes two LEDs connected to the GPIO device to blink in an
alternating pattern.

--------------------------------------------------------------------------------

Wiring

Nucleo-64 F103RB/F401RE boards:

    Connect two LEDs to PB5 and PB8 pins. PB5 is mapped to the
    Arduino's D4 pin and PB8 to Arduino's D15. For more details about
    these boards see:

	https://developer.mbed.org/platforms/ST-Nucleo-F103RB/
	https://developer.mbed.org/platforms/ST-Nucleo-F401RE/

Arduino 101 (x86):

    Connect two LEDs to D4 (IO4) and D7 (IO7) pins. The schematics
    for the Arduino 101 board is available at:

	https://www.arduino.cc/en/uploads/Main/Arduino101-REV4Schematic.pdf

    For Arduino 101's pinmux mapping in Zephyr, see:

	boards/x86/arduino_101/pinmux.c

    Modify the src/main.c file and set:

    #define PORT	CONFIG_GPIO_QMSI_0_NAME
    /* GPIO_19 is Arduino's D4 */
    #define LED1	19
    /* GPIO_20 is Arduino's D7 */
    #define LED2	20

--------------------------------------------------------------------------------

Building

Nucleo F103RB:

    make pristine && make BOARD=nucleo_f103rb

Nucleo F401RE:

    make pristine && make BOARD=nucleo_f401re

Arduino 101:

    make pristine && make BOARD=arduino_101

The code may need some work before running on another board: set PORT,
LED1 and LED2 according to the board's GPIO configuration.

--------------------------------------------------------------------------------

Troubleshooting

Problems caused by out-dated project information can be addressed by
issuing one of the following commands then rebuilding the project:

    make clean          # discard results of previous builds
                        # but keep existing configuration info
or
    make pristine       # discard results of previous builds
                        # and restore pre-defined configuration info

--------------------------------------------------------------------------------