git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2021 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   7  * This program and the accompanying materials are made available under the
   8  * terms of the Eclipse Public License 2.0 which is available at
   9  * http://www.eclipse.org/legal/epl-2.0
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.binding.onkyo.internal.eiscp;
  14
  15 /**
  16  * Represents all possible eISCP commands.
  17  *
  18  * @author Thomas.Eichstaedt-Engelen - initial contribution
  19  * @author Pauli Anttila - add additional commands
  20  * @author Paul Frank - update for openHAB 2
  21  * @author Marcel Verpaalen - fix issues with some Zone 2 commands
  22  */
  23 public enum EiscpCommand {
  24
  25     // Main zone
  26
  27     POWER_QUERY("PWR", "QSTN"),
  28     POWER_SET("PWR", "%02X"),
  29     POWER("PWR", ""),
  30
  31     MUTE_QUERY("AMT", "QSTN"),
  32     MUTE_SET("AMT", "%02X"),
  33     MUTE("AMT", ""),
  34
  35     VOLUME_UP("MVL", "UP"),
  36     VOLUME_DOWN("MVL", "DOWN"),
  37     VOLUME_QUERY("MVL", "QSTN"),
  38     VOLUME_SET("MVL", "%02X"),
  39     VOLUME("MVL", ""),
  40
  41     AUDIOINFO("IFA", ""),
  42     AUDIOINFO_QUERY("IFA", "QSTN"),
  43
  44     SOURCE_UP("SLI", "UP"),
  45     SOURCE_DOWN("SLI", "DOWN"),
  46     SOURCE_QUERY("SLI", "QSTN"),
  47     SOURCE_SET("SLI", "%02X"),
  48     SOURCE("SLI", ""),
  49
  50     LISTEN_MODE_UP("LMD", "UP"),
  51     LISTEN_MODE_DOWN("LMD", "DOWN"),
  52     LISTEN_MODE_QUERY("LMD", "QSTN"),
  53     LISTEN_MODE_SET("LMD", "%02X"),
  54     LISTEN_MODE("LMD", ""),
  55
  56     INFO_QUERY("NRI", "QSTN"),
  57     INFO("NRI", ""),
  58
  59     NETUSB_OP_PLAY("NTC", "PLAY"),
  60     NETUSB_OP_STOP("NTC", "STOP"),
  61     NETUSB_OP_PAUSE("NTC", "PAUSE"),
  62     NETUSB_OP_TRACKUP("NTC", "TRUP"),
  63     NETUSB_OP_TRACKDWN("NTC", "TRDN"),
  64     NETUSB_OP_FF("NTC", "FF"),
  65     NETUSB_OP_REW("NTC", "REW"),
  66     NETUSB_OP_REPEAT("NTC", "REPEAT"),
  67     NETUSB_OP_RANDOM("NTC", "RANDOM"),
  68     NETUSB_OP_DISPLAY("NTC", "DISPLAY"),
  69     NETUSB_OP_RIGHT("NTC", "RIGHT"),
  70     NETUSB_OP_LEFT("NTC", "LEFT"),
  71     NETUSB_OP_UP("NTC", "UP"),
  72     NETUSB_OP_DOWN("NTC", "DOWN"),
  73     NETUSB_OP_SELECT("NTC", "SELECT"),
  74     NETUSB_OP_1("NTC", "1"),
  75     NETUSB_OP_2("NTC", "2"),
  76     NETUSB_OP_3("NTC", "3"),
  77     NETUSB_OP_4("NTC", "4"),
  78     NETUSB_OP_5("NTC", "5"),
  79     NETUSB_OP_6("NTC", "6"),
  80     NETUSB_OP_7("NTC", "7"),
  81     NETUSB_OP_8("NTC", "8"),
  82     NETUSB_OP_9("NTC", "9"),
  83     NETUSB_OP_0("NTC", "0"),
  84     NETUSB_OP_DELETE("NTC", "DELETE"),
  85     NETUSB_OP_CAPS("NTC", "CAPS"),
  86     NETUSB_OP_SETUP("NTC", "SETUP"),
  87     NETUSB_OP_RETURN("NTC", "RETURN"),
  88     NETUSB_OP_CHANUP("NTC", "CHUP"),
  89     NETUSB_OP_CHANDWN("NTC", "CHDN"),
  90     NETUSB_OP_MENU("NTC", "MENU"),
  91     NETUSB_OP_TOPMENU("NTC", "TOP"),
  92
  93     NETUSB_SONG_ARTIST_QUERY("NAT", "QSTN"),
  94     NETUSB_SONG_ARTIST("NAT", ""),
  95     NETUSB_SONG_ALBUM_QUERY("NAL", "QSTN"),
  96     NETUSB_SONG_ALBUM("NAL", ""),
  97     NETUSB_SONG_TITLE_QUERY("NTI", "QSTN"),
  98     NETUSB_SONG_TITLE("NTI", ""),
  99     NETUSB_SONG_ELAPSEDTIME_QUERY("NTM", "QSTN"),
 100     NETUSB_SONG_ELAPSEDTIME("NTM", ""),
 101     NETUSB_SONG_TRACK_QUERY("NTR", "QSTN"),
 102     NETUSB_SONG_TRACK("NTR", ""),
 103     NETUSB_PLAY_STATUS_QUERY("NST", "QSTN"),
 104     NETUSB_PLAY_STATUS("NST", ""),
 105
 106     NETUSB_MENU_SELECT("NLS", "L%X"),
 107     NETUSB_MENU("NLS", ""),
 108
 109     NETUSB_TITLE("NLT", ""),
 110     NETUSB_TITLE_QUERY("NLT", "QSTN"),
 111
 112     NETUSB_ALBUM_ART_QUERY("NJA", "REQ"),
 113     NETUSB_ALBUM_ART("NJA", ""),
 114
 115     /*
 116      * Zone 2
 117      */
 118
 119     ZONE2_POWER_QUERY("ZPW", "QSTN"),
 120     ZONE2_POWER_SET("ZPW", "%02X"),
 121     ZONE2_POWER("ZPW", ""),
 122
 123     ZONE2_MUTE_QUERY("ZMT", "QSTN"),
 124     ZONE2_MUTE_SET("ZMT", "%02X"),
 125     ZONE2_MUTE("ZMT", ""),
 126
 127     ZONE2_VOLUME_UP("ZVL", "UP"),
 128     ZONE2_VOLUME_DOWN("ZVL", "DOWN"),
 129     ZONE2_VOLUME_QUERY("ZVL", "QSTN"),
 130     ZONE2_VOLUME_SET("ZVL", "%02X"),
 131     ZONE2_VOLUME("ZVL", ""),
 132
 133     ZONE2_SOURCE_UP("SLZ", "UP"),
 134     ZONE2_SOURCE_DOWN("SLZ", "DOWN"),
 135     ZONE2_SOURCE_QUERY("SLZ", "QSTN"),
 136     ZONE2_SOURCE_SET("SLZ", "%02X"),
 137     ZONE2_SOURCE("SLZ", ""),
 138
 139     /*
 140      * Zone 3
 141      */
 142
 143     ZONE3_POWER_QUERY("PW3", "QSTN"),
 144     ZONE3_POWER_SET("PW3", "%02X"),
 145     ZONE3_POWER("PW3", ""),
 146
 147     ZONE3_MUTE_QUERY("MT3", "QSTN"),
 148     ZONE3_MUTE_SET("MT3", "%02X"),
 149     ZONE3_MUTE("MT3", ""),
 150
 151     ZONE3_VOLUME_UP("VL3", "UP"),
 152     ZONE3_VOLUME_DOWN("VL3", "DOWN"),
 153     ZONE3_VOLUME_QUERY("VL3", "QSTN"),
 154     ZONE3_VOLUME_SET("VL3", "%02X"),
 155     ZONE3_VOLUME("VL3", ""),
 156
 157     ZONE3_SOURCE_UP("SL3", "UP"),
 158     ZONE3_SOURCE_DOWN("SL3", "DOWN"),
 159     ZONE3_SOURCE_QUERY("SL3", "QSTN"),
 160     ZONE3_SOURCE_SET("SL3", "%02X"),
 161     ZONE3_SOURCE("SL3", "");
 162
 163     public static enum Zone {
 164         MAIN,
 165         ZONE1,
 166         ZONE2,
 167         ZONE3
 168     }
 169
 170     private String command;
 171     private String value;
 172
 173     private EiscpCommand(String command, String value) {
 174         this.command = command;
 175         this.value = value;
 176     }
 177
 178     /**
 179      * @return the iscp command string (example 'PWR')
 180      */
 181     public String getCommand() {
 182         return command;
 183     }
 184
 185     /**
 186      * @return the iscp value string (example 'QSTN')
 187      */
 188     public String getValue() {
 189         return value;
 190     }
 191
 192     public static EiscpCommand getCommandForZone(Zone zone, EiscpCommand baseCommand) throws IllegalArgumentException {
 193         if (zone == Zone.MAIN || zone == Zone.ZONE1) {
 194             return baseCommand;
 195         } else {
 196             return EiscpCommand.valueOf(zone.toString() + "_" + baseCommand);
 197         }
 198     }
 199
 200     /**
 201      * @param command the command to find a matching command name for.
 202      * @return the commandName that is associated with the passed command.
 203      */
 204     public static EiscpCommand getCommandByCommandStr(String command) throws IllegalArgumentException {
 205         for (EiscpCommand candidate : values()) {
 206             if (candidate.getCommand().equals(command)) {
 207                 return candidate;
 208             }
 209         }
 210         throw new IllegalArgumentException("There is no matching commandName for command '" + command + "'");
 211     }
 212
 213     /**
 214      * @param command the command to find a matching command name for.
 215      * @param value the value to find a matching value for.
 216      *
 217      * @return the commandName that is associated with the passed command.
 218      */
 219     public static EiscpCommand getCommandByCommandAndValueStr(String command, String value)
 220             throws IllegalArgumentException {
 221         for (EiscpCommand candidate : values()) {
 222             if (candidate.getCommand().equals(command) && candidate.getValue().equals(value)) {
 223                 return candidate;
 224             }
 225         }
 226         throw new IllegalArgumentException(
 227                 "There is no matching commandName for command '" + command + "' and value '" + value + "'");
 228     }
 229 }