PeripheralDevicePackage.idl

/* SPDX-License-Identifier: BSD-3-Clause */
/*
 * Copyright 2013 Raritan Inc. All rights reserved.
 */
 
#ifndef __PERIPHERAL_DEVICE_PACKAGE_IDL__
#define __PERIPHERAL_DEVICE_PACKAGE_IDL__
 
#include <PeripheralDeviceSlot.idl>
 
/** Peripheral Devices */
module peripheral {
    /** Peripheral device package information */
    structure PackageInfo {
        enumeration State {
            NORMAL,         ///< Device package is in normal operation
            FW_UPDATE,      ///< Device package's firmware is being updated
            INTERNAL_ERROR, ///< Device package's internal error flag is set
            CONFIG_ERROR    ///< Device package's internal configuration is invalid
        };
 
        structure HardwareInfo {
            string  serial;                 ///< serial number
            string  packageClass;           ///< serial number prefix for current packages
            string  model;                  ///< like 'DPX-CC2' or 'DX-D2C6'
            int     minDowngradeVersion;    ///< minimum downgrade version (or -1)
            string  revision;               ///< hardware revision
        };
 
        structure FirmwareInfo {
            structure Version {
                int majorNumber;            ///< firmware version encoded as 'major << 4 | minor'
                int minorNumber;            ///< depreceated, was minor firmware version
                int bootloaderVersion;      ///< device bootloader version
            };
 
            time    compileDate;    ///< Date of firmware compilation (Deprecated: always returns 0)
            Version version;        ///< Firmware version (0.0 if not applicable)
            time    updateDate;     ///< Date of device firmware update (Deprecated: always returns 0)
        };
 
        State               state;              ///< The peripheral device package operational state
        vector<PosElement> position;      ///< Position within 1-wire topo
        HardwareInfo        hwInfo;             ///< Device package hardware specific information
        FirmwareInfo        fwInfo;             ///< Device package firmware specific information
    };
 
    interface Package {
        PackageInfo getPackageInfo();
    };
 
    interface DoorHandleControllerPackage extends Package {
 
        constant int SUCCESS = 0;
        constant int ERR_NOT_SUPPORTED = 1;
        constant int ERR_OPERATION_FAILED = 2;
 
        vector<string> getSupportedHandleTypes();
        vector<string> getSupportedExternalDeviceTypes();
 
        string getHandleType(in int channel);
        string getExternalDeviceType(in int channel);
 
        int setHandleType(in int channel, in string handleType);
        int setExternalDeviceType(in int channel, in string type);
 
    };
}
 
#endif /* !__PERIPHERAL_DEVICE_PACKAGE_IDL__ */