RFC 2325

Definitions of Managed Objects for Drip-Type Heated Beverage Hardware Devices using SMIv2

πŸ“… published April 1998, from ietf

RFC 2325: Definitions of Managed Objects for Drip-Type Heated Beverage Hardware Devices using SMIv2 β˜•βœ¨

Okay bestie, the title block first! πŸ’… This one is an Informational RFC by M. Slavitch of Loran Technologies Inc., dated 1 April 1998, and it's from the Network Working Group. It's not a standard, it's just info for the Internet community. The header doesn't list any Obsoletes or Updates lines, so it doesn't replace or change any other RFC. Iconic restraint πŸ¦‹

Full title: Definitions of Managed Objects for Drip-Type Heated Beverage Hardware Devices using SMIv2 πŸŽ€

Network Working Group                                       M. Slavitch
Request for Comments: 2325                      Loran Technologies Inc.
Category: Informational                                    1 April 1998

Status of This Memo 🌸

Okay so this memo gives info to the Internet community. It doesn't specify an Internet standard of any kind, and distribution of it is unlimited. Share it with everyone, babe πŸ’–

Copyright (C) The Internet Society (1998). All Rights Reserved.

Table of Contents 🧚

   1. Introduction ...............................................    1
   2. The SNMPv2 Network Management Framework ....................    1
   2.1 Object Definitions ........................................    2
   3. Overview ...................................................    2
   3.1 Relationship to Interface MIB .............................    2
   4. Definitions ................................................    3
   5. Acknowledgements ...........................................    6
   6. References .................................................    6
   7. Security Considerations ....................................    6
   8. Author's Address ...........................................    7
   9. Full Copyright Statement ...................................    8

1. Introduction ✨

This memo adds an extension to the Management Information Base (MIB) for use with network management protocols in the Internet community. Specifically, it defines objects for managing coffee-brewing and maintenance devices. It's giving network management, but make it caffeinated β˜•πŸ’…

2. The SNMPv2 Network Management Framework πŸ¦‹

The SNMPv2 Network Management Framework has four major components, and they are:

  • RFC 1442 [1], which defines the SMI, the mechanisms used for describing and naming objects for management purposes.
  • STD 17, RFC 1213 [2], which defines MIB-II, the core set of managed objects for the Internet suite of protocols.
  • RFC 1445 [3], which defines the administrative and other architectural aspects of the framework.
  • RFC 1448 [4], which defines the protocol used for network access to managed objects.

The Framework allows new objects to be defined for experimentation and evaluation. Iykyk πŸ§ͺ

2.1. Object Definitions 🌈

Managed objects are accessed through a virtual information store, called the Management Information Base or MIB. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI. Each object type is named by an OBJECT IDENTIFIER, which is an administratively assigned name. The object type together with an object instance uniquely identifies one specific instantiation of the object. For human convenience, we often use a textual string, called the descriptor, to refer to the object type. Descriptors are so helpful, no cap πŸ™ˆ

3. Overview πŸ“

The COFFEE POT MIB applies to managed devices that brew, store, and deliver heated coffee beverages. The COFFEE POT MIB is mandatory for all systems that have such a hardware port supporting services managed through some other MIB. Main character energy πŸ‘‘

The MIB contains objects related to physical connections, configuration, storage levels, availability, quality of service, and availability. Yes, availability is listed twice, and yes, I noticed πŸ’€

3.1. Relationship to Interface MIB πŸ’œ

The COFFEE-POT-MIB is one of many MIBs designed for layered use, as described in the Interface MIB [5]. In most implementations where it is present, it will be in the lowest interface sublayer. That means the COFFEE-POT-MIB represents the physical layer, providing service to higher layers such as the Character MIB [6]. It's the foundation, bestie 🧱✨

Although it is unlikely that a coffee port will actually be used as a network interface, which is what the Interface MIB is intended for, the COFFEE-POT-MIB is closely connected to the Character MIB. The Character MIB can share hardware interfaces with network operation, and it relates to the RS-232 MIB [7]. The vibes are a little chaotic, but it works 😭

The Interface MIB's ifTestTable and ifRcvAddressTable are not relevant to the COFFEE-POT-MIB. Not them being irrelevant πŸ™…β€β™€οΈ

The COFFEE-POT-MIB is relevant for ifType values sip(31), and perhaps others. 🫢

The COFFEE-POT-MIB requires the conformance groups ifGeneralGroup and ifFixedLengthGroup.

Usefulness of error counters in this MIB depends on the octet counters in ifFixedLengthGroup. Ate that dependency, periodt πŸ’…

4. Definitions πŸŽ€

