nuttx-apps/examples/fdpicxip/modules/user.c
Marco Casaroli 859c014d4d examples/fdpicxip: Demonstrate FDPIC modules executed in place.
The FDPIC counterpart of examples/nxflatxip, kept separate from it: that
example is about NXFLAT, and mixing the two module formats into one program
would leave neither demonstrating anything clearly.

Four subcommands, each showing one property of the loader.  'qsort' is the
simplest case it has -- one self-contained module, two concurrent instances,
one shared copy of the text in flash and a private copy of the data each,
with the pin count showing the extent held in place while they run and
released after.  'solib' adds a shared library, so two objects are mapped
and each instance still gets its own copy of both objects' data.  'cxx' is
the same in C++, which additionally requires global constructors to have run
in dependency order before main.  'jmprel' is a module whose imports are all
in DT_JMPREL rather than DT_REL.

The modules are embedded as headers rather than built as part of the app:
linking one needs arm-uclinuxfdpiceabi binutils, which the tree does not
require, so the headers are committed and both this example and
testing/fs/xipfs build with a plain toolchain.

Their sources are in modules/, with a makefile that rebuilds every header
from them on an explicit 'make regen NUTTX_DIR=...' and is never invoked by
the application build.  It drives nuttx/tools/fdpic and writes the headers
this example needs alongside the ones testing/fs/xipfs needs, so one source
tree serves both and the two cannot drift apart.  CPU is cortex-m3 there
deliberately: a v7-M module runs on the v8-M targets too, so one set of blobs
serves both the RP2350 and mps2-an500, while a cortex-m33 build produces
blobs the Cortex-M7 cannot execute at all.

This demonstrates; it does not assert.  The assertions are in the fdpic and
reject sections of apps/testing/fs/xipfs.

Verified on a Pimoroni Pico Plus 2: all four subcommands, and nxflatxip
unaffected alongside them.  Also verified on mps2-an500 under QEMU, which is
a Cortex-M7 -- a different core generation from the RP2350's Cortex-M33.

Assisted-by: Claude Code:claude-opus-5
Signed-off-by: Marco Casaroli <marco.casaroli@gmail.com>
2026-07-31 18:47:17 -03:00

68 lines
2.5 KiB
C

/****************************************************************************
* apps/examples/fdpicxip/modules/user.c
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you 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.
*
****************************************************************************/
/* Uses libcounter.so. Two instances run concurrently: if the library's
* data were shared between them the totals would interleave.
*
* libcounter is also a *leaf* library -- it calls nothing outside itself,
* so it has no PLT and therefore no DT_PLTGOT. The loader has to fall back
* to PT_DYNAMIC vaddr + memsz to find its GOT. If that fallback is wrong
* the library cannot reach its own globals, which is exactly what the total
* below would expose.
*/
/****************************************************************************
* Included Files
****************************************************************************/
#include <stdlib.h>
#include <syslog.h>
#include <unistd.h>
/****************************************************************************
* Public Functions
****************************************************************************/
extern int counter_bump(int by);
extern int counter_total(void);
int main(int argc, char *argv[])
{
int seed = (argc > 1) ? atoi(argv[1]) : 0;
int i;
for (i = 0; i < 3; i++)
{
counter_bump(seed);
usleep(100000);
}
syslog(LOG_INFO, "[user %d] library total = %d (expected %d) -- %s\n",
seed, counter_total(), seed * 3,
counter_total() == seed * 3 ? "PASS" : "FAIL");
/* Reported through the exit status as well as the log, so a test can
* assert on it rather than a human reading the console.
*/
return counter_total() == seed * 3 ? EXIT_SUCCESS : EXIT_FAILURE;
}