W6300使用SNMP管理其他设备

本篇总结

在 W6300 上实现 SNMP Agent 功能，通过 MIB Browser 管理 W6300 的设备状态。

硬件平台：本例程基于 W6300-EVB-M4 开发板运行。

采购推荐：点击前往 WIZnet 官方淘宝店铺 选购 W6300-EVB-M4 开发板

W6300 的优势

W6300 SDK 内置了完整的 SNMP Agent 库，报文组包/解包、OID 匹配、Trap 发送全部由库函数处理。你只需要：注册定时器 → 添加 MIB 数据项 → 初始化 SNMP → 在主循环中调用 snmpd_run() 驱动状态机。

/* Preserve the W6300 SNMP time base without putting protocol ticks in wiz_platform. */
wiz_add_timer(SNMP_time_handler, 10);

dataEntryType snmpData[] = {
    // System MIB
    // SysDescr Entry
    {
        8, {0x2b, 6, 1, 2, 1, 1, 1, 0},
        SNMPDTYPE_OCTET_STRING, 30, {"WIZnet Embedded SNMP Agent"},
        NULL, NULL
    },

    // SysObjectID Entry
    {
        8, {0x2b, 6, 1, 2, 1, 1, 2, 0},
        SNMPDTYPE_OBJ_ID, 8, {"\x2b\x06\x01\x02\x01\x01\x02\x00"},
        NULL, NULL
    },

    // SysUptime Entry
    {
        8, {0x2b, 6, 1, 2, 1, 1, 3, 0},
        SNMPDTYPE_TIME_TICKS, 0, {""},
        currentUptime, NULL
    },

    // sysContact Entry
    {
        8, {0x2b, 6, 1, 2, 1, 1, 4, 0},
        SNMPDTYPE_OCTET_STRING, 30, {"http://www.wizwiki.net/forum"},
        NULL, NULL
    },

    // sysName Entry
    {
        8, {0x2b, 6, 1, 2, 1, 1, 5, 0},
        SNMPDTYPE_OCTET_STRING, 30, {"http://www.wiznet.co.kr"},
        NULL, NULL
    },

    // Location Entry
    {
        8, {0x2b, 6, 1, 2, 1, 1, 6, 0},
        SNMPDTYPE_OCTET_STRING, 30, {"4F Humax Village"},
        NULL, NULL
    },

    // SysServices
    {
        8, {0x2b, 6, 1, 2, 1, 1, 7, 0},
        SNMPDTYPE_INTEGER, 4, {""},
        NULL, NULL
    },

    // OID Test #1 (long-length OID example, 19865)
    {
        0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0x9b, 0x19, 0x01, 0x00},
        SNMPDTYPE_OCTET_STRING, 30, {"long-length OID Test #1"},
        NULL, NULL
    },

    // OID Test #2 (long-length OID example, 22210)
    {
        0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0xad, 0x42, 0x01, 0x00},
        SNMPDTYPE_OCTET_STRING, 35, {"long-length OID Test #2"},
        NULL, NULL
    },

    // OID Test #2: SysObjectID Entry
    {
        0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0xad, 0x42, 0x02, 0x00},
        SNMPDTYPE_OBJ_ID, 0x0a, {"\x2b\x06\x01\x04\x01\x81\xad\x42\x02\x00"},
        NULL, NULL
    },
};

const int32_t maxData = (sizeof(snmpData) / sizeof(dataEntryType));

void initTable(void) {
    // Example integer value for [OID 1.3.6.1.2.1.1.7.0]
    snmpData[6].u.intval = 0xFFFFFFFBU; /* -5 in 32-bit two's-complement form */
}

typedef struct {
  uint8_t oidlen;
  uint8_t oid[MAX_OID];
  uint8_t dataType;
  uint8_t dataLen;
  union {
    uint8_t octetstring[MAX_STRING];
    uint32_t intval;
  } u;
  void (*getfunction)(void *, uint8_t *);
  void (*setfunction)(int32_t);
} dataEntryType;

关键说明

MIB 数据项通过 getfunction 和 setfunction 两个回调函数与用户代码交互。读取时由 getfunction 返回当前值，设置时由 setfunction 应用新值。本例程中 SysUptime 使用 currentUptime 回调返回系统运行时间，其他数据项使用静态值。

uint8_t manager[4] = {192, 168, 1, 127};

wizchip_getnetinfo(&net_info);
snmpd_init(manager, net_info.ip, SOCKET_ID, SOCKET_ID + 1);

void snmpd_init(uint8_t * managerIP, uint8_t * agentIP,
                uint8_t sn_agent, uint8_t sn_trap)
{
    SOCK_SNMP_AGENT = sn_agent;
    SOCK_SNMP_TRAP  = sn_trap;
    if ((SOCK_SNMP_AGENT > _WIZCHIP_SOCK_NUM_) ||
        (SOCK_SNMP_TRAP  > _WIZCHIP_SOCK_NUM_)) return;

    startTime = getSNMPTimeTick(); // Start time (unit: 10ms)
    initTable();                   // Settings for OID entry values

    initial_Trap(managerIP, agentIP);
}

int32_t snmpd_run(void) {
    int32_t ret;
    int32_t len = 0;

    uint8_t  svr_addr[6];
    uint16_t svr_port;
    uint8_t  addr_len;

    if (SOCK_SNMP_AGENT > _WIZCHIP_SOCK_NUM_) {
        return -99;
    }

    switch (getSn_SR(SOCK_SNMP_AGENT)) {
    case SOCK_UDP :
        if ((len = getSn_RX_RSR(SOCK_SNMP_AGENT)) > 0) {
            if (len > MAX_SNMPMSG_LEN) {
                len = MAX_SNMPMSG_LEN;
            }
            request_msg.len = recvfrom(SOCK_SNMP_AGENT, request_msg.buffer, len,
                                       svr_addr, &svr_port, &addr_len);
        } else {
            request_msg.len = 0;
        }

        if (request_msg.len > 0) {
            // Initialize
            request_msg.index  = 0;
            response_msg.index = 0;
            errorStatus = errorIndex = 0;
            memset(response_msg.buffer, 0x00, MAX_SNMPMSG_LEN);

            // Received message parsing and send response process
            if (parseSNMPMessage() != -1) {
                sendto(SOCK_SNMP_AGENT, response_msg.buffer, response_msg.index,
                       svr_addr, svr_port, 4);
            }
        }
        break;

    case SOCK_CLOSED :
        if ((ret = socket(SOCK_SNMP_AGENT, Sn_MR_UDP,
                          PORT_SNMP_AGENT, 0x00)) != SOCK_SNMP_AGENT) {
            return ret;
        }
        printf(" - [%d] UDP Socket for SNMP Agent, port [%d]\r\n",
               SOCK_SNMP_AGENT, PORT_SNMP_AGENT);
        break;

    default :
        break;
    }

    return 1;
}

测试前提

测试实例需要 PC 端（运行 MIB Browser）和 W6300 处于同一网段。W6300 需先完成网络初始化（如通过 DHCP 获取 IP 地址）。