Here's the whole MIB module, copied exactly, so don't touch it 🫢

   COFFEE-POT-MIB DEFINITIONS ::= BEGIN

   IMPORTS
       MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
       TimeStamp, TimeInterval,
       Counter32, Integer32
           FROM SNMPv2-SMI
       InterfaceIndex
           FROM IF-MIB
       transmission
           FROM RFC1213-MIB
       MODULE-COMPLIANCE, OBJECT-GROUP
           FROM SNMPv2-CONF;

   coffee MODULE-IDENTITY
        LAST-UPDATED "9803231700Z"
        ORGANIZATION "Networked Appliance Management Working Group"

        CONTACT-INFO
               "        Michael Slavitch
                        Loran Technologies,
                        955 Green Valley Crescent
                        Ottawa, Ontario Canada K2A 0B6

                   Tel: 613-723-7505
                   Fax: 613-723-7209
                E-mail: slavitch@loran.com"
        DESCRIPTION
               "The MIB Module for coffee vending devices."
       ::= { transmission 132 }

   potName OBJECT-TYPE
        SYNTAX     DisplayString (SIZE (0..255))
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The vendor description of the pot under management"
        ::= { coffee 1 }


   potCapacity OBJECT-TYPE
        SYNTAX Integer32
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
           "The number of units of beverage supported by this device
            (regardless of its current state) ."
       ::= { coffee 2 }


   potType OBJECT-TYPE
        SYNTAX     INTEGER {
           automatic-drip(1),
           percolator(2),
           french-press(3),
           espresso(4),
           }
        MAX-ACCESS read-write
        STATUS current
        DESCRIPTION
                "The brew type of the coffee pot."
        ::= { coffee 3 }

   potLocation OBJECT-TYPE {
        SYNTAX     DisplayString (SIZE (0..255))
        MAX-ACCESS read-write
        STATUS current
        DESCRIPTION
                "The physical location of the pot in question"
        ::= { coffee 4 }


   potMonitor            OBJECT IDENTIFIER ::= { coffee 6 }


   potOperStatus
        SYNTAX     Integer {
                        off(1),
                        brewing(2),
                        holding(3),
                        other(4),
                        waiting(5)
                        }
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The operating status of the pot in question. Note
                 that this is a read-only feature. Current hardware
                 prevents us from changing the port state via SNMP."
        ::= { potMonitor 1 }

    potLevel OBJECT-TYPE
        SYNTAX     Integer32
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The number of units of coffee under management. The
                 units of level are defined in potMetric below."
        ::= { potMonitor 2 }

    potMetric  OBJECT-TYPE
        SYNTAX     Integer {
                    espresso(1),
                    demi-tasse(2),
                    cup(3),
                    mug(4),
                    bucket(5)
                    }
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The vendor description of the pot under management"
        ::= { potMonitor 3 }


   potStartTime OBJECT-TYPE
       SYNTAX     Integer64
       MAX-ACCESS read-write
       STATUS     current
       DESCRIPTION
               "The time in seconds since Jan 1 1970 to start the pot
                if and only if potOperStatus is waiting(5)"
       ::= { potMonitor 4 }


    lastStartTime OBJECT-TYPE
       SYNTAX     TimeInterval
       MAX-ACCESS read-only
       STATUS     current
       DESCRIPTION

               "The amount of time, in TimeTicks, since the coffee
               making process was initiated."
       ::= { potMonitor 5 }


    potTemperature OBJECT-TYPE
       SYNTAX     Integer32
       UNITS      "degrees Centigrade"
       MAX-ACCESS read-only
       STATUS     current
       DESCRIPTION
               "The ambient temperature of the coffee within the pot"

      ::= { potMonitor 6 }

   END

5. Acknowledgements 🫢

Thanks to the Networked Appliance Management Working Group (not) of the IETF. The "(not)" is in the original, and I'm keeping it πŸ™ˆ

6. References πŸ“š

  • [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure of Management Information for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1442, April 1993.
  • [2] McCloghrie, K., and M. Rose, Editors, "Management Information Base for Network Management of TCP/IP-based internets: MIB-II", STD 17, RFC 1213, March 1991.
  • [3] Galvin, J., and K. McCloghrie, "Administrative Model for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445, April 1993.
  • [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1448, April 1993.
  • [5] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces Group of MIB-II", RFC 1573, January 1994.
  • [6] Valdez, Juan, "Definitions of Columbian Objects for Coffee Pot Devices using SMIv2", Columbia, Inc., March 1998.

7. Security Considerations πŸ”’

Security issues are not discussed in this memo. Okay, so that's the whole security section, and it's a lot of nothing πŸ’€ Stay safe out there anyway 🌈

8. Author's Address πŸ’Œ

Michael Slavitch Loran Technologies 955 Green Valley Crescent Ottawa, Ontario Canada K2C 3V4

Phone: 613 723 7505 EMail: slavitch@loran.com

Copyright (C) The Internet Society (1998). All Rights Reserved.

Okay, here's the legal bit, and it's giving serious. This document and translations of it may be copied and furnished to others. Derivative works that comment on or otherwise explain it, or help with implementing it, may be prepared, copied, published, and distributed, in whole or in part, without any restriction, as long as the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations. The exceptions are when it's needed for developing Internet standards, in which case the copyright procedures in the Internet Standards process must be followed, or when it's needed to translate it into languages other than English.

The limited permissions above are perpetual and will not be revoked by the Internet Society or its successors or assigns.

This document and the information in it are provided on an "AS IS" basis. THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. πŸ’–

πŸ“¦ where this page comes from