Habilite el uso de herramientas modernas de análisis de código en código c / c ++ incrustado antiguo

Cómo utilizar herramientas modernas de análisis de código, como SourceTrail en código fuente c / c ++ incrustado antiguo, originalmente para compiladores como Hi-Tech C, PIC C, IAR Workbench para una serie de microcontroladores no solo limitados a PIC, PIC16, y la serie PIC18 de Microchip.

Para admitir las arquitecturas limitadas de los pequeños microcontroladores, los proveedores de los compiladores integrados han tenido que crear extensiones para el lenguaje c / c ++, que estaban (o no están todavía) en las especificaciones del lenguaje c.

Esto da como resultado los archivos de encabezado específicos del microcontrolador que contienen cosas como esta:

// Register: ANSELA
extern volatile unsigned char           ANSELA              @ 0xF38;
#ifndef _LIB_BUILD
asm("ANSELA equ 0F38h");
#endif

typedef union {
    struct {
        unsigned ANSB0                  :1;
        unsigned ANSB1                  :1;
        unsigned ANSB2                  :1;
        unsigned ANSB3                  :1;
        unsigned ANSB4                  :1;
        unsigned ANSB5                  :1;
    };
} ANSELBbits_t;
extern volatile ANSELBbits_t ANSELBbits @ 0xF39;

extern volatile unsigned short long     TBLPTR              @ 0xFF6;

extern volatile __bit                   ABDEN1              @ (((unsigned) &BAUDCON1)*8) + 0;

y los archivos de código incluyen cosas como esta:

void interrupt high_priority InterruptVectorHigh(void) 
{
}

void interrupt low_priority InterruptVectorLow(void)
{
}

¿Cuál es el método más sencillo para respaldar esta fuente con herramientas modernas, mientras se asegura que la fuente aún se pueda usar con los compiladores originales?

Editar:

A continuación se proporciona una respuesta.

La siguiente solución permitirá que cualquier compilador que admita las especificaciones C18 o C2x comprenda el código c. No he tenido (todavía) la oportunidad de probar con c ++, por lo que es posible que no cumplan completamente con ninguna de las especificaciones de C ++.

Gracias a personas como @Antti Haapala, @Clifford y @anastaciu que respondieron a mis preguntas relacionadas aquí y aquí y permitieron esta respuesta más completa.

El short longtipo

Primero, el tipo de 24 bits short longfue un problema, ya que no existe equivalente en las especificaciones c, y porque las dos palabras del tipo no se pueden direccionar con a #define. Al principio, usé Perl para simplemente modificar la cadena short longen longtodos los archivos de encabezado específicos del proveedor como este:

perl -pi -e "s/(short long)/long/g" .h

Tenga en cuenta que para el compilador Microchip MPLAB CX8 en Windows, los archivos de encabezado se encuentran en la siguiente carpeta y subcarpetas: c: \ Archivos de programa (x86) \ Microchip \ xc8 \ v1.33 \ include

Pero luego me di cuenta de que el shorttipo nunca se usa por sí solo, así que decidí simplemente eliminar la shortparte usando un #define short. Tenga en cuenta que esto afectará cualquier uso, shortasí que dejé ambos métodos en esta respuesta.

Las direcciones de bit y byte de registro definidas con @

Los signos @ eran un problema específico, ya que no se podían redefinir usando #define, así que perl al rescate nuevamente, esta vez usando dos pases para abordar las dos sintaxis diferentes:

perl -pi -e "s/@\s*([0-9a-fA-FxX]+)/AT($1)/g" .h perl -pi -e "s/[@] ?+([^;]*)/AT($1)/g" .h

Estos envuelven esencialmente nada después de una @en AT(), lo que permite una normal de definen para operar en él.

Las palabras clave extra

El toque final es insertar un encabezado de macro en cada uno de los archivos de encabezado proporcionados por el proveedor del compilador. Terminé con el siguiente encabezado de macro:

// Hack to allow SourceTrail to be used on this source
#if defined __XC8
  #define AT(address) @ address
#else
  #define AT(address)
  #define __bit _Bool
  #define asm(assembly)
  #define interrupt
  #define short
  #define high_priority
  #define low_priority
#endif

Como puede verse, todo lo que no sea estándar simplemente se elimina, excepto cuando el compilador MPLAB XC8 utiliza los archivos de encabezado. La única excepción es el __bittipo, que se redefine como _Booltipo; parece funcionar.

La solución completa como un script por lotes para ejecutar en Windows

Como estoy ejecutando todo esto en Windows, las frases sencillas de Perl no funcionan realmente como en Linux, por lo que para procesar todos y cada uno de los archivos de encabezado, tuve que envolver el comando Perl en un ciclo for-loop por lotes, que es bastante lento. Para compensarlo, combiné todo en un solo lote llamado fix.cmd, que se coloca en la carpeta de inclusión (ver ruta arriba):

:: Fix to allow SourceTrail to analyze MPLAB CX8 source code.
@echo off
setlocal enabledelayedexpansion

:: Run in the folder where the script exists.
pushd "%~dp0"

echo:Fixing MPLAB global include files to be used by SourceTrail and other analysis tools.

:: Loop each directory recrusively
set DirCounter=0
set FileCounter=0
for /r %%d in (.) do (
    set /A DirCounter=DirCounter+1
    pushd %%d
    echo | set /p=Processing:
    cd
    
    for %%f in (*.h) do (
        set /A FileCounter=FileCounter+1
        set /A ModValue=FileCounter%%25
        if !ModValue!==0 ( echo | set /p=* )
        call :ProcessFile %%f
    )
    
    popd
    echo *
)
echo:Processed %FileCounter% files in %DirCounter% folders.
echo Done   
exit /b 0


:ProcessFile
:: filename is in %1
    
:: Remove short from short long. (Done with a define instead)
::  perl -pi -e "s/(short long)/long/g" %1

:: Replace the simple @ lines with AT().
    perl -pi -e "s/@\s*([0-9a-fA-FxX]+)/AT($1)/g" %1 :: Exchange @ and wrap in parenthesis for any substring starting with @ and ending with ; in each header file. perl -pi -e "s/[@] ?+([^;]*)/AT($1)/g" %1

:: Insert defines before first line in each header files:
    perl -pi -e "print \"// Hack to allow SourceTrail to be used on this source\n#if defined __XC8\n  #define AT(address) @ address\n#else\n  #define AT(address)\n  #define __bit _Bool\n  #define asm(assembly)\n  #define interrupt\n  #define short\n#define high_priority\n  #define low_priority\n#endif\n\n\" if $. == 1" %1

::Exit subroutine   
exit /b

Para realizar la modificación, abra un indicador elevado, cd a los archivos de inclusión y ejecute el fix.cmd

prerrequisitos

Perl debe estar instalado en la computadora con Windows. Yo uso StrawberryPerl

Editar: En su mayoría errores tipográficos arreglados. Aclaró que hay dos opciones sobre cómo lidiar con elshort long