Import Mbed OS hard-float snapshot

TESTS/mbed_hal_fpga_ci_test_shield/gpio/gpio_fpga_test.h

@@ -0,0 +1,69 @@
+/* mbed Microcontroller Library
+ * Copyright (c) 2019-2020 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/** \addtogroup hal_gpio_tests */
+/** @{*/
+
+#ifndef MBED_FPGA_GPIO_TEST_H
+#define MBED_FPGA_GPIO_TEST_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Test basic input & output operations.
+ *
+ * Given a GPIO instance initialized with a generic gpio_init() function,
+ * when basic input and output operations are performed,
+ * then all operations succeed.
+ */
+void fpga_test_basic_input_output(PinName pin);
+
+/* Test input pull modes.
+ *
+ * Given a GPIO instance configured with an input pull mode,
+ * when basic input operations are performed,
+ * then all operations succeed.
+ */
+void fpga_test_input_pull_modes(PinName pin);
+
+/* Test explicit input initialization.
+ *
+ * Given a GPIO instance,
+ * when additional parameters are passed to the input init function,
+ * then the GPIO is correctly initialized as an input.
+ */
+void fpga_test_explicit_input(PinName pin);
+
+/* Test explicit output initialization.
+ *
+ * Given a GPIO instance,
+ * when additional parameters are passed to the output init function,
+ * then the GPIO is correctly initialized as an output.
+ */
+void fpga_test_explicit_output(PinName pin);
+
+/**@}*/
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+
+
+/**@}*/

TESTS/mbed_hal_fpga_ci_test_shield/gpio/main.cpp

