Files
thor-emitter/docs/COMMUNICATION_GUIDE.md
serversdwn f9139d6aa3 feat: Add comprehensive NL-43/NL-53 Communication Guide and command references
- Introduced a new communication guide detailing protocol basics, transport modes, and a quick startup checklist.
- Added a detailed list of commands with their functions and usage for NL-43/NL-53 devices.
- Created a verified quick reference for command formats to prevent common mistakes.
- Implemented an improvements document outlining critical fixes, security enhancements, reliability upgrades, and code quality improvements for the SLMM project.
- Enhanced the frontend with a new button to retrieve all device settings, along with corresponding JavaScript functionality.
- Added a test script for the new settings retrieval API endpoint to demonstrate its usage and validate functionality.
2025-12-25 00:36:46 +00:00

13 KiB
Raw Blame History

NL-43 / NL-53 Communication Guide (Concise + Full Reference)

Single-file quick reference for the NL-43/NL-53 Communication Guide (No. 66132, pages ~197). Use the official PDF for authoritative details, exact formatting, and option requirements.

Protocol Basics

  • ASCII commands terminated with CR LF.
  • Setting: $Command,Param[CR][LF]; Request: Command?[CR][LF].
  • Wait for $ prompt/idle before the next command; recommended ≥1 s between commands.
  • Result codes: R+0000 success; 0001 command error; 0002 parameter error; 0003 spec/type error; 0004 status error (wrong state).
  • Control codes: CR=0x0D, LF=0x0A, SUB=0x1A (stop DRD stream).
  • Timing: responds within ~3 s; characters ≤100 ms apart; DRD streams until SUB.

Transport Modes

  • USB CDC: Serial over USB (mutually exclusive with LAN TCP/FTP/web/I/O port comm).
  • RS-232C: 9600115200 bps; DRD streaming needs ≥19200 (EX) or ≥57600 (RT).
  • LAN (NX-43EX): TCP control, FTP, web app (ports 80 & 8000). TCP/FTP/Web are mutually exclusive with each other and with USB comm while active.

Quick Startup Checklist (TCP control)

  1. Install NX-43EX; on device: Ethernet On; DHCP On or set IP/Subnet/Gateway; TCP, On; ensure USB comm + web app + I/O port comm are Off.
  2. Ensure reachability to device IP:TCP port (default 80).
  3. Clock,<timestamp> to sync time.
  4. Configure mode/intervals, then Measure, Start.
  5. Poll DOD? (≥1 s) or stream DRD?status; stop with SUB.
  6. Toggle FTP, On only when pulling SD files; then back to TCP, On.

LAN / USB / Web / FTP (NX-43EX)

Command Purpose Type Notes / Params
Ethernet LAN on/off S/R `Ethernet, On
Ethernet DHCP DHCP on/off S/R `Ethernet DHCP, On
Ethernet IP Set IP S/R Ethernet IP, a.b.c.d (p84)
Ethernet Subnet Set subnet S/R Ethernet Subnet, a.b.c.d (p84)
Ethernet Gateway Set gateway S/R Ethernet Gateway, a.b.c.d (p85)
TCP TCP control S/R `TCP, On
FTP FTP transfer S/R `FTP, On
Web Web app S/R `Web, On
USB Class USB comm/mass storage S/R `USB Class, Off

Data Output Commands (fields)

  • DOD?: Snapshot; main/sub channel Lp, Leq, LE, Lmax, Lmin, LN1LN5, Lpeak, LIeq, Leq,mov, Ltm5, over/under flags. RT variant may include band/POA data; wait ≥1 s between requests.
  • DRD?: Continuous every 100 ms; counter + main/sub Lp/Leq/Lmax/Lmin/Lpeak/LIeq + over/under. Stop with SUB (0x1A). Baud constraints on RS-232C only.
  • DRD?status: DRD payload + timestamp, power source (I/E/U), battery level (F/M/L/D/E), SD remaining MB, measurement state (M/S).
  • DLC?: Final calculation set (similar to DOD); RT variant includes band data + over/under flags.

Condensed Command List (Section 5.6)

