feat: add static method to retrieve Hamlib version information

Author: boybook

index.d.ts

@@ -265,6 +265,17 @@ declare class HamLib {
    */
   static getSupportedRigs(): SupportedRigInfo[];
 
+  /**
+   * Get Hamlib library version information
+   * @returns Hamlib version string including version number, build date, and architecture
+   * @static
+   * @example
+   * const version = HamLib.getHamlibVersion();
+   * console.log(`Hamlib version: ${version}`);
+   * // Output: "Hamlib 4.5.5 2024-01-15 12:00:00 64-bit"
+   */
+  static getHamlibVersion(): string;
+
   /**
    * Open connection to device
    * Must be called before other operations

lib/index.js

@@ -30,6 +30,15 @@ class HamLib {
     return nativeModule.HamLib.getSupportedRigs();
   }
 
+  /**
+   * Get Hamlib library version information
+   * @returns {string} Hamlib version string (e.g., "Hamlib 4.5.5 2024-01-15 12:00:00 64-bit")
+   * @static
+   */
+  static getHamlibVersion() {
+    return nativeModule.HamLib.getHamlibVersion();
+  }
+
   /**
    * Open connection to the radio device
    * Must be called before other operations

src/hamlib.cpp

@@ -3720,9 +3720,10 @@ Napi::Function NodeHamLib::GetClass(Napi::Env env) {
       NodeHamLib::InstanceMethod("close", & NodeHamLib::Close),
       NodeHamLib::InstanceMethod("destroy", & NodeHamLib::Destroy),
       NodeHamLib::InstanceMethod("getConnectionInfo", & NodeHamLib::GetConnectionInfo),
-      
-      // Static method to get supported rig models
+
+      // Static methods
       NodeHamLib::StaticMethod("getSupportedRigs", & NodeHamLib::GetSupportedRigs),
+      NodeHamLib::StaticMethod("getHamlibVersion", & NodeHamLib::GetHamlibVersion),
     });
       constructor = Napi::Persistent(ret);
       constructor.SuppressDestruct();
@@ -3832,6 +3833,16 @@ Napi::Value NodeHamLib::GetSupportedRigs(const Napi::CallbackInfo& info) {
   return rigArray;
 }
 
+// Get Hamlib version information
+Napi::Value NodeHamLib::GetHamlibVersion(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+
+  // Reference to external hamlib_version2 variable
+  extern const char* hamlib_version2;
+
+  return Napi::String::New(env, hamlib_version2);
+}
+
 // Serial Port Configuration Methods
 
 // Set serial configuration parameter (data_bits, stop_bits, parity, handshake, etc.)

src/hamlib.h

@@ -164,7 +164,10 @@ class NodeHamLib : public Napi::ObjectWrap<NodeHamLib> {
 
   // Static method to get supported rig models
   static Napi::Value GetSupportedRigs(const Napi::CallbackInfo&);
-  
+
+  // Static method to get Hamlib version
+  static Napi::Value GetHamlibVersion(const Napi::CallbackInfo&);
+
   static Napi::Function GetClass(Napi::Env);
 
   static int freq_change_cb(RIG*, vfo_t, freq_t, void*);

test/test_loader.js

@@ -7,6 +7,15 @@ const { HamLib } = require('../index.js');
 
 console.log('🧪 测试node-hamlib模块加载和基础功能...\n');
 
+// 输出Hamlib版本信息
+try {
+  const hamlibVersion = HamLib.getHamlibVersion();
+  console.log('📌 Hamlib版本信息:');
+  console.log(`   ${hamlibVersion}\n`);
+} catch (e) {
+  console.log('⚠️  无法获取Hamlib版本信息:', e.message, '\n');
+}
+
 let testsPassed = 0;
 let testsFailed = 0;
 
@@ -34,8 +43,9 @@ try {
 
   // 2. 静态方法测试
   console.log('\n📊 静态方法测试:');
+  test('getHamlibVersion静态方法存在', () => typeof HamLib.getHamlibVersion === 'function');
   test('getSupportedRigs静态方法存在', () => typeof HamLib.getSupportedRigs === 'function');
-  
+
   try {
     const supportedRigs = HamLib.getSupportedRigs();
     test('getSupportedRigs返回数组', () => Array.isArray(supportedRigs));
@@ -46,6 +56,27 @@ try {
       return first.rigModel && first.modelName && first.mfgName;
     });
     console.log(`   📈 找到 ${supportedRigs.length} 个支持的电台型号`);
+
+    // 打印所有支持的设备型号
+    console.log('\n📻 所有支持的设备型号:');
+    console.log('   ────────────────────────────────────────────────────────────────');
+    console.log('   型号ID  | 制造商              | 型号名称                    | 状态');
+    console.log('   ────────────────────────────────────────────────────────────────');
+    supportedRigs.forEach((rig, index) => {
+      const model = String(rig.rigModel).padEnd(7);
+      const mfg = (rig.mfgName || '').substring(0, 20).padEnd(20);
+      const name = (rig.modelName || '').substring(0, 28).padEnd(28);
+      const status = rig.status || '';
+      console.log(`   ${model} | ${mfg} | ${name} | ${status}`);
+
+      // 每50行输出一个分隔符，便于阅读
+      if ((index + 1) % 50 === 0 && index + 1 < supportedRigs.length) {
+        console.log('   ────────────────────────────────────────────────────────────────');
+      }
+    });
+    console.log('   ────────────────────────────────────────────────────────────────');
+    console.log(`   共计: ${supportedRigs.length} 个型号\n`);
+
   } catch (e) {
     console.log(`❌ getSupportedRigs调用失败: ${e.message}`);
     testsFailed++;
@@ -92,9 +123,9 @@ try {
   const totalMethods = instanceMethods.length + staticMethods.length;
 
   test(`实例方法数量正确 (80个)`, () => instanceMethods.length === 80);
-  test(`静态方法数量正确 (1个)`, () => staticMethods.length === 1);
-  test(`总方法数量正确 (81个)`, () => totalMethods === 81);
-  
+  test(`静态方法数量正确 (2个)`, () => staticMethods.length === 2);
+  test(`总方法数量正确 (82个)`, () => totalMethods === 82);
+
   console.log(`   📊 实例方法: ${instanceMethods.length}个`);
   console.log(`   📊 静态方法: ${staticMethods.length}个`);
   console.log(`   📊 总计: ${totalMethods}个方法`);