nes-proj/examples/dev/gpio-hal/README.md
2018-02-24 12:50:02 +00:00

1.3 KiB

GPIO HAL Example

This example demonstrates and tests the functionality of the GPIO HAL. You can use it to:

  • Understand the logic of the GPIO HAL.
  • Test your implementation of arch-specific GPIO HAL components if you are developing a new port.

This example assumes a device with:

  • 3 output pins (e.g. LEDs).
  • 1 button.

Supported devices

This example is expected to work off-the-shelf on the following boards:

  • All CC13xx/CC26xx devices
  • All CC2538 devices

Extending for other platforms

Create a sub-directory with the same name as your platform. For example, for platform my-new-platform create a subdirectory called my-new-platform. Source files in this directory will be compiled automatically. In the most simple case, all you will need is a source file called e.g. pins.c (it's OK to use a different filename). In this file, you will need to provide definitions of the variables used by the example to manipulate pins. These variables are:

  • out_pin1, out_pin2 and out_pin3 for output pins.
  • btn_pin for the button pin.

Assign to those variables a value that corresponds to the output pin in your board that you wish to test with the example. For example, if you have a LED connected to pin 20, then you will need to

gpio_hal_pin_t out_pin1 = 20;