samples/basic/disco: Add support for Nucleo F401RE and A101

The README.txt file is updated with information about wiring
and building. A testcase.ini file is also added by this patch.

Change-Id: I7354d844ac3dec41f0c9af02ede5da26f3ad0398
Signed-off-by: Flavio Santes <[email protected]>

Author: 1010101001010101

samples/basic/disco/README.txt

@@ -1,34 +1,75 @@
 Title: Disco demo
 
-Description:
+Description
 
 A simple 'disco' demo. The demo assumes that 2 LEDs are connected to
-GPIO outputs of the MCU/board. The sample code is configured to work
-on Nucleo-64 F103RB board, with LEDs connected to PB5 and PB8
-pins.
+GPIO outputs of the MCU/board.
 
-After startup, the program looks up a predefined GPIO device (GPIOB),
-and configures pins 5 and 8 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.
+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.
 
 --------------------------------------------------------------------------------
 
-Building and Running Project:
+Wiring
 
-This microkernel project does not output to the console, but instead
-causes two LEDs connected to the GPIO device to blink in an
-alternating pattern. It can be built for a nucleo_f103rb board as
-follows:
+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
+    make pristine && make BOARD=arduino_101
 
-The code may need adaption before running the code on another board.
+The code may need some work before running on another board: set PORT,
+LED1 and LED2 according to the board's GPIO configuration.
 
 --------------------------------------------------------------------------------
 
-Troubleshooting:
+Troubleshooting
 
 Problems caused by out-dated project information can be addressed by
 issuing one of the following commands then rebuilding the project:

samples/basic/disco/prj.conf

@@ -1 +1 @@
-# use default configuration settings
+# nothing here

samples/basic/disco/testcase.ini

@@ -0,0 +1,4 @@
+[test]
+build_only = true
+tags = samples
+platform_whitelist = nucleo_f103rb nucleo_f401re