Command Function Type Notes / Page
Communication Echo Echo on/off S/R p39
System Version Version info R p39
Type Model type R p39
Serial Number Serial number R p39
Clock Current time S/R p40
Language Display language S/R p40
Index Number Index S/R p40
Key Lock Key lock S/R p41
Backlight Backlight status S/R p41
Backlight Auto Off Auto off S/R p41
LCD LCD status S/R p41
LCD Auto Off Auto off S/R p42
Backlight Brightness Brightness S/R p42
Battery Type Battery type S/R p42
Battery Level Battery level S/R p43
SD Card Total Size SD total R p43
SD Card Free Size SD free R p43
SD Card Percentage SD free % R p43
Output Level Range Upper Bar upper S/R p44
Output Level Range Lower Bar lower S/R p44
Display Leq / LE / Lpeak / Lmax / Lmin Display flags S/R p4445
Display LN1LN5 Percentiles display S/R p4546
Display LIeq / Ltm5 / Leqmov Display flags S/R p47
Time Level Time Scale Time-level scale S/R p47
Display Calculate Type (RT) Calc type S/R p48
Measure Display Sub Channel 13 Sub displays S/R p49
Octave Mode (RT) Analysis mode S/R p49
Additional Band (RT) Sub band S/R p49
Display Partial Over All (RT) POA on/off S/R p50
Upper/Lower Limit Frequency (+Offset) (RT) POA bands S/R p5052
Lmax Type / Channel Lmax/Lmin settings S/R p52
Frequency Weighting (Main/Sub13) Weighting S/R p53
Frequency Weighting (Band) (RT) Band weighting S/R p53
Time Weighting (Main/Sub13) Time weighting S/R p54
Time Weighting (Band/Band2) (RT) Band time weighting S/R p55
Windscreen / Diffuse Correction Corrections S/R p5556
Ldiff1/Ldiff2 (+Channel/Calc) (RT) Differential S/R p5657
Store Mode / Name / Manual Address Storage setup S/R p58
Measure Start/Stop measure S/R p58
Pause Pause S/R p59
Manual Store Manual store S p59
Overwrite Overwrite check S/R p59
Measurement Time Preset Manual / Manual (Num/Unit) Manual timing S/R p60
Measurement Time Preset Auto / Auto (Num/Unit) (EX) Auto timing S/R p61
Lp Store Interval Lp interval S/R p62
Leq Calculation Interval Preset / Num / Unit Leq interval S/R p6263
Store Delay Time Delay S/R p63
Back Erase Back erase S/R p63
Timer Auto Start/Stop Time Timer S/R p64
Timer Auto Interval (EX) Timer interval S/R p65
Sleep Mode Sleep S/R p65
Trigger Mode Trigger S/R p65
Level Trigger Channel (EX) Trigger channel S/R p66
Level Trigger Band Freq/Offset (RT) Band trigger S/R p6667
Level Trigger Level (EX) Trigger level S/R p67
Moving Leq Interval Preset / Num / Unit Moving Leq S/R p6768
TRM LN mode sampling S/R p68
Percentile 15 LN percentiles S/R p69
Lp Mode (RT) Lp type S/R p69
Wave Rec Mode / Sampling Freq / Bit Length (WR) Waveform S/R p70
Frequency Weighting (Wave) Wave weighting S/R p71
Wave Rec Range Upper / State Wave status S/R p71
Wave Splitting Interval Split interval S/R p72
Wave Manual Rec / Pre-time Manual rec S/R p72
Wave Level Rec / Trigger Channel (WR/RT) Level rec S/R p73
Wave Level Trigger Band Freq/Offset (RT) Band trigger S/R p7374
Wave Level Trigger Level / Pre-time / Max Time Thresholds S/R p7475
Wave Level Reference Time/Level (14) Time-zone thresholds S/R p7576
Wave Interval Rec (Interval/Time) Interval rec S/R p7677
I/O AC OUT AC output S/R p78
AC Out Band Freq/Offset (RT) AC band S/R p7879
I/O DC OUT DC output S/R p79
DC Out Band Freq/Offset (RT) DC band S/R p80
Output Range Upper Electrical full scale S/R p81
Reference Signal Output Reference signal S/R p81
IO Func IO port S/R p81
Baud Rate RS-232C baud S/R p82
Comparator Channel Comparator channel S/R p82
Comparator Band Freq/Offset (RT) Comparator band S/R p8283
Comparator Level (EX) Comparator level S/R p83
USB Class USB comm S/R p83
Ethernet / DHCP / IP / Subnet / Gateway (EX) LAN config S/R p8485
Web (EX) Web app S/R p85
FTP (EX) FTP S/R p85
TCP (EX) TCP control S/R p86
DOD / DOD (RT) Output displayed value R p8889
DRD / DRD (RT) Continuous output R p9091
DRD?status / DRD?status (RT) Continuous + status R p9293
DLC / DLC (RT) Final calculation output R p9495