@@ -0,0 +1,328 @@
+/*
+ * Copyright (c) 2019-2020, Arm Limited and affiliates.
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#if !COMPONENT_FPGA_CI_TEST_SHIELD
+#error [NOT_SUPPORTED] FPGA CI Test Shield is needed to run this test
+#elif !defined(TARGET_FF_ARDUINO) && !defined(MBED_CONF_TARGET_DEFAULT_FORM_FACTOR)
+#error [NOT_SUPPORTED] Test not supported for this form factor
+#else
+
+#include "utest/utest.h"
+#include "unity/unity.h"
+#include "greentea-client/test_env.h"
+#include "mbed.h"
+#include "MbedTester.h"
+#include "pinmap.h"
+#include "test_utils.h"
+#include "gpio_fpga_test.h"
+
+using namespace utest::v1;
+
+// This delay is used when reading a floating input that has an internal pull-up
+// or pull-down resistor. The voltage response is much slower when the input
+// is not driven externally.
+#define HI_Z_READ_DELAY_US 5
+
+MbedTester tester(DefaultFormFactor::pins(), DefaultFormFactor::restricted_pins());
+
+/* Test basic input & output operations.
+ *
+ * Given a GPIO instance initialized with a generic gpio_init() function,
+ * when basic input and output operations are performed,
+ * then all operations succeed.
+ */
+void fpga_test_basic_input_output(PinName pin)
+{
+    // Reset everything and set all tester pins to hi-Z.
+    tester.reset();
+
+    // Map pins for test.
+    tester.pin_map_set(pin, MbedTester::LogicalPinGPIO0);
+
+    // Select GPIO0.
+    tester.select_peripheral(MbedTester::PeripheralGPIO);
+
+    gpio_t gpio;
+    // Initialize GPIO pin with a generic init fun.
+    gpio_init(&gpio, NC);
+    // Test gpio_is_connected() returned value.
+    TEST_ASSERT_EQUAL_INT(0, gpio_is_connected(&gpio));
+    gpio_free(&gpio);
+    gpio_init(&gpio, pin);
+    TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+
+    // Test GPIO used as an input.
+    gpio_dir(&gpio, PIN_INPUT);
+    tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+    TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+    tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, true);
+    TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio));
+    tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+    TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+
+    // Test GPIO used as an output.
+    tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+    gpio_dir(&gpio, PIN_OUTPUT);
+    gpio_write(&gpio, 0);
+    TEST_ASSERT_EQUAL_INT(0, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+    gpio_write(&gpio, 1);
+    TEST_ASSERT_EQUAL_INT(1, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+    gpio_write(&gpio, 0);
+    TEST_ASSERT_EQUAL_INT(0, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+
+    gpio_free(&gpio);
+}
+
+/* Test input pull modes.
+ *
+ * Given a GPIO instance configured with an input pull mode,
+ * when basic input operations are performed,
+ * then all operations succeed.
+ */
+void fpga_test_input_pull_modes(PinName pin)
+{
+    // Reset everything and set all tester pins to hi-Z.
+    tester.reset();
+
+    // Map pins for test.
+    tester.pin_map_set(pin, MbedTester::LogicalPinGPIO0);
+
+    // Select GPIO0.
+    tester.select_peripheral(MbedTester::PeripheralGPIO);
+
+    gpio_t gpio;
+    // Initialize GPIO pin with a generic init fun.
+    gpio_init(&gpio, pin);
+    TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+    gpio_dir(&gpio, PIN_INPUT);
+    gpio_capabilities_t gcap = {};
+    gpio_get_capabilities(&gpio, &gcap);
+
+    // Test input, pull-up mode.
+    if (gcap.pull_up) {
+        gpio_mode(&gpio, PullUp);
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio)); // hi-Z, pulled up
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, true);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, true);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio)); // hi-Z, pulled up
+    } else {
+        utest_printf("skipped PullUp,");
+    }
+
+    // Test input, pull-down mode.
+    if (gcap.pull_down) {
+        gpio_mode(&gpio, PullDown);
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio)); // hi-Z, pulled down
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, true);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio)); // hi-Z, pulled down
+    } else {
+        utest_printf("skipped PullDown,");
+    }
+
+    // Test input, pull-none mode.
+    if (gcap.pull_none) {
+        gpio_mode(&gpio, PullNone);
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, true);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 1, true);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio));
+    } else {
+        utest_printf("skipped PullNone,");
+    }
+
+    gpio_free(&gpio);
+}
+
+/* Test explicit input initialization.
+ *
+ * Given a GPIO instance,
+ * when additional parameters are passed to the input init function,
+ * then the GPIO is correctly initialized as an input.
+ */
+void fpga_test_explicit_input(PinName pin)
+{
+    // Reset everything and set all tester pins to hi-Z.
+    tester.reset();
+
+    // Map pins for test.
+    tester.pin_map_set(pin, MbedTester::LogicalPinGPIO0);
+
+    // Select GPIO0.
+    tester.select_peripheral(MbedTester::PeripheralGPIO);
+
+    gpio_t gpio;
+    gpio_init(&gpio, pin);
+    gpio_capabilities_t gcap = {};
+    gpio_get_capabilities(&gpio, &gcap);
+    gpio_free(&gpio);
+
+    // Initialize GPIO pin as an input, pull-up mode.
+    if (gcap.pull_up) {
+        memset(&gpio, 0, sizeof gpio);
+        gpio_init_in_ex(&gpio, pin, PullUp);
+        TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio)); // hi-Z, pulled up
+        gpio_free(&gpio);
+    } else {
+        utest_printf("skipped PullUp,");
+    }
+
+    // Initialize GPIO pin as an input, pull-down mode.
+    if (gcap.pull_down) {
+        memset(&gpio, 0, sizeof gpio);
+        gpio_init_in_ex(&gpio, pin, PullDown);
+        TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio)); // hi-Z, pulled down
+        gpio_free(&gpio);
+    } else {
+        utest_printf("skipped PullDown,");
+    }
+
+    // Initialize GPIO pin as an input, pull-up mode.
+    if (gcap.pull_up) {
+        memset(&gpio, 0, sizeof gpio);
+        gpio_init_inout(&gpio, pin, PIN_INPUT, PullUp, 0);
+        TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(1, gpio_read(&gpio)); // hi-Z, pulled up
+        gpio_free(&gpio);
+    } else {
+        utest_printf("skipped PullUp,");
+    }
+
+    // Initialize GPIO pin as an input, pull-down mode.
+    if (gcap.pull_down) {
+        memset(&gpio, 0, sizeof gpio);
+        gpio_init_inout(&gpio, pin, PIN_INPUT, PullDown, 0);
+        TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+        tester.gpio_write(MbedTester::LogicalPinGPIO0, 0, false);
+        wait_us(HI_Z_READ_DELAY_US);
+        TEST_ASSERT_EQUAL_INT(0, gpio_read(&gpio)); // hi-Z, pulled down
+        gpio_free(&gpio);
+    } else {
+        utest_printf("skipped PullDown,");
+    }
+}
+
+/* Test explicit output initialization.
+ *
+ * Given a GPIO instance,
+ * when additional parameters are passed to the output init function,
+ * then the GPIO is correctly initialized as an output.
+ */
+void fpga_test_explicit_output(PinName pin)
+{
+    // Reset everything and set all tester pins to hi-Z.
+    tester.reset();
+
+    // Map pins for test.
+    tester.pin_map_set(pin, MbedTester::LogicalPinGPIO0);
+
+    // Select GPIO0.
+    tester.select_peripheral(MbedTester::PeripheralGPIO);
+
+    gpio_t gpio;
+    gpio_init(&gpio, pin);
+    gpio_capabilities_t gcap = {};
+    gpio_get_capabilities(&gpio, &gcap);
+    gpio_free(&gpio);
+
+    // Initialize GPIO pin as an output, output value = 0.
+    memset(&gpio, 0, sizeof gpio);
+    gpio_init_out(&gpio, pin);
+    TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+    TEST_ASSERT_EQUAL_INT(0, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+    gpio_free(&gpio);
+
+    // Initialize GPIO pin as an output, output value = 1.
+    memset(&gpio, 0, sizeof gpio);
+    gpio_init_out_ex(&gpio, pin, 1);
+    TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+    TEST_ASSERT_EQUAL_INT(1, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+    gpio_free(&gpio);
+
+    // Initialize GPIO pin as an output, output value = 0.
+    memset(&gpio, 0, sizeof gpio);
+    gpio_init_out_ex(&gpio, pin, 0);
+    TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+    TEST_ASSERT_EQUAL_INT(0, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+    gpio_free(&gpio);
+
+    // Initialize GPIO pin as an output, output value = 1.
+    if (gcap.pull_none) {
+        memset(&gpio, 0, sizeof gpio);
+        gpio_init_inout(&gpio, pin, PIN_OUTPUT, PullNone, 1);
+        TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+        TEST_ASSERT_EQUAL_INT(1, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+        gpio_free(&gpio);
+
+        // Initialize GPIO pin as an output, output value = 0.
+        memset(&gpio, 0, sizeof gpio);
+        gpio_init_inout(&gpio, pin, PIN_OUTPUT, PullNone, 0);
+        TEST_ASSERT_NOT_EQUAL(0, gpio_is_connected(&gpio));
+        TEST_ASSERT_EQUAL_INT(0, tester.gpio_read(MbedTester::LogicalPinGPIO0));
+        gpio_free(&gpio);
+    } else {
+        utest_printf("skipped gpio_init_inout,");
+    }
+}
+
+Case cases[] = {
+    Case("basic input & output", all_ports<GPIOPort, DefaultFormFactor, fpga_test_basic_input_output>),
+    Case("input pull modes", all_ports<GPIOPort, DefaultFormFactor, fpga_test_input_pull_modes>),
+    Case("explicit init, input", all_ports<GPIOPort, DefaultFormFactor, fpga_test_explicit_input>),
+    Case("explicit init, output", all_ports<GPIOPort, DefaultFormFactor, fpga_test_explicit_output>),
+};
+
+utest::v1::status_t greentea_test_setup(const size_t number_of_cases)
+{
+    GREENTEA_SETUP(60, "default_auto");
+    return greentea_test_setup_handler(number_of_cases);
+}
+
+Specification specification(greentea_test_setup, cases, greentea_test_teardown_handler);
+
+int main()
+{
+    Harness::run(specification);
+}
+
+#endif /* !COMPONENT_FPGA_CI_TEST_SHIELD */