sim/ft2232h: Add FT2232H GPIO integration on NuttX sim by acassis · Pull Request #18951 · apache/nuttx

acassis · 2026-05-24T19:57:21Z

Summary

This driver implements a FT2232H GPIO integration NuttX sim to allow users to read/write external GPIOs and control external devices.
It will help to control external devices using NuttX sim.

The next steps will be adding SPI and I2C integration support.

Impact

User will be able to use a FT2232H module to read/write external GPIO

Testing

nsh> ls /dev
/dev:
console
gpio60
gpio61
gpio62
gpio63
gpio64
gpio65
gpio66
gpio67
loop
null
oneshot
ram0
ram1
ram2
zero

nsh> gpio /dev/gpio60
Driver: /dev/gpio60
gplh_read: pin0: value=0x7fa69b5d4117
Output pin: Value=0

nsh> gpio /dev/gpio60
Driver: /dev/gpio60
gplh_read: pin0: value=0x7fa69b5d4117
Output pin: Value=1

nsh> gpio -o 1 /dev/gpio67
Driver: /dev/gpio67
gplh_read: pin7: value=0x7fa69b5d4117
Output pin: Value=0
Writing: Value=1
gplh_write: pin7: value=1
gplh_read: pin7: value=0x7fa69b5d4117
Verify: Value=1

nsh> gpio -o 0 /dev/gpio67
Driver: /dev/gpio67
gplh_read: pin7: value=0x7fa69b5d4117
Output pin: Value=1
Writing: Value=0
gplh_write: pin7: value=0
gplh_read: pin7: value=0x7fa69b5d4117
Verify: Value=1
nsh>

acassis · 2026-05-24T21:11:01Z

@simbit18 is it possible to install libftdio-dev to get FT2232H integration passing on CI?

No package 'libftdi1' found
./sim/posix/sim_ft2232h.c:40:10: fatal error: ftdi.h: No such file or directory
   40 | #include <ftdi.h>
      |          ^~~~~~~~
compilation terminated.
ERROR: cc failed: 1
       command: cc -MT ./sim_ft2232h.o  -M '-g' '-fomit-frame-pointer' '-fprofile-arcs' '-ftest-coverage' '-fno-inline' '-fno-common' '-fvisibility=hidden' '-ffunction-sections' '-fdata-sections' '-Wall' '-Wstrict-prototypes' '-Wshadow' '-Wundef' '-Wno-attributes' '-Wno-unknown-pragmas' '-fno-pic' '-mcmodel=medium' '-no-pie' '-D__KERNEL__' '-Wno-cpp' '-Werror' '-D__SIM__' '-fvisibility=default' '-I' '/github/workspace/sources/nuttx/arch/sim/src' '-I' '/github/workspace/sources/nuttx/arch/sim/src/chip' ./sim/posix/sim_ft2232h.c
make[2]: *** [Makefile:546: sim_ft2232h.ddh] Error 1

This commit is needed to get PR #18951 passing on CI test. I think this USB Device could be used in the future to do real hardware tests, including automated tests on our CI. Signed-off-by: Alan C. Assis <acassis@gmail.com>

acassis · 2026-06-14T14:21:48Z

@xiaoxiang781216 PTAL

This patch adds support to use FT2232H as GPIO to control external devices. Signed-off-by: Alan C. Assis <acassis@gmail.com>

This commit add documentation to explain about the FT2232H integration on NuttX. Signed-off-by: Alan C. Assis <acassis@gmail.com>

This board profile configure the FT2232H module to use as a GPIO to NuttX sim. Signed-off-by: Alan C. Assis <acassis@gmail.com>

xiaoxiang781216 · 2026-06-15T12:15:25Z

+  uint8_t port_value;
+};
+
+#define gpioerr(fmt, ...) \


move to preprocess section

xiaoxiang781216 · 2026-06-15T12:16:10Z

@@ -45,6 +45,18 @@
 * Pre-processor Definitions
 ****************************************************************************/

