mirror of
https://github.com/logicog/RTLPlayground.git
synced 2026-10-29 17:54:14 +08:00
d00f
83491bc9e3
Two things kept every register-driven module out of the host harness. The SFR keywords were unknown, so rtl837x_sfr.h did not compile at all, and once it did, each translation unit would have defined its own copy of the registers. They map to extern declarations now; a mock emits the storage once by re-including the header with the keywords redefined. The other was memset. rtl837x_common.h hides the firmware's own prototypes under RTLP_HOST_TEST so host builds use the C library, but nothing declared the library versions, and the modules do call them. The shim pulls in string.h ahead of everything, where nothing can clash with it.
57 lines
2.2 KiB
C
57 lines
2.2 KiB
C
/*
|
|
* sdcc_shim.h — neutralize SDCC 8051 keywords so firmware translation units
|
|
* compile under host gcc/clang for off-target unit testing.
|
|
*
|
|
* Force-included (gcc -include) ahead of every firmware source under test.
|
|
* It only erases storage/qualifier keywords and the banked-call attribute;
|
|
* it does NOT change any logic, so the code under test is byte-for-byte the
|
|
* firmware source. Hardware/register access is provided by mocks (support.c),
|
|
* never by this file.
|
|
*/
|
|
#ifndef SDCC_SHIM_H
|
|
#define SDCC_SHIM_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
/* Memory-space qualifiers → nothing (host has one flat address space). */
|
|
#define __xdata
|
|
#define __code
|
|
#define __pdata
|
|
#define __idata
|
|
#define __data
|
|
/* bool, not unsigned char: SDCC's bit types normalize any assigned value
|
|
* to 0/1, which _Bool reproduces exactly. */
|
|
#define __bit bool
|
|
|
|
/* Special-function registers are declared in rtl837x_sfr.h as
|
|
* `__sfr __at(0xNN) NAME;`. With __at erased those become plain declarations,
|
|
* so they must carry extern or every translation unit including the header
|
|
* defines its own copy. __sbit is the bit-in-an-SFR form and only appears
|
|
* there; the local bit variable keyword is __bit above. test/hw_mock.c
|
|
* undefines these four and re-includes the header once to emit the storage. */
|
|
#define __sfr extern volatile uint8_t
|
|
#define __sfr16 extern volatile uint16_t
|
|
#define __sfr32 extern volatile uint32_t
|
|
#define __sbit extern bool
|
|
|
|
/* The firmware ships its own memcpy/memset/strlen/strcpy/sleep, and
|
|
* rtl837x_common.h hides those prototypes under RTLP_HOST_TEST so host builds
|
|
* take the C library versions. Something has to declare them, and firmware
|
|
* sources do call memset and memcpy; this header is force-included ahead of
|
|
* everything, so pulling <string.h> in here puts the libc versions in scope
|
|
* before any firmware header and nothing clashes. sleep() is not in
|
|
* <string.h> and is declared on its own rather than through <unistd.h>. */
|
|
#include <string.h>
|
|
extern unsigned int sleep(unsigned int seconds);
|
|
|
|
/* Function attributes → nothing (no banking / no 8051 calling conventions). */
|
|
#define __banked
|
|
#define __reentrant
|
|
#define __naked
|
|
#define __using(n)
|
|
#define __interrupt(n)
|
|
#define __at(addr)
|
|
|
|
#endif /* SDCC_SHIM_H */
|