Full Command Catalog (pages ~3095)

All commands from section 5.6 listed with purpose. Types: S=Setting, R=Request. Options: (EX)=NX-43EX, (RT)=NX-43RT, (WR)=NX-43WR.

Communication / System

  • Communication Echo (S/R): Echo sent command strings (p39)
  • System Version (R): Version info (p39)
  • Type (R): Type info (p39)
  • Serial Number (R): Serial number (p39)
  • Clock (S/R): Current time (p40)
  • Language (S/R): Display language (p40)
  • Index Number (S/R): Index (p40)

UI / Power / Storage Stats

  • Key Lock (S/R): Key lock (p41)
  • Backlight (S/R): Backlight status (p41)
  • Backlight Auto Off (S/R): Auto off (p41)
  • LCD (S/R): LCD status (p41)
  • LCD Auto Off (S/R): Auto off (p42)
  • Backlight Brightness (S/R): Brightness (p42)
  • Battery Type (S/R): Battery type (p42)
  • Battery Level (S/R): Battery level (p43)
  • SD Card Total Size (R): SD total (p43)
  • SD Card Free Size (R): SD free (p43)
  • SD Card Percentage (R): SD free % (p43)

Display/Measure Flags

  • Output Level Range Upper/Lower (S/R): Bar graph ranges (p44)
  • Display Leq/LE/Lpeak/Lmax/Lmin (S/R): Flags (p4445)
  • Display LN1LN5 (S/R): Percentiles (p4546)
  • Display LIeq/Ltm5/Leqmov (S/R): Flags (p47)
  • Time Level Time Scale (S/R): Time-level scale (p47)
  • Display Calculate Type (RT, S/R): Calc type (p48)
  • Measure Display Sub Channel 13 (S/R): Sub displays (p49)

Analysis / Bands (RT)

  • Octave Mode (S/R): Analysis mode (p49)
  • Additional Band (S/R): Sub band (p49)
  • Display Partial Over All (S/R): POA (p50)
  • Upper/Lower Limit Frequency (+Offset) (S/R): POA bands (p5052)
  • Lmax Type / Channel (S/R): Lmax/Lmin settings (p52)

Weighting / Corrections

  • Frequency Weighting (Main/Sub13) (EX, S/R): Weighting (p53)
  • Frequency Weighting (Band) (RT, S/R): Band weighting (p53)
  • Time Weighting (Main/Sub13) (S/R): Time weighting (p54)
  • Time Weighting (Band/Band2) (RT, S/R): Band time weighting (p55)
  • Windscreen Correction (S/R): Windscreen correction (p55)
  • Diffuse Sound Field Correction (S/R): Diffuse correction (p56)

Differential (RT)

  • Ldiff1/Ldiff2 (S/R): Measure differential (p56)
  • Ldiff1/2 Channel1/2 (S/R): Differential channel (p56)
  • Ldiff1/2 Calculation1/2 (S/R): Differential calc (p57)

