uSNMP:微型SNMP開源

如何使用 uSNMP？

代理和命令行實(shí)用程序的代碼示例可用作開發(fā) SNMPv1 代理、發(fā)出 SNMPv1 請(qǐng)求和處理響應(yīng)以及發(fā)送陷阱的模板。用于 Windows 和 *nix的示例 uSNMP 代理程序 usnmpd.c從文件中讀取 OID 和值對(duì)，并且可以用作 SNMPv1 網(wǎng)關(guān)，方法是讓輪詢程序格式化并將其接收到的數(shù)據(jù)寫入此文件。另一個(gè)代理示例usnmpd.ino將 Arduino 板轉(zhuǎn)換為具有數(shù)字和模擬 I/O 的支持 SNMP 的控制器。MIB 文件位于mibs目錄中。ARDUINO.MIB文件用于Arduino 軟件 (IDE) 管理板，私有企業(yè)編號(hào) (PEN) 是Armadino 的 38644。

usnmpd.ino - Arduino 的 SNMP 代理

讓我們更深入地研究一下usnmpd.ino 。對(duì)于 NodeMCU 等第 3 方硬件包，首先需要在 Arduino IDE 中添加其 Boards Manager JSON 文件的 URL。URL 指向 Arduino IDE 用來(lái)構(gòu)建可用已安裝板的列表的 JSON 索引文件。這可以通過(guò)File...Preferences和 NodeMCU 等 ESP8266 板完成：

usnmpd.ino的前幾行設(shè)置了網(wǎng)絡(luò)連接（以太網(wǎng)或 WiFi）、IP 地址和代理配置。

// Agent's IP configuration. Retain these global variable names.
IPAddress hostIpAddr( 192, 168, 1, 177 ),
   dnsServer( 192, 168, 1, 1 ),
   hostGateway( 192, 168, 1, 1 ),
   hostNetmask( 255, 255, 255, 0 );
#ifdef ARDUINO_ETHERNET
unsigned char hostMacAddr[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
#else // assume ARDUINO_WIFI
char staSSID[] = "Wifi_SSID";
char staPSK[] = "Wifi_Password";
#endif
// SNMP agent configuration.
#define ENTERPRISE_OID  "P.38644.30"  // used as sysObjectID and in trap
#define RO_COMMUNITY    "public"                  
#define RW_COMMUNITY    "private"
#define TRAP_DST_ADDR   "192.168.1.170"

uSNMP 為對(duì)象 ID 定義了三個(gè)前綴，每個(gè)有效的 OID 都需要以這些前綴開頭：

B denotes Mgmt-Mib2 - 1.3.6.1.2.1
E denotes Experimental - 1.3.6.1.3
P denotes Private-Enterprises - 1.3.6.1.4.1

因此，sysDescr.0 (1.3.6.1.2.1.1.1.0) 將被編碼為“B.1.1.0”，“1.3.6.1.4.1.38644.30”的企業(yè) OID 將被編碼為“P.38644.30”

setup() 初始化板和代理“引擎”，包括構(gòu)建 MIB 樹和發(fā)送冷啟動(dòng)陷阱。引腳 D2 到 D5 設(shè)計(jì)為數(shù)字輸入，D6 到 D8 是數(shù)字輸出，A0 和 A1 是模擬輸入，具體取決于目標(biāo)微控制器上可用的 SRAM 數(shù)量。包含 mib-2::system 表后，帶有 ATmega328p 的 Arduino UNO 可以具有 D2、D3、D6、D7 和 A0，而 Arduino Mega 可能會(huì)超出 D5、D8 和 A1（如果愿意的話）。否則，省略系統(tǒng)表將釋放 UNO 上的空間以容納更多引腳。

initSnmpAgent(SNMP_PORT, ENTERPRISE_OID, RO_COMMUNITY, RW_COMMUNITY);
initMibTree();
trapBuild(&request, enterpriseOID, hostIpAddr, COLD_START, 0, NULL); // cold start trap
trapSend(&request, trapDstAddr, TRAP_DST_PORT, roCommunity);

MIB 樹是用函數(shù)構(gòu)建的miblistadd()，即按照字典順序?qū)?MIB 離開節(jié)點(diǎn)嫁接到它上面。如果需要，隨后設(shè)置節(jié)點(diǎn)的值，并附加回調(diào)函數(shù)以響應(yīng) SNMP Get 和 Set 操作。在下面的摘錄中，sysDescr分配了一個(gè)已經(jīng)包含系統(tǒng)描述的字符串。在用 BER（基本編碼規(guī)則）編碼后用sysObjectID初始化。設(shè)置了回調(diào)以在請(qǐng)求獲取操作時(shí)填寫系統(tǒng)正常運(yùn)行時(shí)間。EnterpriseOIDsysUpTimeget_uptime()

