ccs报错errors encountered during linking应该怎么办

Question

ccs报错errors encountered during linking这是为什么？应该怎么改？

Answer 1

引自免费微信小程序：皆我百晓生

在CCS（Code Composer Studio）中，编译器会检查项目中的代码以确定哪些库被引用，以及它们之间的依赖关系。通常，C/C++编译器在执行ld指令时会产生链接错误，其中最常见的错误是重复定义了已存在于多个源文件中但变量名相同的符号。下面是一些可能的解决方法：

1. 确认符号重命名：

   • 首先，你需要确保所有的库都正确地添加到了你的项目的cmake目录下，且包含在了.libs或.lib文件夹中。
   • 打开你的源文件main.c，查看你在#include <led>前面已经声明过的变量。如果有相同名称的变量或函数已经被定义过，ld将根据这些变量的值对符号进行重新命名。
   • 例如，在以下代码段中，led显示器被声明了两个变量ledDisplay1和ledDisplay2，然后在同一行被声明了它们的别名ledDevice1和ledDevice2。这两个变量可能会导致链接错误，因为它们都被分配了相同的命名空间和位置。

   LED_Joy(LED_Init, ledDisplay1, ledDevice1);
   LED_Joy(LED_Init, ledDisplay2, ledDevice2);
   

   修改上述代码为以下版本，其中每个ledDevice变量都包含一个新的独立名称：

   LED_BuzzerLED(LED_Init, ledDevice1);
   LED_BuzzerLED(LED_Init, ledDevice2);
   LED_Pin哌(PIN_Init, ledDevice1);
   LED_Pin哌(PIN_Init, ledDevice2);
   

   这样，ld在识别并处理你的代码时就会正确地忽略重命名的问题，并重新引入了每个库对应的新符号。

2. 手动调整符号引用： 如果你不希望改变全局或特定模块的符号引用，可以手动修改每个库的extern宏定义，以便只引入一个对应的符号。例如，如果你只有一个包含LED_brightness常量的源文件，你可以在该文件开头添加以下宏声明，避免外部库定义LED_brightness：

   #define LED_brightness LED亮度
   

   在其他源文件中，只需导入这个宏：

   extern const int LED_brightness;
   

3. 清理冲突的符号： 如果某个库引用了一个变量的别名但其实际变量名与库提供的符号不同，可以使用nm命令进行清理。例如，假设我们有一个名为led_display的库，并在这个库的源文件中定义了一个名为led_device的变量，但在其他库（如led_buzzer）中引用了led_device作为别名：

   extern int led_device;
   

   在led_buzzer库中，我们可以利用nm命令找到这个变量，并删除它及其别名以消除符号冲突：

   nm -C led_buzzer /usr/local/lib/led_buzzer.a led_device
   

   在输出中查找匹配的项，移除其别名：

   led_device -> led_device
   

   现在，led_device的变量指向了与led_buzzer库相关联的公共定义，而不会导致ld错误。通过这种方式，你就可以保证在不同的库中正确地引用同一个变量。

4. 创建复用符号： 可以尝试创建共享的符号或组合，这样可以减少库间相互引用的冲突。在GDB（GNU Debugger）中，你可以使用gadd命令将具有相同名称的变量添加到一个 .def 文件中。例如，假设你有两个库，led_led和led_buzzer，他们分别包含led_device变量：

   LED木质LED亮(led_led木质LED亮)
   LED金属LED亮(led_led金属LED亮)
   LED红色LED亮(led_led_redLED亮)
   

   要在led_led木质LED亮.gdef中定义共享的led_device变量，你可以这样做：

   module led_led木质LED亮 {
       # Define a shared variable that will hold the LED device name
       var led_device = "木质LED亮";
   
       // Define a function to set the LED device on/off
       function LED木质LED亮_on {
           global led_device;
   
           // ...
       }
   
       // Define a function to set the LED device brightness
       function LED木质LED亮_set_brightness(int brightness) {
           global led_device;
   
           // ...
       }
   }
   

   保存此文件后，可以像这样调用LED木质LED亮.on()函数设置LED设备为开启状态：

   led木质LED亮.on();
   

   或者，如果你想让LED木质LED亮.set_brightness()函数也适用于所有led_led木质LED亮库的实例，可以将定义转移至相应的库文件：

   module led_led木质LED亮 {
       # ...
   
       // Declare a function to set the LED device brightness for all LED_led木质LED亮 instances
       function LED木质LED亮_set_brightness_for_all() {
           # ...
   
           // ...
       }
   }
   

5. 增强代码可维护性： 在编写模块化代码时，尽可能保持各个库仅实现与其相关的功能，并避免直接嵌套或引用彼此的代码。这有助于确保在更改库后，其他库中所需的变量名称没有冲突，并且可以轻松地更新整个系统。例如，你可以在led_buzzer木质LED亮库中实现通用的LED设备驱动，而只在led_led木质LED亮库中提供细节：

   module led_buzzer木质LED亮 {
       // ...
       # Define the LED device driver for this library
       driver led_buzzer木质LED亮_driver {
           # ...
   
           // ...
       }
   }
   

   在后续的更新中，只需要修改led_buzzer木质LED亮.driver.LED_device_driver，而不是覆盖整个led_buzzer木质LED亮库的源文件。

注意，为了彻底解决CCS编译器产生的链接错误，通常还需要考虑到其他可能影响符号重命名的因素，例如库设计不合理、模块间的依赖关系混乱等。在实际开发过程中，可能需要结合多种技术手段，包括但不限于手动修改符号引用、重构代码结构、优化库内部数据结构等方式来解决这个问题。在某些情况下，可能需要重新考虑使用哪种库或工具，并进行更细致的调试和测试，直到找到最符合需求的解决方案。