+/****************************************************************************


move after line 67 and remove the dup banner

Thank you @xiaoxiang781216
The banners are not duplicated: Type Definitions and Private Types

I think we could remove all those Private * since they are not used

The banners are not duplicated: Type Definitions and Private Types.

If you want I can remove those Privates* since they are empty.

acassis · 2026-06-15T12:45:44Z

I will add this board config to the blacklist, even after installing the libftdi1-dev in the docker image the CI still failing to find it:

====================================================================================
Configuration/Tool: sim/ft2232h_gpio
2026-06-15 12:08:43

Cleaning...
Configuring...
Building NuttX...
Package libftdi1 was not found in the pkg-config search path.
Perhaps you should add the directory containing libftdi1.pc' to the PKG_CONFIG_PATH environment variable No package 'libftdi1' found Package libftdi1 was not found in the pkg-config search path. Perhaps you should add the directory containing libftdi1.pc'
to the PKG_CONFIG_PATH environment variable
No package 'libftdi1' found
Package libftdi1 was not found in the pkg-config search path.
Perhaps you should add the directory containing libftdi1.pc' to the PKG_CONFIG_PATH environment variable No package 'libftdi1' found Package libftdi1 was not found in the pkg-config search path. Perhaps you should add the directory containing libftdi1.pc'
to the PKG_CONFIG_PATH environment variable
No package 'libftdi1' found
Package libftdi1 was not found in the pkg-config search path.
Perhaps you should add the directory containing libftdi1.pc' to the PKG_CONFIG_PATH environment variable No package 'libftdi1' found Package libftdi1 was not found in the pkg-config search path. Perhaps you should add the directory containing libftdi1.pc'
to the PKG_CONFIG_PATH environment variable
No package 'libftdi1' found
Package libftdi1 was not found in the pkg-config search path.
Perhaps you should add the directory containing libftdi1.pc' to the PKG_CONFIG_PATH environment variable No package 'libftdi1' found Package libftdi1 was not found in the pkg-config search path. Perhaps you should add the directory containing libftdi1.pc'
to the PKG_CONFIG_PATH environment variable
No package 'libftdi1' found
Package libftdi1 was not found in the pkg-config search path.
Perhaps you should add the directory containing `libftdi1.pc'
to the PKG_CONFIG_PATH environment variable
No package 'libftdi1' found
./sim/posix/sim_ftdi_gpiochip.c:40:10: fatal error: ftdi.h: No such file or directory
40 | #include <ftdi.h>
| ^~~~~~~~
compilation terminated.
ERROR: cc failed: 1
command: cc -MT ./sim_ftdi_gpiochip.o -M '-g' '-fomit-frame-pointer' '-fprofile-arcs' '-ftest-coverage' '-fno-inline' '-fno-common' '-fvisibility=hidden' '-ffunction-sections' '-fdata-sections' '-Wall' '-Wstrict-prototypes' '-Wshadow' '-Wundef' '-Wno-attributes' '-Wno-unknown-pragmas' '-fno-pic' '-mcmodel=medium' '-no-pie' '-D__KERNEL__' '-Wno-cpp' '-Werror' '-D__SIM__' '-fvisibility=default' '-I' '/github/workspace/sources/nuttx/arch/sim/src' '-I' '/github/workspace/sources/nuttx/arch/sim/src/chip' ./sim/posix/sim_ftdi_gpiochip.c
make[2]: *** [Makefile:546: sim_ftdi_gpiochip.ddh] Error 1
make[2]: Target 'makedepfile' not remade because of errors.
make[1]: *** [Makefile:554: .depend] Error 2
make[1]: Target 'depend' not remade because of errors.
make: *** [tools/Unix.mk:679: pass2dep] Error 2
make: Target 'all' not remade because of errors.
/github/workspace/sources/nuttx/tools/testbuild.sh: line 397: /github/workspace/sources/nuttx/../nuttx/nuttx.manifest: No such file or directory
[1/1] Normalize sim/ft2232h_gpio
HEAD detached at pull/18951/merge
Untracked files:
(use "git add ..." to include in what will be committed)
arch/sim/src/sim_errno.ddh
arch/sim/src/sim_ftdi_gpiochip.ddh
arch/sim/src/sim_hostfs.ddh
arch/sim/src/sim_hostirq.ddh
arch/sim/src/sim_hostmemory.ddh
arch/sim/src/sim_hostmisc.ddh
arch/sim/src/sim_hostsmp.ddh
arch/sim/src/sim_hosttime.ddh
arch/sim/src/sim_hostuart.ddh

nothing added to commit but untracked files present (use "git add" to track)
/github/workspace/sources/nuttx /github/workspace/sources/nuttx
HEAD detached at pull/18951/merge
nothing to commit, working tree clean
/github/workspace/sources/nuttx
/github/workspace/sources/apps /github/workspace/sources/nuttx
On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean
/github/workspace/sources/nuttx
Build Attempt 1 of 1

acassis requested review from Donny9, GUIDINGLI, jerpelea, raiden00pl and xiaoxiang781216 as code owners May 24, 2026 19:57

github-actions Bot added Area: Documentation Improvements or additions to documentation Arch: simulator Issues related to the SIMulator Size: XL The size of the change in this PR is very large. Consider breaking down the PR into smaller pieces. Board: simulator labels May 24, 2026

linguini1 previously approved these changes May 24, 2026

View reviewed changes

Comment thread Documentation/platforms/sim/sim_ft2232h_gpio.rst Outdated

Comment thread Documentation/platforms/sim/sim_ft2232h_gpio.rst Outdated

acassis dismissed linguini1’s stale review via 1e68630 May 24, 2026 20:12

acassis force-pushed the sim_ft2232h branch 2 times, most recently from 1e68630 to 0c68d8c Compare May 24, 2026 20:23

linguini1 previously approved these changes May 24, 2026

View reviewed changes

xiaoxiang781216 reviewed May 25, 2026

View reviewed changes

Comment thread arch/sim/src/sim/sim_internal.h Outdated

acassis mentioned this pull request May 29, 2026

nuttx/ci: Add libftdi1-dev to get FT2232H working on CI #18995

Merged

acassis dismissed linguini1’s stale review via ee0b0e3 May 29, 2026 21:07

acassis force-pushed the sim_ft2232h branch from 0c68d8c to ee0b0e3 Compare May 29, 2026 21:07

xiaoxiang781216 reviewed May 30, 2026

View reviewed changes

Comment thread arch/sim/Kconfig Outdated

Comment thread arch/sim/Kconfig Outdated

Comment thread arch/sim/src/sim/sim_ft2232h_ioexpander.h Outdated

xiaoxiang781216 reviewed May 30, 2026

View reviewed changes

Comment thread arch/sim/src/sim/posix/sim_ft2232h.c Outdated

acassis force-pushed the sim_ft2232h branch 2 times, most recently from 2b03469 to 7db2a5e Compare June 14, 2026 14:20

acassis force-pushed the sim_ft2232h branch from 7db2a5e to 6c1c27a Compare June 14, 2026 14:34

acassis requested review from btashton, tmedicci and yamt as code owners June 14, 2026 14:34

acassis force-pushed the sim_ft2232h branch from 6c1c27a to b75a37f Compare June 14, 2026 14:53

xiaoxiang781216 reviewed Jun 14, 2026

View reviewed changes

acassis force-pushed the sim_ft2232h branch from b75a37f to 8681167 Compare June 14, 2026 19:08

github-actions Bot added Size: M The size of the change in this PR is medium and removed Size: XL The size of the change in this PR is very large. Consider breaking down the PR into smaller pieces. labels Jun 14, 2026

acassis force-pushed the sim_ft2232h branch from 8681167 to 39db138 Compare June 14, 2026 20:36

github-actions Bot added Size: L The size of the change in this PR is large and removed Size: M The size of the change in this PR is medium labels Jun 14, 2026

xiaoxiang781216 reviewed Jun 15, 2026

View reviewed changes

acassis added 3 commits June 15, 2026 08:51

arch/sim: Add support to FTDI FT2232H as GPIO bridge

8f3a42e

This patch adds support to use FT2232H as GPIO to control external devices. Signed-off-by: Alan C. Assis <acassis@gmail.com>

doc/sim: Add documentation about FT2232H GPIO integration

4104b2a

This commit add documentation to explain about the FT2232H integration on NuttX. Signed-off-by: Alan C. Assis <acassis@gmail.com>

boards/sim: Add FT2232H GPIO board support

e83947a

This board profile configure the FT2232H module to use as a GPIO to NuttX sim. Signed-off-by: Alan C. Assis <acassis@gmail.com>

acassis force-pushed the sim_ft2232h branch from 39db138 to e83947a Compare June 15, 2026 11:51

xiaoxiang781216 reviewed Jun 15, 2026

View reviewed changes

Conversation

acassis commented May 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Impact

Testing

Uh oh!

Uh oh!

Uh oh!

acassis commented May 24, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

acassis commented Jun 14, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

xiaoxiang781216 Jun 15, 2026

Choose a reason for hiding this comment

Uh oh!

xiaoxiang781216 Jun 15, 2026

Choose a reason for hiding this comment

Uh oh!

acassis Jun 15, 2026

Choose a reason for hiding this comment

Uh oh!

acassis Jun 15, 2026

Choose a reason for hiding this comment

Uh oh!

acassis commented Jun 15, 2026

==================================================================================== Configuration/Tool: sim/ft2232h_gpio 2026-06-15 12:08:43

nothing to commit, working tree clean /github/workspace/sources/nuttx Build Attempt 1 of 1

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

acassis commented May 24, 2026 •

edited

Loading

====================================================================================
Configuration/Tool: sim/ft2232h_gpio
2026-06-15 12:08:43

nothing to commit, working tree clean
/github/workspace/sources/nuttx
Build Attempt 1 of 1