/* System MIB */
// sysDescr Entry
thismib = miblistadd(mibTree, "B.1.1.0", OCTET_STRING, RD_ONLY,
   sysDescr, strlen(sysDescr));
// sysObjectID Entry
thismib = miblistadd(mibTree, "B.1.2.0", OBJECT_IDENTIFIER, RD_ONLY,
   entOIDBer, 0);  // set length to 0 first
i = str2ber(enterpriseOID, entOIDBer);
mibsetvalue(thismib, (void *) entOIDBer, (int) i);  // proper length set
// sysUptime Entry
thismib = miblistadd(mibTree, "B.1.3.0", TIMETICKS, RD_ONLY, NULL, 0);
i = 0; mibsetvalue(thismib, &i, 0);
mibsetcallback(thismib, get_uptime, NULL);

數(shù)字和模擬 I/O 引腳顯示在 SNMP 表中。為了節(jié)省內(nèi)存，這些表是極簡(jiǎn)的，僅包含索引和引腳值。需要回調(diào)函數(shù)，以便在響應(yīng) Get 或 Set 請(qǐng)求時(shí)及時(shí)檢索值。因此，例如，對(duì)于數(shù)字輸出 D6，

// Digital output #6 index
thismib = miblistadd(mibTree, "P.38644.30.2.1.1.6", INTEGER, RD_ONLY, NULL, 0);
i = 6; mibsetvalue(thismib, &i, 0);
// The value of Digital #6
thismib = miblistadd(mibTree, "P.38644.30.2.1.2.6", INTEGER, RD_WR, NULL, 0);
i = 0; mibsetvalue(thismib, &i, 0);
mibsetcallback(thismib, get_dio, set_dio);

代理被設(shè)計(jì)為在檢測(cè)到數(shù)字輸入中的狀態(tài)變化時(shí)發(fā)送陷阱。由于 uSNMP 代理不可重入，因此只能在主循環(huán)中構(gòu)建和發(fā)送陷阱。

if ( x & 0x01 ) {
  vblistReset(&response); dInIndex[17]='0'+y; // use response buffer to build trap
  if ( lastDIN & 0x01 ) { // input pin y was 1
    i = 0;          // it is thus 0 now
    vblistAdd(&response, dInIndex, INTEGER, &i, 0);
    trapBuild(&request, enterpriseOID, hostIpAddr, ENTERPRISE_SPECIFIC, 1, &response);
  }
  else {
    i = 1;
    vblistAdd(&response, dInIndex, INTEGER, &i, 0);
    trapBuild(&request, enterpriseOID, hostIpAddr, ENTERPRISE_SPECIFIC, 2, &response);
  }
  trapSend(&request, trapDstAddr, TRAP_DST_PORT, rwCommunity);
}

同樣，如果代理在處理 SNMP 請(qǐng)求時(shí)遇到不匹配的社區(qū)字符串，它會(huì)發(fā)送一個(gè)身份驗(yàn)證失敗陷阱。

if ( processSNMP() == COMM_STR_MISMATCH ) {
       trapBuild(&request, enterpriseOID, hostIpAddr, AUTHENTICATE_FAIL, 0, NULL);
       trapSend(&request, trapDstAddr, TRAP_DST_PORT, rwCommunity);
}

試驗(yàn)結(jié)果

僅此而已。uSNMP 庫(kù)具有發(fā)出 SNMP 請(qǐng)求和處理響應(yīng)的功能；并包括用于測(cè)試 usnmpd.imo 代理的命令行示例，例如 usnmpget 和 usnmpset。另一種方法是使用 Net-SNMP 二進(jìn)制文件。兩組測(cè)試如下所示：

使用此 uSNMP 庫(kù)構(gòu)建的命令行實(shí)用程序進(jìn)行測(cè)試

?

?

使用來(lái)自 Net-SNMP (www.net-snmp.org) 的實(shí)用程序進(jìn)行測(cè)試。

?

?

?

?

?

?