open-isp/docs/OLT_OID_REFERENCE.md

HIOSO OLT — SNMP OID Reference

File ini mendokumentasikan semua SNMP OID yang digunakan di lib/HiosoOLT.php
Terverifikasi dari hasil polling langsung di lapangan (OLT A, B, C, D — April 2026)
Terakhir diperbarui: Mei 2026 — disesuaikan dengan kode aktual HiosoOLT::PROFILES dan $parseSignal

---

1. Enterprise ID (Private MIB Root)

Vendor	Enterprise OID	Keterangan
Hioso / C-Data	.1.3.6.1.4.1.25355	OLT series HA7304V, HA7304C, HA7304VX
BDCOM / Huawei clone	.1.3.6.1.4.1.3320	OLT berbasis chipset Huawei EPON

---

2. Profile OLT — OID per Tipe

2.1 HIOSO_C — Hioso HA7304V (EPON, community: public)

Digunakan di: OLT C (192.168.75.66)
SNMP limitation: hanya expose 2 grup ONU (1.1.X = PON1, 1.2.X = PON2+3+4 merged)
Butuh Telnet scan + k-NN untuk pisahkan PON2/3/4 secara fisik

Field	OID	Keterangan
Nama ONU	.1.3.6.1.4.1.25355.3.2.6.3.2.1.37	String, bisa custom atau "NA"
Serial Number (SN)	.1.3.6.1.4.1.25355.3.2.6.3.2.1.11	Hex string, dikonversi ke MAC-like
MAC Address	.1.3.6.1.4.1.25355.3.2.6.3.2.1.12	Alternatif SN candidate (hanya di scan awal)
Status ONU	.1.3.6.1.4.1.25355.3.2.6.3.2.1.39	1=online, 2=offline
Jarak (distance)	.1.3.6.1.4.1.25355.3.2.6.3.2.1.25	Integer, satuan meter
Tx Power	.1.3.6.1.4.1.25355.3.2.6.14.2.1.4	Float string dBm (sudah final, contoh: -2.08)
Rx Power	.1.3.6.1.4.1.25355.3.2.6.14.2.1.8	Float string dBm (sudah final, contoh: -18.50)
Temperature	.1.3.6.1.4.1.25355.3.2.6.14.2.1.7	Integer, satuan °C

Format index OID: {B}.{PON}.{ONU_ID} — contoh: 1.2.4 = board 1, PON 2, ONU ID 4

Flag khusus (PROFILES['HIOSO_C']):

• telnet_pon34_scan = true — sistem secara otomatis Telnet ke OLT untuk membaca optik PON3 dan PON4 yang tidak terekspos via SNMP

---

2.2 HIOSO_B2 — Hioso HA7304C (EPON B, community: SNMPREAD)

Digunakan di: OLT A (192.168.75.88), OLT B (192.168.75.77)
Terdeteksi via sysDescr mengandung string "HIOSO B"
Expose 4 PON port terpisah secara akurat via SNMP

Field	OID	Keterangan
Nama ONU	.1.3.6.1.4.1.25355.3.2.6.3.2.1.37	Sama dengan HIOSO_C
Serial Number	.1.3.6.1.4.1.25355.3.2.6.3.2.1.11	Sama dengan HIOSO_C
Status ONU	.1.3.6.1.4.1.25355.3.2.6.3.2.1.39	1=online, 2=offline
Jarak (distance)	.1.3.6.1.4.1.25355.3.2.6.3.2.1.25	Integer, meter
Tx Power	.1.3.6.1.4.1.25355.3.2.6.14.2.1.4	Float string dBm (sudah final, sama dengan HIOSO_C)
Rx Power	.1.3.6.1.4.1.25355.3.2.6.14.2.1.8	Float string dBm (sudah final, sama dengan HIOSO_C)
Temperature	.1.3.6.1.4.1.25355.3.2.6.14.2.1.7	Integer, °C

✅ HIOSO_C dan HIOSO_B2 menggunakan MIB tree yang sama (.25355.3.2.6). Perbedaannya hanya di SNMP community string dan kemampuan expose PON port.

---

