hamlib 0.1.6 → 0.1.7

package/README.md

@@ -0,0 +1,273 @@
+# node-hamlib
+
+Control amateur radio transceivers from Node.js using the [Hamlib](https://hamlib.github.io/) library.
+
+## Features
+
+- **300+ Supported Radios** - Yaesu, Icom, Kenwood, Elecraft, FlexRadio, and more
+- **Full Async/Promise API** - Non-blocking operations with async/await support
+- **Multiple Connections** - Serial ports, network (rigctld), direct control
+- **TypeScript Ready** - Complete type definitions included
+- **Cross-platform** - Windows, Linux, macOS
+
+## Installation
+
+```bash
+npm install node-hamlib
+```
+
+## Quick Start
+
+```javascript
+const { HamLib } = require('node-hamlib');
+
+async function main() {
+  // Create rig instance (model 1035 = FT-991A)
+  const rig = new HamLib(1035, '/dev/ttyUSB0');
+  
+  await rig.open();
+  
+  // Basic operations
+  await rig.setFrequency(144390000);  // 144.39 MHz
+  await rig.setMode('FM');
+  
+  const freq = await rig.getFrequency();
+  const mode = await rig.getMode();
+  console.log(`${freq/1000000} MHz ${mode.mode}`);
+  
+  await rig.close();
+}
+
+main().catch(console.error);
+```
+
+## API Reference
+
+### Connection
+
+```javascript
+// Find your radio model
+const rigs = HamLib.getSupportedRigs();
+const ft991a = rigs.find(r => r.modelName === 'FT-991A');
+
+// Create connection
+const rig = new HamLib(1035, '/dev/ttyUSB0');  // Serial
+const rig = new HamLib(1035, 'localhost:4532'); // Network (rigctld)
+
+await rig.open();
+await rig.close();
+```
+
+### Basic Control
+
+```javascript
+// Frequency
+await rig.setFrequency(14074000);           // 14.074 MHz
+const freq = await rig.getFrequency();
+
+// Mode
+await rig.setMode('USB');
+const mode = await rig.getMode();
+
+// VFO
+await rig.setVfo('VFO-A');
+const vfo = await rig.getVfo();
+
+// PTT
+await rig.setPtt(true);                     // Transmit
+const isTransmitting = await rig.getPtt();
+
+// Signal
+const strength = await rig.getStrength();
+```
+
+### Memory Channels
+
+```javascript
+// Store channel
+await rig.setMemoryChannel(1, {
+  frequency: 144390000,
+  mode: 'FM',
+  description: 'Local Repeater'
+});
+
+// Recall channel
+const channel = await rig.getMemoryChannel(1);
+await rig.selectMemoryChannel(1);
+```
+
+### Advanced Features
+
+```javascript
+// RIT/XIT offsets
+await rig.setRit(100);               // +100 Hz RIT
+await rig.setXit(-50);               // -50 Hz XIT
+await rig.clearRitXit();             // Clear both
+
+// Scanning
+await rig.startScan('VFO');          // Start VFO scan
+await rig.stopScan();                // Stop scan
+
+// Levels (0.0-1.0)
+await rig.setLevel('AF', 0.7);       // Audio 70%
+await rig.setLevel('RFPOWER', 0.5);  // TX power 50%
+const audioLevel = await rig.getLevel('AF');
+
+// Functions
+await rig.setFunction('NB', true);   // Noise blanker on
+const voxEnabled = await rig.getFunction('VOX');
+
+// Split operation
+await rig.setSplit(true);            // Enable split
+await rig.setSplitFreq(144340000);   // TX frequency
+
+// VFO operations
+await rig.vfoOperation('CPY');       // Copy VFO A to B
+await rig.vfoOperation('TOGGLE');    // Toggle VFO A/B
+```
+
+### Power and Status
+
+```javascript
+// Power control
+await rig.setPowerstat(1);           // Power on (0=off, 1=on, 2=standby)
+const powerStatus = await rig.getPowerstat();
+
+// Carrier detection
+const carrierDetected = await rig.getDcd();  // Signal present?
+
+// Tuning steps
+await rig.setTuningStep(12500);      // 12.5 kHz steps
+const step = await rig.getTuningStep();
+```
+
+### Repeater Operation
+
+```javascript
+// Set repeater shift
+await rig.setRepeaterShift('PLUS');  // '+', '-', or 'NONE'
+const shift = await rig.getRepeaterShift();
+
+// Set offset frequency
+await rig.setRepeaterOffset(600000); // 600 kHz for 2m
+const offset = await rig.getRepeaterOffset();
+```
+
+### Serial Configuration
+
+```javascript
+// Basic serial settings
+await rig.setSerialConfig('data_bits', '8');
+await rig.setSerialConfig('stop_bits', '1');
+await rig.setSerialConfig('serial_parity', 'None');
+
+// PTT/DCD methods
+await rig.setPttType('RIG');         // Use CAT command
+await rig.setDcdType('RIG');         // Use software squelch
+```
+
+## Complete Example
+
+```javascript
+const { HamLib } = require('node-hamlib');
+
+async function repeaterOperation() {
+  const rig = new HamLib(1035, '/dev/ttyUSB0');
+  
+  try {
+    await rig.open();
+    
+    // Set up for 2m repeater
+    await rig.setFrequency(145500000);      // 145.500 MHz
+    await rig.setMode('FM');
+    await rig.setRepeaterShift('MINUS');    // Negative offset
+    await rig.setRepeaterOffset(600000);    // 600 kHz offset
+    await rig.setTuningStep(12500);         // 12.5 kHz steps
+    await rig.setLevel('RFPOWER', 0.5);     // 50% power
+    
+    // Save to memory
+    await rig.setMemoryChannel(1, {
+      frequency: 145500000,
+      mode: 'FM',
+      description: 'W1AW Repeater'
+    });
+    
+    console.log('Setup complete for repeater operation');
+    
+  } catch (error) {
+    console.error('Error:', error.message);
+  } finally {
+    await rig.close();
+  }
+}
+
+repeaterOperation();
+```
+
+## Supported Radios
+
+Over **300 radio models** supported, including:
+
+| Manufacturer | Popular Models |
+|--------------|----------------|
+| **Yaesu** | FT-991A, FT-891, FT-857D, FT-817ND |
+| **Icom** | IC-7300, IC-9700, IC-705, IC-7610 |
+| **Kenwood** | TS-2000, TS-590SG, TS-890S |
+| **Elecraft** | K3, K4, KX3, KX2 |
+| **FlexRadio** | 6300, 6400, 6500, 6600, 6700 |
+
+Find your radio model:
+```javascript
+const rigs = HamLib.getSupportedRigs();
+console.log(rigs.find(r => r.modelName.includes('FT-991')));
+```
+
+## Connection Setup
+
+### Serial Connection
+```bash
+# Linux/macOS
+const rig = new HamLib(1035, '/dev/ttyUSB0');
+
+# Windows
+const rig = new HamLib(1035, 'COM3');
+```
+
+### Network Connection
+```bash
+# Start rigctld daemon
+rigctld -m 1035 -r /dev/ttyUSB0 -t 4532
+
+# Connect from Node.js
+const rig = new HamLib(1035, 'localhost:4532');
+```
+
+## Troubleshooting
+
+### Linux Permissions
+```bash
+sudo usermod -a -G dialout $USER
+# Log out and log back in
+```
+
+### Find Serial Ports
+```bash
+# Linux
+ls /dev/tty*
+
+# macOS  
+ls /dev/cu.*
+
+# Test connection
+rigctl -m 1035 -r /dev/ttyUSB0 f
+```
+
+## License
+
+LGPL - see [COPYING](COPYING) file for details.
+
+## Links
+
+- [Hamlib Project](https://hamlib.github.io/)
+- [Supported Radios](https://github.com/Hamlib/Hamlib/wiki/Supported-Radios)
+- [rigctl Documentation](https://hamlib.github.io/manpages/rigctl.html)