snmp_trap

#include <rtl.h>

BOOL snmp_trap (
    U8*  man_ip,       /* Pointer to the IP address of Trap Manager. */
    U8   gen_trap,     /* Generic Trap value. */
    U8   spec_trap,    /* Specific Trap value. */
    U16* obj_list );   /* Pointer to the list of objects. */

The snmp_trap function sends a trap message to the Trap Manager. Parameter man_ip specifies the IP address of the Trap server, where the trap message is destined to. If the IP address of the Trap Manager is not specified (parameter man_ip is NULL), the IP address of Trap Server configured in Net_Config.c is used instead.

Parameter gen_trap specifies the generic trap type:

Parameter spec_trap specifies the specific trap type. It must be set to 0 for all generic traps from 0 to 5. It defines a specific trap type for generic enterpriseSpecific trap.

Parameter obj_list specifies the objects from the MIB table, which will be included in the trap message variable-bindings. This parameter is a pointer to the object list array. This array is of variable size. The first element specifies the count of objects in the object list array, followed by the object MIB index values.

If obj_list parameter is NULL, or obj[0] = 0, no object values will be binded to the trap message.

The snmp_trap function is a system function that is in the RL-TCPnet library. The prototype is defined in net_config.h.

• The maximum number of objects that can be binded to the trap message is limited to 20 objects.

The snmp_trap function returns __TRUE when the SNMP trap message has been sent successfully. On error, this function returns __FALSE.

snmp_set_community

void send_alarm (void) {
  /* Send a trap message when alarm input is activated.*/
  U16 obj[2];

  /* Add "KeyIn" value to trap message. */
  obj[0] = 1;
  obj[1] = 8;    /* Index of "KeyIn" entry in MIB table. */
  snmp_trap (NULL, 6, 1, obj);
}