2.3 HIOSO_VX — Hioso HA7304VX (EPON, community: public)

Digunakan di: OLT D (192.168.75.99)
Varian dari HIOSO_C — MIB tree identik

Field	OID	Keterangan
Nama ONU	.1.3.6.1.4.1.25355.3.2.6.3.2.1.37
Serial Number	.1.3.6.1.4.1.25355.3.2.6.3.2.1.11
Status ONU	.1.3.6.1.4.1.25355.3.2.6.3.2.1.39
Jarak (distance)	.1.3.6.1.4.1.25355.3.2.6.3.2.1.25
Tx Power	.1.3.6.1.4.1.25355.3.2.6.14.2.1.4	Float string dBm (identik dengan HIOSO_C)
Rx Power	.1.3.6.1.4.1.25355.3.2.6.14.2.1.8	Float string dBm (identik dengan HIOSO_C)
Temperature	.1.3.6.1.4.1.25355.3.2.6.14.2.1.7	Integer, °C

⚠️ HIOSO_VX tidak memiliki flag telnet_pon34_scan — berbeda dengan HIOSO_C.

---

2.4 HIOSO_B — BDCOM / Huawei Clone (EPON)

Berbasis chipset Huawei, MIB tree berbeda total (.3320.101.10)

Field	OID	Keterangan
Nama ONU	.1.3.6.1.4.1.3320.101.10.1.1.79
Serial Number	.1.3.6.1.4.1.3320.101.10.1.1.3
Status ONU	.1.3.6.1.4.1.3320.101.10.1.1.26
Tx Power	.1.3.6.1.4.1.3320.101.10.5.1.5	Integer mentah — di-scale otomatis (lihat Sec. 6)
Rx Power	.1.3.6.1.4.1.3320.101.10.5.1.6	Integer mentah — di-scale otomatis (lihat Sec. 6)

⚠️ Tidak ada OID Temperature dan Distance pada profile ini.

---

2.5 HIOSO_GPON — C-Data GPON

MIB tree .25355.3.3 (beda dengan EPON .25355.3.2)

Field	OID	Keterangan
Nama ONU	.1.3.6.1.4.1.25355.3.3.1.1.1.2
Serial Number	.1.3.6.1.4.1.25355.3.3.1.1.1.5
Status ONU	.1.3.6.1.4.1.25355.3.3.1.1.1.11
Tx Power	.1.3.6.1.4.1.25355.3.3.1.1.4.1.2	Integer mentah — di-scale otomatis (lihat Sec. 6)
Rx Power	.1.3.6.1.4.1.25355.3.3.1.1.4.1.1	Integer mentah — di-scale otomatis (lihat Sec. 6)

---

3. Perbandingan OID Antar Profile

Field	HIOSO_C / B2 / VX	HIOSO_B (BDCOM)	HIOSO_GPON
Root MIB	.25355.3.2.6	.3320.101.10	.25355.3.3.1
Nama ONU	...3.2.1.37	...1.1.79	...1.1.2
SN/MAC	...3.2.1.11	...1.1.3	...1.1.5
Status	...3.2.1.39	...1.1.26	...1.1.11
Tx Power	...14.2.1.4	...5.1.5	...4.1.2
Rx Power	...14.2.1.8	...5.1.6	...4.1.1
Temperature	...14.2.1.7	❌	❌
Jarak	...3.2.1.25	❌	❌
Divider Rx/Tx	float dBm langsung	auto-scale (magnitude)	auto-scale (magnitude)
divider di PROFILES	1	10	100

---

4. SN Candidate OIDs (Auto-Detection)

Saat OLT baru pertama kali ditambahkan, sistem scan semua kandidat OID berikut untuk menemukan mana yang mengembalikan data valid:

