Bitfocus AS
logo
logo
Bitfocus AS
logo
logo

Loading...

Bitfocus

Subscribe to our newsletter

The latest news, articles, and resources, sent to your inbox.

FacebookInstagramGitHubYouTubeLinkedIn

Products

  • Buttons
  • Companion

Integrations

  • Supported Devices
  • Developer Community
  • Connection Development

Support

  • Support Overview
  • Documentation
  • Video Tutorials
  • Community Forum

Sales

  • Resellers & Integrators
  • Buttons Pricing

Updates

  • Case Studies
  • Events & Trade Shows
  • Press Releases
  • Product Updates
  • Webinars

Legal

  • Legal Overview
  • Privacy Policy
  • Buttons EULA
  • Terms & Cookie Policy

Company

  • About us
  • Press kit
  • Careers
Co-funded by the European Union

Our Bitfocus Workflow 2.0 project is co-funded by the European Union’s Creative Europe programme. About the project

© 2026 Bitfocus AS. All rights reserved.

  1. Connections
  2. Generic - SNMP Requests

Generic

SNMP Requests

Communityv3.2.1Updated last monthProtocols
DocumentationReport an issueView on GitHub

Documentation

companion-module-generic-snmp

Generic modules is only for use with custom applications. If you use this module to control a device or software on the market that more than you are using, please let us know about this software, so we can make a proper module for it. If we already support this and you use this to trigger a feature our module doesnt support, please let us know. We want companion to be as easy as possible to use for anyone.

Configuration

To configure this module you will need:

  1. Agent Address - The IP Address of the SNMP enabled device you want to control
  2. UDP Port - The number of the UDP port on which the agent is listening (defaults to port 161)
  3. SNMP Version - The version of SNMP used by the agent. This will dictate how this module will authenticate with the agent
  4. Listen for Traps - Enable to bind to a port for SNMP Traps and Informs
  5. Listening Port - Port to listen for traps and informs on. The module will ignore messages from IPs other than the configured Agent Address.
  6. Poll Interval - The poll interval for Get OID value actions with update enabled, and all Get OID Value feedbacks.
  7. Walk OIDs - If populated, the agent will walk the MIB starting at the OIDs in this comma seperated list.
  8. Connection Variables - Create connection variables for all cached OIDs, they will be polled each interval. Compared to the OID Value feedback, OctetString and Opaque VarBind encoding is fixed to utf8 and numeric values have a fixed factor of 1.

SNMP versions v1/v2c

If you selected SNMP version v1 or v2c you will also need to configure a community string with suffucient access for the actions you wish to perform.

SNMP versions v3

If you selected SNMP version v3 you will also need to configure the following:

  1. Engine ID - The agent's SNMP Engine ID (required)
  2. User Name - A username with suffucient access for the actions you wish to perform.
  3. Security Level - Whether to implement authentication and encryption
    • noAuthNoPriv - No message authentication or encryption
    • authNoPriv - Message authentication and no encryption
    • authPriv - Message authentication and encryption
  4. Auth Protocol - The message authentication protocol. (Available if Security Level is authNoPriv or authPriv)
    • No Auth - use if your agent's security level is noAuthNoPriv
    • MD5 - for MD5 message authentication (HMAC-MD5-96)
    • SHA - for SHA-1 message authentication (HMAC-SHA-1)
    • SHA224 - for SHA-224 message authentication (HMAC-SHA-224)
    • SHA256 - for SHA-256 message authentication (HMAC-SHA-256)
    • SHA384 - for SHA-384 message authentication (HMAC-SHA-384)
    • SHA512 - for SHA-512 message authentication (HMAC-SHA-512)
  5. Auth Key - The message authentication key. (Available if Security Level is authNoPriv or authPriv)
  6. Priv Protocol - The encryption algorith. (Available if Security Level is authPriv)
    • No Priv - use if your agent's security level is AuthNoPriv
    • AES - for 128-bit AES encryption (CFB-AES-128)'
    • AES256B - for 256-bit AES encryption (CFB-AES-256) with "Blumenthal" key localiztaion
    • AES256R - 256-bit AES encryption (CFB-AES-256) with "Reeder" key localiztaion
    • DES - for DES encryption (CBC-DES).
  7. Priv Key - Encryption Key (Available if Security Level is authPriv)

Actions

You can perform the following actions with this module:

  • Get OID value, return to custom or local variable
    • OctetString and Opaque OIDs converted to strings with the encoding option
    • Numeric values may be divided by the Factor field to achieved fixed precision decimal values
    • Counter64 OIDs returned as strings
  • Send Trap or Inform message
  • Set OID value to an OctetString
  • Set OID value to a Number. This includes the following SNMP Object Types:
    • Integer
    • Counter
    • Gauge
    • TimeTicks
  • Set OID value to a Boolean
  • Set OID value to an IP Address
  • Set OID value to an OID
  • Set OID value to an Opaque
  • Walk MIB starting from OID

Feedbacks

  • OID value
    • Optional update based on connection poll
    • Always updated via SNMP Trap
    • OctetString and Opaque OIDs converted to strings with the encoding option
    • Numeric values may be divided by the Factor field to achieved fixed precision decimal values
    • Counter64 OIDs returned as strings

Details

Manufacturer
Generic
Product
SNMP Requests
Latest Version
v3.2.1
Authors
Johnny Estilles
Phillip Ivan Pietruschka
Contributors
phillipivan(217)
estilles(9)
mamanakis(1)
peternewman(1)

Open Issues and Requests

To file a new issue, you need to sign up for a user on GitHub.

Go to GitHub issues →

In other news

Buttons v1.10 MCP webinar

Webinar Buttons v1.10 - MCP

November 17, 2026

Security Advisory

Buttons Security Advisory - CVE-2026-111497

October 26, 2026

Webinar Buttons v1.8

Webinar Buttons v1.8 Release

October 13, 2026

Buttons v1.8 Main with text

Buttons v1.8

October 2, 2026

View all news →

More from Generic

AES70

Generic

Community
View Connection

Art-Net

Generic

Community
Protocols
View Connection

Bridge

Generic

Community
View Connection

Data Entry

Generic

Community
View Connection

Ember

Generic

Community
View Connection

Ember+

Generic

Community
Protocols
View Connection