Store / Measurement Control

  • Store Mode (S/R): Manual/Auto (p58)
  • Store Name (S/R): Storage name (p58)
  • Manual Address (S/R): Manual storage address (p58)
  • Measure (S/R): Start/Stop measure (p58)
  • Pause (S/R): Pause (p59)
  • Manual Store (S): Manual store (p59)
  • Overwrite (S/R): Overwrite check (p59)
  • Measurement Time Preset Manual / Manual (Num/Unit) (S/R): Manual timing (p60)
  • Measurement Time Preset Auto / Auto (Num/Unit) (EX, S/R): Auto timing (p61)
  • Lp Store Interval (S/R): Lp interval (p62)
  • Leq Calculation Interval Preset / Num / Unit (S/R): Leq interval (p6263)
  • Store Delay Time (S/R): Delay (p63)
  • Back Erase (S/R): Back erase (p63)
  • Timer Auto Start/Stop Time (S/R): Timer (p64)
  • Timer Auto Interval (EX, S/R): Auto interval (p65)
  • Sleep Mode (S/R): Sleep (p65)
  • Trigger Mode (S/R): Trigger (p65)
  • Level Trigger Channel (EX, S/R): Trigger channel (p66)
  • Level Trigger Band Frequency/Offset (RT, S/R): Band trigger (p6667)
  • Level Trigger Level (EX, S/R): Trigger level (p67)
  • Moving Leq Interval Preset / Num / Unit (S/R): Moving Leq (p6768)
  • TRM (S/R): LN mode sampling (p68)
  • Percentile 15 (S/R): LN percentiles (p69)
  • Lp Mode (RT, S/R): Lp type (p69)

Waveform Recording (WR/RT)

  • Wave Rec Mode / Sampling Frequency / Bit Length (S/R): Recording config (p70)
  • Frequency Weighting (Wave) (S/R): Wave weighting (p71)
  • Wave Rec Range Upper / State (S/R): Rec range/status (p71)
  • Wave Splitting Interval (S/R): File split interval (p72)
  • Wave Manual Rec / Pre-time (S/R): Manual rec (p72)
  • Wave Level Rec / Trigger Channel (WR/RT, S/R): Level rec (p73)
  • Wave Level Trigger Band Frequency/Offset (RT, S/R): Band trigger (p7374)
  • Wave Level Trigger Level / Pre-time / Maximum Recording Time (S/R): Thresholds/time (p7475)
  • Wave Level Reference Time Interval 14 (S/R): Time-zone intervals (p75)
  • Wave Level Reference Time 14 (S/R): Time-zone time (p75)
  • Wave Level Reference Time 14 Level (S/R): Time-zone level (p7576)
  • Wave Interval Rec Interval / Time (S/R): Interval rec (p7677)

I/O and Outputs

  • I/O AC OUT (S/R): AC output (p78)
  • AC Out Band Frequency/Offset (RT, S/R): AC band (p7879)
  • I/O DC OUT (S/R): DC output (p79)
  • DC Out Band Frequency/Offset (RT, S/R): DC band (p80)
  • Output Range Upper (S/R): Electrical full scale (p81)
  • Reference Signal Output (S/R): Reference signal (p81)
  • IO Func (S/R): IO port (p81)

Comparator / Comms

  • Baud Rate (S/R): RS-232C baud (p82)
  • Comparator Channel (S/R): Comparator channel (p82)
  • Comparator Band Frequency/Offset (RT, S/R): Comparator band (p8283)
  • Comparator Level (EX, S/R): Comparator level (p83)
  • USB Class (S/R): USB comm/mass storage (p83)
  • Ethernet/DHCP/IP/Subnet/Gateway (EX, S/R): LAN config (p8485)
  • Web (EX, S/R): Web app (p85)
  • FTP (EX, S/R): FTP (p85)
  • TCP (EX, S/R): TCP control (p86)

Data Output (fields)

  • DOD / DOD (RT) (R): Snapshot of displayed values; includes Lp/Leq/LE/Lmax/Lmin/LN1LN5/Lpeak/LIeq/Leq,mov/Ltm5/over-under (p8889).
  • DRD / DRD (RT) (R): Continuous every 100 ms; counter + Lp/Leq/Lmax/Lmin/Lpeak/LIeq + over/under (p9091). Stop with SUB.
  • DRD?status / DRD?status (RT) (R): DRD + timestamp, power source, battery level, SD remaining MB, measurement state (p9293).
  • DLC / DLC (RT) (R): Final calculation result set (similar to DOD; RT includes band data) (p9495).