{activeProfile.sn}                 — OID SN dari profile aktif (misal .25355.3.2.6.3.2.1.11)
{parentBranch}.11                  — parentBranch = prefix name OID tanpa digit terakhir
.1.3.6.1.4.1.25355.3.2.10.1.1.2   — kandidat SN tipe 1
{parentBranch}.12                  — MAC address dalam branch yang sama
{parentBranch}.2                   — ONU field alternatif dalam branch yang sama
.1.3.6.1.4.1.25355.3.2.1.2.1.2    — kandidat SN tipe 2
.1.3.6.1.4.1.25355.3.2.6.1.1.18   — kandidat SN tipe 3
.1.3.6.1.4.1.25355.3.2.6.3.2.1.12 — MAC address (absolute)
.1.3.6.1.4.1.25355.3.3.1.1.1.5    — GPON SN
.1.3.6.1.4.1.3320.101.10.1.1.3    — BDCOM SN

parentBranch dihitung secara dinamis: substr(activeProfile['name'], 0, strrpos(name, '.')).
Contoh untuk HIOSO_C: name = ...3.2.6.3.2.1.37 → parentBranch = ...3.2.6.3.2.1 → kandidat dinamis = ...3.2.6.3.2.1.11, ...3.2.6.3.2.1.12, ...3.2.6.3.2.1.2.

Duplikat dihapus via array_unique() sebelum di-scan. OID pemenang (mengembalikan data terbanyak) disimpan di data/olt_oids/{oltId}.json dan dipakai langsung pada polling berikutnya (tidak perlu scan ulang).

---

5. OID Standard (IF-MIB / RFC 2863)

OID berikut digunakan semua profile — tidak vendor-specific.

5.1 System Info (SNMPv2-MIB)

OID	Field	Keterangan
1.3.6.1.2.1.1.1.0	sysDescr	Deskripsi hardware OLT (string)
1.3.6.1.2.1.1.3.0	sysUpTime	Uptime OLT sejak reboot (timeticks)
1.3.6.1.2.1.1.5.0	sysName	Hostname OLT

5.2 Port Status — IF-MIB (ifTable)

OID	Field	Keterangan
1.3.6.1.2.1.2.2.1.2	ifDescr	Nama interface (PON-1, GE-1, dll)
1.3.6.1.2.1.2.2.1.8	ifOperStatus	Status: 1=up, 2=down
1.3.6.1.2.1.2.2.1.10	ifInOctets	Bytes masuk (32-bit, wrap di 4GB)
1.3.6.1.2.1.2.2.1.16	ifOutOctets	Bytes keluar (32-bit)

5.3 Port Counter 64-bit — IF-MIB Extended (ifXTable)

Digunakan jika OLT support (mencegah counter wrap di port gigabit):

OID	Field	Keterangan
1.3.6.1.2.1.31.1.1.1.6	ifHCInOctets	Bytes masuk 64-bit
1.3.6.1.2.1.31.1.1.1.10	ifHCOutOctets	Bytes keluar 64-bit
1.3.6.1.2.1.31.1.1.1.15	ifHighSpeed	Kecepatan interface (Mbps)

Sistem otomatis probe ifHCInOctets terlebih dulu. Jika tidak ada respons, fallback ke ifInOctets 32-bit.

5.4 System Resources — HOST-RESOURCES-MIB (hrTable)

Hanya pada OLT yang support (HIOSO_B2). Tidak tersedia di HIOSO_C dan HIOSO_VX.

OID	Field	Keterangan
1.3.6.1.2.1.25.3.3.1.2.768	hrProcessorLoad	CPU load % (index 768 = CPU pertama)
1.3.6.1.2.1.25.2.3.1.5.1	hrStorageSize	Total RAM (unit = 1024 bytes)
1.3.6.1.2.1.25.2.3.1.6.1	hrStorageUsed	RAM terpakai (unit = 1024 bytes)

---

6. Cara Membaca Nilai Rx/Tx Power

Logika parsing Rx/Tx Power di kode (HiosoOLT::$parseSignal) berbeda antara profile:

6.1 Profile divider = 1 (HIOSO_C, HIOSO_B2, HIOSO_VX)

SNMP mengembalikan float string yang sudah dalam satuan dBm (mis. "-12.22", "2.08").
Kode hanya melakukan (float) number_format($num, 2) — tidak ada konversi unit.

SNMP value: "-12.22"  →  Hasil: -12.22 dBm  ✓
SNMP value: "2.08"    →  Hasil:   2.08 dBm  ✓

