GPIO Driver Sample Application

Description

The GPIO Driver sample application demonstrates common digital input/output operations on SR110 in a simple, test-oriented flow.

In plain terms, it checks that GPIO pins can be configured, written, read back, and used with interrupts correctly. The app runs a sequence of validation steps and prints the result of each step in logs.

What this sample tests:

  • Pin configuration readback: sets GPIO pin configuration and verifies the values by reading them back.

  • Pin-level I/O: writes logic values to test pins and confirms the readback values.

  • Port-level I/O: sets direction and writes/reads at port level using masks.

  • Pin interrupt handling: enables an interrupt on a test pin and verifies ISR handling.

  • Port interrupt configuration: configures interrupt mask/type/polarity/both-edge/enable at port level and verifies status.

The sample uses GPIO pinmux setup internally, initializes both GPIO ports, runs all tests, and then deinitializes the ports.

Prerequisites

Building and Flashing the Example using VS Code

Use the VS Code flow described in the SR110 guide and the VS Code Extension guide:

Build (VS Code):

  1. Open Build and Deploy -> Build Configurations.

  2. Select gpio_sample_app in the Application dropdown.

  3. Build with Build (SDK + App) for the first build, or Build App for rebuilds.

Flash (VS Code):

  1. Use Image Conversion to generate the flash image.

  2. Use Image Flashing (SWD/JTAG) to flash the firmware image.

Building and Flashing the Example using CLI

Use the CLI flow described in the SR110 guide:

Build (CLI):

  1. From <sdk-root>/examples, build the example:

    cd <sdk-root>/examples
export SRSDK_DIR=<sdk-root>
make cm55_gpio_sample_app_defconfig BOARD=SR110_RDK BUILD=SRSDK

Flash (CLI):

  1. Activate the SDK venv (required for image generation tools):

    # Linux/macOS
source <sdk-root>/.venv/bin/activate
# Windows PowerShell
.\.venv\Scripts\Activate.ps1

  2. Generate the flash image:

    cd <sdk-root>/tools/srsdk_image_generator
python srsdk_image_generator.py \
  -B0 \
  -flash_image \
  -sdk_secured \
  -spk "<sdk-root>/tools/srsdk_image_generator/B0_Input_examples/spk_rc4_1_0_secure_otpk.bin" \
  -apbl "<sdk-root>/tools/srsdk_image_generator/B0_Input_examples/sr100_b0_bootloader_ver_0x012F_ASIC.axf" \
  -m55_image "<sdk-root>/examples/out/sr110_cm55_fw/release/sr110_cm55_fw.elf" \
  -flash_type "GD25LE128" \
  -flash_freq "67"

  3. Flash the firmware image:

    cd <sdk-root>
python tools/openocd/scripts/flash_xspi_tcl.py \
  --cfg_path tools/openocd/configs/sr110_m55.cfg \
  --image tools/srsdk_image_generator/Output/B0_Flash/B0_flash_full_image_GD25LE128_67Mhz_secured.bin \
  --erase-all

Running the Application using VS Code Extension

  1. Press RESET on the board after flashing.

  2. For logging output, click SERIAL MONITOR and connect to the DAP logger port on J14.

    • To make it easier to identify, ensure only J14 is plugged in (not J13).

    • The logger port is not guaranteed to be consistent across OSes. As a starting point:

      • Windows: try the lower-numbered J14 COM port first.

      • Linux/macOS: try the higher-numbered J14 port first.

    • If you do not see logs after a reset, switch to the other J14 port.

  3. GPIO sample logs appear in the logger window, including pass/fail status for each GPIO test step.

Expected Logs

0391469191:[0][WRN][LOGR]:Changing logger interface to LOGGER_IF_UART_1
0000000023:[0][INF][SYS ]:Application drivers initialization complete without errors.
0000004209:[0][INF][SYS ]:sr110 SDK version 1.3.0
0000006689:[0][INF][GPIO]:Starting GPIO Sample App!
0000009251:[0][INF][GPIO]:Testing GPIO pin configuration: start
0000012380:[0][INF][GPIO]:Testing GPIO pin configuration: success
0000015603:[0][INF][GPIO]:Testing GPIO pin I/O: start
0000018262:[0][INF][GPIO]:Pin 0 read back value for port 0: 1
0000021292:[0][INF][GPIO]:Pin 1 read back value for port 0: 1
0000024322:[0][INF][GPIO]:Pin 2 read back value for port 0: 1
0000027352:[0][INF][GPIO]:Pin 3 read back value for port 0: 1
0000030385:[0][INF][GPIO]:Testing GPIO pin I/O: success
0000033125:[0][INF][GPIO]:Testing GPIO port operations: start
0000036144:[0][INF][GPIO]:Direction mask for Port 0 : 0xF
0000038988:[0][INF][GPIO]:Port read value for Port 0 : 0xF
0000041868:[0][INF][GPIO]:Testing GPIO port operations: success
0000044991:[0][INF][GPIO]:Testing GPIO interrupts: start
0000047789:[0][INF][GPIO]:Interrupt handled and flag set to: 1
0000051683:[0][INF][GPIO]:Testing GPIO interrupts: success
0000051710:[0][INF][GPIO]:Testing GPIO port interrupt config: start
0000051736:[0][INF][GPIO]:Interrupt mask for Port 0 : 0x100000
0000051762:[0][INF][GPIO]:Interrupt type mask for Port 0 : 0x100000
0000051788:[0][INF][GPIO]:Both edge mask for Port 0 : 0x100000
0000051813:[0][INF][GPIO]:Polarity mask for Port 0 : 0x100000
0000051839:[0][INF][GPIO]:Interrupt enable mask for Port 0 : 0x100000
0000051865:[0][INF][GPIO]:Interrupt handled and flag set to: 1
0000052683:[0][INF][GPIO]:Testing GPIO port interrupt config: success
0000052718:[0][INF][GPIO]:GPIO Sample App Completed!