Overview
The lora node provides ultra-long-range, low-power wireless communication
using LoRa (Long Range) modulation. Ideal for remote IoT sensing applications where devices need to communicate
over distances up to 15km while running on battery power for years.
Properties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| module | string | Yes | - | SPI device path (e.g., /dev/spidev0.0) |
| frequency | number | Yes | 868.1 | Carrier frequency in MHz (868 EU / 915 US) |
| spreadingFactor | number | No | 7 | Spreading factor SF7-SF12 (range vs speed) |
| bandwidth | number | No | 125 | Signal bandwidth in kHz (125, 250, 500) |
| codingRate | string | No | "4/5" | Forward error correction rate (4/5 to 4/8) |
| txPower | number | No | 14 | Transmit power in dBm (2-20) |
| syncWord | number | No | 0x12 | Network sync word (0x12 private, 0x34 LoRaWAN) |
Inputs
{
"payload": {
"data": "SGVsbG8gV29ybGQ=",
"destination": 0x01,
"confirmed": true
}
}{
"payload": {
"command": "configure",
"spreadingFactor": 12,
"txPower": 20
}
}Outputs
{
"payload": {
"data": "SGVsbG8=",
"rssi": -95,
"snr": 8.5,
"frequency": 868.1,
"spreadingFactor": 7
}
}{
"payload": {
"status": "transmitted",
"airtime": 56.3,
"frequency": 868.1
}
}Use Case Examples
Agriculture Monitoring
Deploy soil moisture, temperature, and weather sensors across large farms with kilometer-range connectivity.
Smart City
Monitor parking spaces, waste bins, street lights, and air quality across urban areas with a single gateway.
Environmental Monitoring
Track water levels, forest conditions, and wildlife activity in remote locations using solar-powered sensors.
Fleet Tracking
Track vehicles, containers, and equipment across campuses and logistics yards with low-power GPS-LoRa trackers.
Tips & Best Practices
Higher spreading factor = longer range but slower data rate. Use SF7 for nearby devices and SF12 for maximum range.
Check regional regulations for frequency and duty cycle limits. EU uses 868MHz with 1% duty cycle, US uses 915MHz.
Mount the antenna as high as possible with clear line of sight. Antenna placement is the single biggest factor for range.
Keep payloads small (under 50 bytes) to minimize airtime and comply with duty cycle restrictions.