6.2 Profile divider != 1 (HIOSO_B, HIOSO_GPON)

SNMP mengembalikan integer mentah. Kode menggunakan auto-scale berdasarkan magnitude
(nilai $divider sendiri hanya dipakai untuk membedakan == 1 vs bukan):

$abs = abs($num);
if ($abs > 500) return round($num / 100, 2);   // mis. -1227 → -12.27 dBm
if ($abs > 50)  return round($num / 10, 2);    // mis. -122  → -12.20 dBm
return round($num, 2);                          // mis. -12   → -12.00 dBm

SNMP Value	abs > 500?	abs > 50?	Hasil
-1227	✓	—	-1227 / 100 = -12.27 dBm
-122	✗	✓	-122 / 10 = -12.20 dBm
-12	✗	✗	-12.00 dBm (langsung)

⚠️ Catatan dokumen lama yang menyebut formula $val / $divider / 100 adalah salah — kode aktual menggunakan auto-scale magnitude di atas.

Signal Level (sig_level)

Fungsi HiosoOLT::signalLevel(?float $rxDbm): string — implementasi aktual:

if ($rxDbm === null) return 'unknown';
if ($rxDbm < -27.0)  return 'critical';
if ($rxDbm < -25.0)  return 'warn';
return 'ok';

Kondisi	Label	Warna UI
$rxDbm === null	unknown	Abu-abu
$rxDbm < -27.0 dBm	critical	Merah
-27.0 ≤ $rxDbm < -25.0 dBm	warn	Kuning
$rxDbm ≥ -25.0 dBm	ok	Hijau

---

7. Format Index ONU

Index ONU pada OID mengikuti format hirarki board-PON-ONU:

{board}.{pon}.{onu_id}

Contoh untuk HIOSO_C (HA7304V):

• 1.1.1 → Board 1, PON 1, ONU ID 1
• 1.1.52 → Board 1, PON 1, ONU ID 52 (last ONU on PON1)
• 1.2.1 → Board 1, PON 2, ONU ID 1 ← SNMP group B=2 (merged PON2/3/4!)
• 1.2.74 → Board 1, PON 2, ONU ID 74 (last in merged group)

Untuk HIOSO_B2 (HA7304C):

• 1.1.X → PON 1
• 1.2.X → PON 2
• 1.3.X → PON 3
• 1.4.X → PON 4
• Semua port terepresentasikan dengan benar di SNMP (tidak ada merge)

---

8. Verifikasi via CLI (snmpwalk)

Contoh perintah untuk memverifikasi OID secara langsung:

# Test koneksi dasar (sysDescr)
snmpwalk -v2c -c public 192.168.75.66 1.3.6.1.2.1.1.1.0

# Daftar semua ONU status (HIOSO_C)
snmpwalk -v2c -c public 192.168.75.66 .1.3.6.1.4.1.25355.3.2.6.3.2.1.39

# Rx Power semua ONU (HIOSO_B2, community SNMPREAD)
snmpwalk -v2c -c SNMPREAD 192.168.75.88 .1.3.6.1.4.1.25355.3.2.6.14.2.1.8

# Port status semua interface
snmpwalk -v2c -c public 192.168.75.66 1.3.6.1.2.1.2.2.1.8

# CPU load (hrProcessorLoad) — hanya HIOSO_B2
snmpget -v2c -c SNMPREAD 192.168.75.88 1.3.6.1.2.1.25.3.3.1.2.768

---

9. OLT Device Map (Salfanet Production)

OLT ID	Nama	IP	Model	Profile	Community	PON Count
olt_69e17c1abf643	OLT A	192.168.75.88	HA7304C	HIOSO_B2	SNMPREAD	4
olt_69e72ee7309fe	OLT B	192.168.75.77	HA7304C	HIOSO_B2	SNMPREAD	4
olt_69e72e6911857	OLT C	192.168.75.66	HA7304V	HIOSO_C	public	4 (PON2+3+4 merged di SNMP)
olt_69e72f2ba1f75	OLT D	192.168.75.99	HA7304VX	HIOSO_VX	public	4