org.jmythapi.protocol
Enum ProtocolVersion

java.lang.Object
  java.lang.Enum<ProtocolVersion>
      org.jmythapi.protocol.ProtocolVersion

All Implemented Interfaces:

Serializable, Comparable<ProtocolVersion>, IVersion

public enum ProtocolVersion
extends Enum<ProtocolVersion>
implements IVersion

This enumeration specifies all supported MythTV-protocol versions.

Protocol Versions:

Depending on the MythTV protocol version that a backend is speaking, different protocol commands are supported and the required request- and received response-parameters may be different.

On server side the protocol-version a specific MythTV-version is using is defined in the MythTV file mythversion.h.
On jMythAPI side each object which is protocol-version-aware need to implement the interface IVersionable. With this interface the currently used protocol-version can be determined when sending or receiving request or response messages. Depending on the used version, the content of request-messages to be send is formatted differently, or a received response-message is interpreted differently.

Protocol Version Ranges:

In which protocol versions an command or a request- or response-parameter is supported, is specified via the MythProtoVersionAnnotation. This annotation is used to define the range of protocol version a given request or parameter is valid. This lower and upper bound versions are additionally documented with the @since and the @deprecated javadoc tag.
Furthermore there is a special javadoc-taglet @mythProtoVersionRange, which that generates an additional table in javadoc, showing the protocol-range of an element including some metadata about the protocol- versions, e.g. the commit date or a link to the Git revision when the element was added or removed to the protocol. See here for an example.

There are two special protocol versions:

• PROTO_VERSION_00: represents all versions before the command MYTH_PROTO_VERSION was introduced.
• PROTO_VERSION_LATEST: represents the current trunk version.

If a protocol element (a request command or response property) is supported from version 00 to version -1, the given element is supported in all known protocol version.

Protocol Changelog:

See the javadoc for the various enumeration constants to see, which changes were done for a given protocol version.
E.g. in PROTO_VERSION_37 multiple protocol-commands were added and removed, some response-message properties were added, and some new flags were introduced.

Usage Examples:

Comparing of protocol versions:

In the following example the backend method queryUptime was introduced in protocol version 15, therefore the function can not be used with prior protocol versions.

    IBackend backend = ...; // an already connected backend
    
    // starting with protocol version 15 the backend uptime can be queried
    if(backend.getVersionNr().compareTo(ProtocolVersion.PROTO_VERSION_15)>=0) {
       IUptime uptime = backend.queryUptime();
       System.out.println(String.format(
          "MythTV has an uptime of %s seconds.",
          uptime.getUptimeSeconds()
       ));
    }
 

See Also:

libmythbase/mythversion.h, libmythdb/mythversion.h, libmyth/mythcontext.h, Wiki

Enum Constant Summary

PROTO_VERSION_00
All MythTV Version before 2004-01-29.

PROTO_VERSION_01
MythTV Release Version 0.14 - 2004-01-29.

PROTO_VERSION_02
MythTV Development Version 2004-02-03.

PROTO_VERSION_03
MythTV Development Version 2004-02-05.

PROTO_VERSION_04
MythTV Development Version 2004-02-27.

PROTO_VERSION_05
MythTV Development Version 2004-04-10.

PROTO_VERSION_06
MythTV Development Version 2004-05-01.

PROTO_VERSION_07
MythTV Development Version 2004-05-08.

PROTO_VERSION_08
MythTV Release Version 0.15 - 2004-05-09.

PROTO_VERSION_09
MythTV Development Version 2004-06-04.

PROTO_VERSION_10
MythTV Development Version 2004-07-01.

PROTO_VERSION_11
MythTV Development Version 2004-07-06.

PROTO_VERSION_12
MythTV Development Version 2004-07-10.

PROTO_VERSION_13
MythTV Release Version 0.16 - 2004-08-16.

PROTO_VERSION_14
MythTV Release Version 0.17 - 2004-10-06.

PROTO_VERSION_15
MythTV Release Version 0.18 - 2005-03-23.

PROTO_VERSION_16
MythTV Development Version 2005-05-03.

PROTO_VERSION_17
MythTV Development Version 2005-05-24.

PROTO_VERSION_18
MythTV Development Version 2005-07-19.

PROTO_VERSION_19
MythTV Development Version 2005-10-09.

PROTO_VERSION_20
MythTV Development Version 2005-11-05.

PROTO_VERSION_21
MythTV Development Version 2005-11-10.

PROTO_VERSION_22
MythTV Development Version 2005-11-15.

PROTO_VERSION_23
MythTV Development Version 2006-01-10.

PROTO_VERSION_23056
MythTV Bugfix Version 0.23.1 - 2010-07-17.

PROTO_VERSION_24
MythTV Development Version 2006-01-15.

PROTO_VERSION_25
MythTV Development Version 2006-01-17.

PROTO_VERSION_26
MythTV Release Version 0.19 - 2006-01-17.

PROTO_VERSION_27
MythTV Development Version 2006-02-15.

PROTO_VERSION_28
MythTV Development Version 2006-03-28.

PROTO_VERSION_29
MythTV Development Version 2006-04-01.

PROTO_VERSION_30
MythTV Release Version 0.20 - 2006-05-22.

PROTO_VERSION_31
MythTV Release Version 0.20-fixes - 2006-09-24.

PROTO_VERSION_32
MythTV Development Version 2006-11-30.

PROTO_VERSION_33
MythTV Development Version 2007-03-01.

PROTO_VERSION_34
MythTV Development Version 2007-04-13.

PROTO_VERSION_35
MythTV Development Version 2007-07-16.

PROTO_VERSION_36
MythTV Development Version 2007-09-11.

PROTO_VERSION_37
MythTV Development Version 2008-01-14.

PROTO_VERSION_38
MythTV Development Version 2008-01-23.

PROTO_VERSION_39
MythTV Release Version 0.21 - 2008-01-31.

PROTO_VERSION_40
MythTV Development Version 2008-02-17.

PROTO_VERSION_41
MythTV Development Version 2008-09-25.

PROTO_VERSION_42
MythTV Development Version 2008-10-07.

PROTO_VERSION_43
MythTV Development Version 2008-12-22.

PROTO_VERSION_44
MythTV Development Version 2009-02-12.

PROTO_VERSION_45
MythTV Development Version 2009-05-09.

PROTO_VERSION_46
MythTV Development Version 2009-08-08.

PROTO_VERSION_47
MythTV Development Version 2009-08-16.

PROTO_VERSION_48
MythTV Development Version 2009-08-23.

PROTO_VERSION_49
MythTV Development Version 2009-10-01.

PROTO_VERSION_50
MythTV Release Version 0.22 - 2009-10-02.

PROTO_VERSION_51
MythTV Development Version 2009-11-23.

PROTO_VERSION_52
MythTV Development Version 2009-11-30.

PROTO_VERSION_53
MythTV Development Version 2009-12-06.

PROTO_VERSION_54
MythTV Development Version 2009-12-18.

PROTO_VERSION_55
MythTV Development Version 2009-12-21.

PROTO_VERSION_56
MythTV Release Version 0.23 - 2009-12-29.

PROTO_VERSION_57
MythTV Development Version 2010-05-16.

PROTO_VERSION_58
MythTV Development Version 2010-07-17.

PROTO_VERSION_59
MythTV Development Version 2010-08-26.

PROTO_VERSION_60
MythTV Development Version 2010-09-03.

PROTO_VERSION_61
MythTV Development Version 2010-09-03.

PROTO_VERSION_62
MythTV Development Version 2010-09-13.

PROTO_VERSION_63
MythTV Release Version 0.24 - 2010-09-25.

PROTO_VERSION_64
MythTV Development Version 2010-11-20.

PROTO_VERSION_65
MythTV Development Version 2011-03-08.

PROTO_VERSION_66
MythTV Development Version 2011-05-25.

PROTO_VERSION_67
MythTV Development Version 2011-06-03.

PROTO_VERSION_68
MythTV Development Version 2011-07-09.

PROTO_VERSION_69
MythTV Development Version 2011-07-11.

PROTO_VERSION_70
MythTV Development Version 2011-11-30.

PROTO_VERSION_71
MythTV Development Version 2012-01-15.

PROTO_VERSION_72
MythTV Release Version 0.25 2012-01-29.

PROTO_VERSION_73
MythTV Development Version 2012-04-11.

PROTO_VERSION_74
MythTV Development Version 2012-05-09.

PROTO_VERSION_75
MythTV Release Version 0.26 2012-05-30.

PROTO_VERSION_76
MythTV Development Version 2012-11-23.

PROTO_VERSION_77
MythTV Release Version 0.27 Version 2013-01-01.

PROTO_VERSION_LATEST
MythTV Current Development Version.

Method Summary

static ProtocolVersion	getMaxVersion() Gets the maximum protocol version that is currently supported.
Map<String,String>	getMetaData() Gets some known metadata about the protocol version.
ProtocolVersion	getPredecessor() Gets the predecessor version of the current version.
ProtocolVersion	getSuccessor() Gets the successor version of the current version.
String	getToken() Gets the protocol version "handshake" token.
int	getVersion() Gets the protocol version number.
static ProtocolVersion	valueOf(int protoVersion) Gets the protocol-version whose value matches the given protocol version.
static ProtocolVersion	valueOf(String name) Returns the enum constant of this type with the specified name.
static ProtocolVersion[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

PROTO_VERSION_00

public static final ProtocolVersion PROTO_VERSION_00

All MythTV Version before 2004-01-29.

This version represents all versions before the command MYTH_PROTO_VERSION was introduced.

PROTO_VERSION_01

public static final ProtocolVersion PROTO_VERSION_01

MythTV Release Version 0.14 - 2004-01-29.

Protocol Changes:

• IMythCommand.MYTH_PROTO_VERSION added

Since:

2004-01-29

MythTV Protocol Version Info:

SVN-Rev.	3021
Git Commit	e6ffdd37481937e09ec7

PROTO_VERSION_02

public static final ProtocolVersion PROTO_VERSION_02

MythTV Development Version 2004-02-03.

Protocol Changes:

• IProgramRecordingType.Type.FIND_ONE_RECORD added

Since:

2004-02-03

MythTV Protocol Version Info:

SVN-Rev.	3078
Git Commit	bc9ecb5d63ca65b427a6

PROTO_VERSION_03

public static final ProtocolVersion PROTO_VERSION_03

MythTV Development Version 2004-02-05.

Protocol Changes:

• IMythCommand.GET_NEXT_FREE_RECORDER added
• IProgramInfo.Props.REC_GROUP added
• IProgramInfo.Props.CHAN_COMM_FREE added
• IProgramInfo.Props.REC_DUPS removed
• IProgramInfo.Props.DUP_IN added
• IProgramInfo.Props.DUP_METHOD added
• IProgramRecordingDupInType added

Since:

2004-02-05

MythTV Protocol Version Info:

SVN-Rev.	3112
Git Commit	13be2e34c22fa59d3874

PROTO_VERSION_04

public static final ProtocolVersion PROTO_VERSION_04

MythTV Development Version 2004-02-27.

Protocol Changes:

• IProgramRecordingStatus.Status.LOWER_REC_PRIORITY removed
• IProgramRecordingStatus.Status.CONFLICT added
• IProgramRecordingStatus.Status.MANUAL_CONFLICT removed
• IProgramRecordingStatus.Status.LATER_SHOWING added
• IProgramRecordingStatus.Status.AUTO_CONFLICT removed
• IProgramRecordingDupMethodType.Flags.DUP_ALLOW_EMPTY removed
• IProgramRecordingDupMethodType.Flags.DUP_EMPTY_SUB_DESC removed

Since:

2004-02-27

MythTV Protocol Version Info:

SVN-Rev.	3308 | 3170
Git Commit	e3f1508f4eb01052eded | 58d2f6ee7ee9455e97a9

PROTO_VERSION_05

public static final ProtocolVersion PROTO_VERSION_05

MythTV Development Version 2004-04-10.

Protocol Changes:

• IMythCommand.REACTIVATE_RECORDING added
• IMythCommand.REFRESH_BACKEND added

Since:

2004-04-10

MythTV Protocol Version Info:

SVN-Rev.	3503 | 3411 | 3412
Git Commit	fbb6c46dd476b974e641 | 451ddbb1a38ed00ba527 | 381f5afb2b7fe120a165

PROTO_VERSION_06

public static final ProtocolVersion PROTO_VERSION_06

MythTV Development Version 2004-05-01.

Protocol Changes:

• IProgramInfo.Props.CHANNEL_OUTPUT_FILTERS added

Since:

2004-05-01

MythTV Protocol Version Info:

SVN-Rev.	3589
Git Commit	7038088d7ff6bff8d178

PROTO_VERSION_07

public static final ProtocolVersion PROTO_VERSION_07

MythTV Development Version 2004-05-08.

• IProgramRecordingStatus.Status.MANUAL_OVERRIDE removed
• IProgramRecordingStatus.Status.DONT_RECORD added
• IProgramRecordingStatus.Status.OVERLAP removed
• IProgramRecordingType.Type.OVERRIDE_RECORD added
• IProgramRecordingType.Type.DONT_RECORD added

Since:

2004-05-08

MythTV Protocol Version Info:

SVN-Rev.	3617
Git Commit	443b50aad3e36e672fbf

PROTO_VERSION_08

public static final ProtocolVersion PROTO_VERSION_08

MythTV Release Version 0.15 - 2004-05-09.

Protocol Changes:

• IProgramInfo.Props.SERIES_ID added
• IProgramInfo.Props.PROGRAM_ID added
• IRecorderProgramInfo.Props.SERIES_ID added
• IRecorderProgramInfo.Props.PROGRAM_ID added
• IRecorderNextProgramInfo.Props.SERIES_ID added
• IRecorderNextProgramInfo.Props.PROGRAM_ID added

Since:

2004-05-09

MythTV Protocol Version Info:

SVN-Rev.	3621
Git Commit	ddc3ba7379051f63b642
MythTV-Release	0.15

PROTO_VERSION_09

public static final ProtocolVersion PROTO_VERSION_09

MythTV Development Version 2004-06-04.

Protocol Changes:

• IMythCommand.GET_FREE_RECORDER_COUNT added
• IProgramRecordingDupMethodType.Flags.DUP_CHECK_ID_ONLY added/removed
• IProgramRecordingSearchType added

Since:

2004-06-04

MythTV Protocol Version Info:

SVN-Rev.	3838 | 3623 | 3630
Git Commit	2543a5c99b83e0d2bb07 | 1fb379b36c98736aa93e | a78f200d95a39a8a3a72

PROTO_VERSION_10

public static final ProtocolVersion PROTO_VERSION_10

MythTV Development Version 2004-07-01.

Protocol Changes:

• IRecorderProgramInfo.Props.CHANNEL_OUTPUT_FILTERS added.

Since:

2004-07-01

MythTV Protocol Version Info:

SVN-Rev.	3966
Git Commit	304c592c14ce7cc4b038

PROTO_VERSION_11

public static final ProtocolVersion PROTO_VERSION_11

MythTV Development Version 2004-07-06.

• IProgramInfo.Props.LAST_MODIFIED added

Since:

2004-07-06

MythTV Protocol Version Info:

SVN-Rev.	3973
Git Commit	f223614972b66a47682a

PROTO_VERSION_12

public static final ProtocolVersion PROTO_VERSION_12

MythTV Development Version 2004-07-10.

Protocol Changes:

• IProgramInfo.Props.STARS added
• IProgramInfo.Props.ORIGINAL_AIRDATE added
• IProgramRecordingStatus.Status.REPEAT added
• IProgramRecordingDupMethodType.Flags.DUP_CHECK_NEW_EPI added

Since:

2004-07-10

MythTV Protocol Version Info:

SVN-Rev.	3988
Git Commit	c5dbecde01ea70f8add7

PROTO_VERSION_13

public static final ProtocolVersion PROTO_VERSION_13

MythTV Release Version 0.16 - 2004-08-16.

Protocol Changes:

• IRecorderProgramInfo.Props.REPEAT added
• IRecorderProgramInfo.Props.ORIGINAL_AIRDATE added
• IRecorderProgramInfo.Props.STARS added

Since:

2004-08-16

MythTV Protocol Version Info:

SVN-Rev.	4122
Git Commit	ad4597cdc8ef89a91ef7

PROTO_VERSION_14

public static final ProtocolVersion PROTO_VERSION_14

MythTV Release Version 0.17 - 2004-10-06.

Protocol Changes:

• IProgramInfo now encodes dates as UTC
• IProgramRecordingDupInType.Flags.DUPS_IN_BOTH added
• IProgramRecordingDupInType.Flags.DUPS_NEW_EPI added
• IProgramRecordingDupMethodType.Flags.DUP_CHECK_NEW_EPI removed

Since:

2004-10-06

MythTV Protocol Version Info:

SVN-Rev.	4508 | 4450
Git Commit	2a743b9ded4095b78a90 | 39683670afae9ab2ca4c
MythTV-Release	0.17

PROTO_VERSION_15

public static final ProtocolVersion PROTO_VERSION_15

MythTV Release Version 0.18 - 2005-03-23.

Protocol Changes:

• IMythCommand.QUERY_LOAD added
• IMythCommand.QUERY_UPTIME added
• IMythCommand.QUERY_MEMSTATS added
• IMythCommand.QUERY_GUIDEDATATHROUGH added
• IMythCommand.RESCHEDULE_RECORDINGS added
• IProgramInfo.Props.HAS_AIRDATE added
• IProgramRecordingStatus.Status.INACTIVE added
• IProgramRecordingType.Type.FIND_DAILY_RECORD added
• IProgramRecordingType.Type.FIND_WEEKLY_RECORD added
• IProgramRecordingSearchType.Type.MANUAL_SEARCH added

Since:

2005-03-23

MythTV Protocol Version Info:

SVN-Rev.	5833 | 5019 | 5218 | 5156 | 5829 | 5133 | 5090 | 5656
Git Commit	f9bb13c9be24ddad4591 | 420af8584c9d979e1311 | 6dc73c31312658679e2c | e6c87e28e6e54e046882 | 99fdbbaa256b668c971c | 29decbddb635b05a8b25 | d2a0c908019409d8721a | e73b621fa1fce924519e18c7002fa4e7921557dd
MythTV-Release	0.18

PROTO_VERSION_16

public static final ProtocolVersion PROTO_VERSION_16

MythTV Development Version 2005-05-03.

Protocol Changes:

• IMythCommand.FORCE_DELETE_RECORDING added
• IMythCommand.OK added
• IMythCommand.UNKNOWN_COMMAND added

Since:

2005-05-03

MythTV Protocol Version Info:

SVN-Rev.	6284 | 6235 | 5937 | 6025
Git Commit	e452f9a6fc03f261ab04 | 834fedd51d451da70f40 | 77ec835feeb33505ad79 | b1cbe8392fbc3f871ed5

PROTO_VERSION_17

public static final ProtocolVersion PROTO_VERSION_17

MythTV Development Version 2005-05-24.

Protocol Changes:

• IMythCommand.QUERY_FREESPACE removed.
• IMythCommand.QUERY_FREE_SPACE added.
• IMythCommand.QUERY_FREE_SPACE_LIST added.
• IMythCommand.GET_FREE_RECORDER_LIST added.
• IMythCommand.QUERY_PIXMAP_LASTMODIFIED added.
• IMythCommand.QUERY_COMMBREAK added.
• IMythCommand.QUERY_CUTLIST added.
• IMythCommand.QUERY_BOOKMARK added.
• IMythCommand.SET_BOOKMARK added.
• IMythCommand.QUERY_SETTING added.
• IMythCommand.SET_SETTING added.
• IMythCommand.QUERY_REMOTEENCODER_GET_MAX_BITRATE added.
• IMythCommand.QUERY_RECORDER_GET_MAX_BITRATE added.
• IMythCommand.QUERY_RECORDER_SHOULD_SWITCH_CARD added.
• IProgramRecordingStatus.Status.NOT_LISTED added.

Since:

2005-05-24

MythTV Protocol Version Info:

SVN-Rev.	6482 | 6392 | 6308 | 6295 | 6301
Git Commit	a975132f72aab16ce5b2 | a4bd91f4699ec453bac1 | e841c802ce4a12c9fc28 | a18499516a398f8b170a | b999a5114b43c0cc12e2

PROTO_VERSION_18

public static final ProtocolVersion PROTO_VERSION_18

MythTV Development Version 2005-07-19.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_SET_SIGNAL_MONITORING_RATE added.
• IMythCommand.QUERY_RECORDER_PAUSE_RECORDER added.
• IMythCommand.QUERY_RECORDER_PAUSE_RECORDER removed.
• IMythCommand.QUERY_RECORDER_UNPAUSE added.
• IMythCommand.QUERY_RECORDER_UNPAUSE removed.
• IProgramInfo.Props.TIMESTRETCH added.

Since:

2005-07-19

MythTV Protocol Version Info:

SVN-Rev.	6865 | 6847 | 6739 | 6740
Git Commit	240102c549d351d5b285 | 91b4b42d7390d03af7a6 | 8eb94238aa3e69473628 | 73c16d1a3cc383cfe11a

PROTO_VERSION_19

public static final ProtocolVersion PROTO_VERSION_19

MythTV Development Version 2005-10-09.

Protocol Changes:

• IMythCommand.REACTIVATE_RECORDING removed.
• IMythCommand.ALLOW_SHUTDOWN added
• IMythCommand.BLOCK_SHUTDOWN added
• IMythCommand.QUERY_RECORDER_GET_CURRENT_RECORDING added.
• IMythCommand.QUERY_REMOTEENCODER_GET_CURRENT_RECORDING added.
• IProgramRecordingStatus.Status.TUNER_BUSY changed.
• IProgramRecordingStatus.Status.LOW_DISKSPACE changed.
• IProgramRecordingStatus.Status.CANCELLED changed.
• IProgramRecordingStatus.Status.DELETED removed.
• IProgramRecordingStatus.Status.MISSED added.
• IProgramRecordingStatus.Status.STOPPED removed.
• IProgramRecordingStatus.Status.ABORTED added.
• IProgramRecordingStatus.Status.NOT_LISTED changed.
• IProgramRecordingStatus.Status.NEVER_RECORD added.

Since:

2005-10-09

MythTV Protocol Version Info:

SVN-Rev.	7427 | 7300 | 7191 | 6896
Git Commit	d71e95c15342f12ecbd4 | bbc9f2ed33ca6340c82b | 42bf4a6e0b961a12ab88 | 8542a707a7f3e0393db9

PROTO_VERSION_20

public static final ProtocolVersion PROTO_VERSION_20

MythTV Development Version 2005-11-05.

Protocol Changes:

• IMythCommand.ANN_RING_BUFFER removed.
• IMythCommand.QUERY_RECORDER_GET_FREE_SPACE removed.
• IMythCommand.QUERY_RECORDER_SETUP_RING_BUFFER removed.
• IMythCommand.QUERY_RECORDER_STOP_PLAYING removed.
• IMythCommand.QUERY_RECORDER_REQUEST_BLOCK_RINGBUF removed.
• IMythCommand.QUERY_RECORDER_SEEK_RINGBUF removed.
• IMythCommand.QUERY_RECORDER_DONE_RINGBUF removed.
• IMythCommand.QUERY_RECORDER_SPAWN_LIVETV changed.
• IMythCommand.BACKEND_MESSAGE_LIVETV_CHAIN added.
• Mythwelcome added as backend feature.

Since:

2005-11-05

MythTV Protocol Version Info:

SVN-Rev.	7739
Git Commit	244771e83ab75f64f6ae

PROTO_VERSION_21

public static final ProtocolVersion PROTO_VERSION_21

MythTV Development Version 2005-11-10.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_GET_PROGRAM_INFO removed.
• IMythCommand.QUERY_RECORDER_GET_INPUT_NAME removed.
• IProgramFlags.Flags.FL_INUSERECORDING added.

Since:

2005-11-10

MythTV Protocol Version Info:

SVN-Rev.	7826 | 7812
Git Commit	ce1b4f5d7d54b34ca907 | 1de52a52e7476ed7d7e4

PROTO_VERSION_22

public static final ProtocolVersion PROTO_VERSION_22

MythTV Development Version 2005-11-15.

Protocol Changes:

• IMythCommand.ANN_MONITOR added.

Since:

2005-11-15

MythTV Protocol Version Info:

SVN-Rev.	7883
Git Commit	a7af182e72ad9a81c52e

PROTO_VERSION_23

public static final ProtocolVersion PROTO_VERSION_23

MythTV Development Version 2006-01-10.

Protocol Changes:

• IMythCommand.QUEUE_TRANSCODE removed.
• IMythCommand.QUEUE_TRANSCODE_CUTLIST removed.
• IMythCommand.QUEUE_TRANSCODE_STOP removed.
• IMythCommand.QUERY_RECORDER_CANCEL_NEXT_RECORDING changed.
• IMythCommand.QUERY_GETEXPIRING added.
• IMythCommand.BACKEND_MESSAGE_CLEAR_SETTINGS_CACHE added.
• IAskRecording.Props.HAS_RECORDING added.
• IProgramFlags.Flags.FL_INUSEPLAYING added.
• IProgramInfo.Props.PLAY_GROUP added.
• IProgramInfo.Props.TIMESTRETCH removed.

Since:

2006-01-10

MythTV Protocol Version Info:

SVN-Rev.	8553 | 8033 | 8280 | 8136 | 7928 | ba21ecda5f975e2ebb66
Git Commit	546724c8c9a3b573946e | e65f8b61245722844c54 | 71beb18d90c7f2b9b7d9 | 2875552667c6ffbfb244 | c8df32dc3eab6832bdd1

PROTO_VERSION_24

public static final ProtocolVersion PROTO_VERSION_24

MythTV Development Version 2006-01-15.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_CHECK_CHANNEL_PREFIX response changed

Since:

2006-01-15

MythTV Protocol Version Info:

SVN-Rev.	8617
Git Commit	e271b33dce644f8c6dd2

PROTO_VERSION_25

public static final ProtocolVersion PROTO_VERSION_25

MythTV Development Version 2006-01-17.

Protocol Changes:

• IProgramInfo.Props.REC_PRIORITY2 added

Since:

2006-01-17

MythTV Protocol Version Info:

SVN-Rev.	8628
Git Commit	bb8a1b09e91b5b3c7d5a

PROTO_VERSION_26

public static final ProtocolVersion PROTO_VERSION_26

MythTV Release Version 0.19 - 2006-01-17.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_SET_LIVE_RECORDING added

Since:

2006-01-29

MythTV Protocol Version Info:

SVN-Rev.	8754
Git Commit	fcb87d603529e426a6cc
MythTV-Release	0.19

PROTO_VERSION_27

public static final ProtocolVersion PROTO_VERSION_27

MythTV Development Version 2006-02-15.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_TOGGLE_INPUTS removed.
• IMythCommand.QUERY_RECORDER_GET_CONNECTED_INPUTS added.
• IMythCommand.QUERY_RECORDER_GET_INPUT added.
• IMythCommand.QUERY_RECORDER_SET_INPUT added.
• IProgramFlags.Flags.FL_CC added.
• IProgramFlags.Flags.FL_STEREO added.
• IProgramFlags.Flags.FL_HDTV added.

Since:

2006-02-15

MythTV Protocol Version Info:

SVN-Rev.	8973 | 8949
Git Commit	253a31568d27bf080f94 | f365f48b45dc73057ab6

PROTO_VERSION_28

public static final ProtocolVersion PROTO_VERSION_28

MythTV Development Version 2006-03-28.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_GET_CHANNEL_INFO added.
• IMythCommand.SET_CHANNEL_INFO added.
• IMythCommand.QUERY_FILETRANSFER_SET_TIMEOUT added.
• IProgramFlags.Flags.FL_TRANSCODED added.
• IProgramRecordingStatus.Status.OFFLINE added.

Since:

2006-03-28

MythTV Protocol Version Info:

SVN-Rev.	9524 | 9106 | 9029 | 9064
Git Commit	cc49c6ff3b674a9ad1e4 | 2a1285e76da4ac535c8f | bdb1d2e5ebbc706e5ffe | e6b408694f171ae7897a

PROTO_VERSION_29

public static final ProtocolVersion PROTO_VERSION_29

MythTV Development Version 2006-04-01.

Protocol Changes:

• IMythCommand.ANN_FILE_TRANSFER changed: useReadAhead,retries params added.

Since:

2006-04-01

MythTV Protocol Version Info:

SVN-Rev.	9592
Git Commit	2116c72efb6633036608

PROTO_VERSION_30

public static final ProtocolVersion PROTO_VERSION_30

MythTV Release Version 0.20 - 2006-05-22.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_GET_COLOUR added.
• IMythCommand.QUERY_RECORDER_GET_CONTRAST added.
• IMythCommand.QUERY_RECORDER_GET_BRIGHTNESS added.
• IMythCommand.QUERY_RECORDER_GET_HUE added.
• IMythCommand.QUERY_RECORDER_CHANGE_COLOUR changed.
• IMythCommand.QUERY_RECORDER_CHANGE_CONTRAST changed.
• IMythCommand.QUERY_RECORDER_CHANGE_BRIGHTNESS changed.
• IMythCommand.QUERY_RECORDER_CHANGE_HUE changed.

Since:

2006-05-22

MythTV Protocol Version Info:

SVN-Rev.	9968
Git Commit	b54b9e176ddec280a8ed
MythTV-Release	0.20

PROTO_VERSION_31

public static final ProtocolVersion PROTO_VERSION_31

MythTV Release Version 0.20-fixes - 2006-09-24.

Protocol Changes:

• IProgramFlags.Flags.FL_WATCHED added.
• IProgramInfo.Props.PARENT_ID added.
• IProgramRecordingStatus.Status.FAILED added.

Since:

2006-09-24

MythTV Protocol Version Info:

SVN-Rev.	11278 | 11138 | 11211
Git Commit	b64f4f654b9f88bd5860 | c3f0c9860f96a979964f | ff50f067a1b403779ac4
MythTV-Release	0.20-fixes

PROTO_VERSION_32

public static final ProtocolVersion PROTO_VERSION_32

MythTV Development Version 2006-11-30.

Protocol Changes:

• IMythCommand.QUERY_RECORDING added.
• IMythCommand.QUERY_RECORDING_BASENAME added.
• IMythCommand.QUERY_RECORDING_TIMESLOT added.
• IMythCommand.QUERY_FREE_SPACE_SUMMARY added.
• IMythCommand.SET_NEXT_LIVETV_DIR added.
• IMythCommand.QUERY_CHECKFILE changed.
• IFreeSpaceListEntry.EntryProps.DIRECTORIES added.
• IFreeSpaceListEntry.EntryProps.IS_LOCAL added.
• IFreeSpaceListEntry.EntryProps.FILESYSTEM_ID added.
• IProgramFlags.Flags.FL_PRESERVED added.
• IProgramInfo.Props.STORAGE_GROUP added.

Since:

2006-11-30

MythTV Protocol Version Info:

SVN-Rev.	12151 | 11794 | 11455
Git Commit	a4796b5fc991f6739d71 | 5be603e42bdc34697fb6 | a88b47c172eda224a6f1

PROTO_VERSION_33

public static final ProtocolVersion PROTO_VERSION_33

MythTV Development Version 2007-03-01.

Protocol Changes:

• IProgramInfo.Props.ORIGINAL_AIRDATE format changed.
• IProgramRecordingStatus.Status.OTHER_SHOWING added.
• ERecordingsType.Recording added.
• IProgramRecordingDupInType.Flags.DUPS_NEW_EPI changed.
• IProgramRecordingDupInType.Flags.DUPS_IN_BOTH removed.
• IProgramRecordingDupInType.Flags.DUPS_EX_REPEATS added.
• IProgramRecordingDupInType.Flags.DUPS_EX_GENERIC added.
• IProgramRecordingDupMethodType.Flags.DUP_CHECK_SUB_THEN_DESC added.

Since:

2007-03-01

MythTV Protocol Version Info:

SVN-Rev.	12904 | 12463 | 12704 | 12433 | 12808
Git Commit	d2f00684f17c6f6bd3cd | ca23023b68101eff00c4 | 6f9109591d4a558f1b78 | ee3e82e0bfd6baf162cc | b37cf5283c3ab4770815

PROTO_VERSION_34

public static final ProtocolVersion PROTO_VERSION_34

MythTV Development Version 2007-04-13.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_SPAWN_LIVETV changed.
• IProgramRecordingDupInType.Flags.DUPS_FIRST_NEW added.

Since:

2007-04-13

MythTV Protocol Version Info:

SVN-Rev.	13230 | 13005
Git Commit	69307f175c5bfd926bcb | 1fd6892925f1ddbd09f2

PROTO_VERSION_35

public static final ProtocolVersion PROTO_VERSION_35

MythTV Development Version 2007-07-16.

Protocol Changes:

• IProgramInfo.Props.AUDIO_PROPERTIES added.
• IProgramInfo.Props.VIDEO_PROPERTIES added.
• IProgramInfo.Props.SUBTITLE_TYPE added.
• IProgramFlags.Flags.FL_STEREO removed.
• IProgramFlags.Flags.FL_CC removed.
• IProgramFlags.Flags.FL_HDTV removed.

Since:

2007-07-16

MythTV Protocol Version Info:

SVN-Rev.	13952
Git Commit	2ec595b45d09fec565ee

PROTO_VERSION_36

public static final ProtocolVersion PROTO_VERSION_36

MythTV Development Version 2007-09-11.

Protocol Changes:

• IMythCommand.UNDELETE_RECORDING added.

Since:

2007-09-11

MythTV Protocol Version Info:

SVN-Rev.	14483
Git Commit	b94ee87382b87a7126c5

PROTO_VERSION_37

public static final ProtocolVersion PROTO_VERSION_37

MythTV Development Version 2008-01-14.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_GET_CONNECTED_INPUTS removed.
• IMythCommand.QUERY_RECORDER_GET_FREE_INPUTS added.
• IMythCommand.QUERY_REMOTEENCODER_GET_FREE_INPUTS added.
• IMythCommand.QUERY_REMOTEENCODER_GET_FLAGS added.
• IMythCommand.QUERY_REMOTEENCODER_CANCEL_NEXT_RECORDING added.
• IMythCommand.QUERY_REMOTEENCODER_STOP_RECORDING added.
• IMythCommand.QUERY_REMOTEENCODER_IS_BUSY changed.
• IMythCommand.QUERY_REMOTEENCODER_RECORD_PENDING changed.
• IMythCommand.QUERY_GENPIXMAP changed.
• IMythCommand.BACKEND_MESSAGE_RECORDING_LIST_CHANGE DELETE added.
• IProgramAudioProperties.Flags.AUD_HARDHEAR added.
• IProgramAudioProperties.Flags.AUD_VISUALIMPAIR added.
• IProgramVideoProperties.Flags.VID_AVC added.
• IFreeSpaceListEntry.EntryProps.STORAGE_GROUP_ID added
• IProgramSubtitleType.Flags.SUB_SIGNED added.
• IAskRecording.Props.HAS_LATER_SHOWING added.

Since:

2008-01-14

MythTV Protocol Version Info:

SVN-Rev.	15437 | 15361 | 14789
Git Commit	b3c20d633a874f886f11 | 0ee58223eb09e74c4572 | f84369e041384c37593d

PROTO_VERSION_38

public static final ProtocolVersion PROTO_VERSION_38

MythTV Development Version 2008-01-23.

Protocol Changes:

• IMythCommand.DELETE_FAILED_RECORDING added.

Since:

2008-01-23

MythTV Protocol Version Info:

SVN-Rev.	15550 | 15549
Git Commit	975b5a71e4e55345da6e | 89c5f7ae25b7be547801

PROTO_VERSION_39

public static final ProtocolVersion PROTO_VERSION_39

MythTV Release Version 0.21 - 2008-01-31.

Protocol Changes:

• IMythCommand.DELETE_FAILED_RECORDING removed.

Since:

2008-01-31

MythTV Protocol Version Info:

SVN-Rev.	15701
Git Commit	b2d8e1fe354a796d54bf
MythTV-Release	0.21

PROTO_VERSION_40

public static final ProtocolVersion PROTO_VERSION_40

MythTV Development Version 2008-02-17.

Protocol Changes:

• IMythCommand.QUERY_PIXMAP_LASTMODIFIED changed. A unix-timestamp is returned instead of a localized date string now.
• IMythCommand.BACKEND_MESSAGE_RESET_IDLETIME added.
• IRecordingStatus.Props.LIVETV_IN_PROGRESS added.

Since:

2008-02-17

MythTV Protocol Version Info:

SVN-Rev.	16090 | 15708 | 15794
Git Commit	34048055f51197778129 | a046006757ba89ed1721 | e1dfb99db1e9a46d7699

PROTO_VERSION_41

public static final ProtocolVersion PROTO_VERSION_41

MythTV Development Version 2008-09-25.

Protocol Changes:

• IProgramInfo.Props.YEAR added.
• IMythCommand.DELETE_RECORDING changed. Deletes can be done using channel-id and rec-start-time now.

Since:

2008-09-25

MythTV Protocol Version Info:

SVN-Rev.	18419
Git Commit	ad871fd258218dd87c9d

PROTO_VERSION_42

public static final ProtocolVersion PROTO_VERSION_42

MythTV Development Version 2008-10-07.

Protocol Changes:

• IMythCommand.QUERY_TIME_ZONE added.

Since:

2008-10-07

MythTV Protocol Version Info:

SVN-Rev.	18574
Git Commit	7a4c6703d76598943580

PROTO_VERSION_43

public static final ProtocolVersion PROTO_VERSION_43

MythTV Development Version 2008-12-22.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_FILL_POSITION_MAP changed.

Since:

2008-12-22

MythTV Protocol Version Info:

SVN-Rev.	19417
Git Commit	52259b824062fb261989

PROTO_VERSION_44

public static final ProtocolVersion PROTO_VERSION_44

MythTV Development Version 2009-02-12.

Protocol Changes:

• IMythCommand.ANN_FILE_TRANSFER changed: storagegroup parameter added.
• IMythCommand.QUERY_SG_GETFILELIST added.
• IMythCommand.QUERY_SG_FILEQUERY added.

Since:

2009-02-12

MythTV Protocol Version Info:

SVN-Rev.	19978
Git Commit	47918f95763a0874acac

PROTO_VERSION_45

public static final ProtocolVersion PROTO_VERSION_45

MythTV Development Version 2009-05-09.

Protocol Changes:

• IMythCommand.QUERY_RECORDER_TOGGLE_CHANNEL_FAVORITE changed.
• IMythCommand.BACKEND_MESSAGE_DONE_RECORDING changed.
• IMythCommand.GO_TO_SLEEP added.
• IMythCommand.QUERY_REMOTEENCODER_GET_SLEEPSTATUS added.
• ISleepStatus added.
• IRemoteEncoderState.State.WATCHING_VIDEO added.
• IRemoteEncoderState.State.WATCHING_DVD added.
• IProgramVideoProperties.Flags.VID_720 added.
• IProgramVideoProperties.Flags.VID_1080 added.

Since:

2009-05-09

MythTV Protocol Version Info:

SVN-Rev.	20523 | 20084 | 20037 | 20067
Git Commit	852b80ae3a2dc6cfcf67 | 663cd89811cf7fc22f59 | 3ba6d8ebaeba6eb19947 | c1458fcb4b29747179f9

PROTO_VERSION_46

public static final ProtocolVersion PROTO_VERSION_46

MythTV Development Version 2009-08-08.

Protocol Changes:

• IMythCommand.DELETE_FILE added.
• IMythCommand.QUERY_FILETRANSFER_WRITE_BLOCK added.
• IMythCommand.ANN_FILE_TRANSFER changed: writing of files.

Since:

2009-08-08

MythTV Protocol Version Info:

SVN-Rev.	21158 | 21134
Git Commit	48b0dff7a796dbec38dc | 9d57165c68abb5cfbf29

PROTO_VERSION_47

public static final ProtocolVersion PROTO_VERSION_47

MythTV Development Version 2009-08-16.

Protocol Changes:

• IFreeSpaceListEntry.EntryProps.BLOCK_SIZE added.
• IMythCommand.DELETE_FILE changed.

Since:

2009-08-16

MythTV Protocol Version Info:

SVN-Rev.	21298
Git Commit	23313c004e217d3ccd0b

PROTO_VERSION_48

public static final ProtocolVersion PROTO_VERSION_48

MythTV Development Version 2009-08-23.

Protocol Changes:

• IMythCommand.ANN changed. Error descriptions are returned now.

Since:

2009-08-23

MythTV Protocol Version Info:

SVN-Rev.	21445
Git Commit	2fdeb3fc4acf89989a5d

PROTO_VERSION_49

public static final ProtocolVersion PROTO_VERSION_49

MythTV Development Version 2009-10-01.

Protocol Changes:

• IMythCommand.QUERY_FILE_EXISTS added.
• IMythCommand.QUERY_PIXMAP_GET_IF_MODIFIED added.
• IMythCommand.QUERY_SG_GETFILELIST changed.

Since:

2009-10-01

MythTV Protocol Version Info:

SVN-Rev.	22164 | 21770
Git Commit	3c131674bcd3aa853588 | d7a8d1a8f3555321868a

PROTO_VERSION_50

public static final ProtocolVersion PROTO_VERSION_50

MythTV Release Version 0.22 - 2009-10-02.

Protocol Changes:

• IMythCommand.QUERY_HOSTNAME added.

Since:

2009-10-0

MythTV Protocol Version Info:

SVN-Rev.	22170
Git Commit	b515e6c5b2f9384135d2
MythTV-Release	0.22

PROTO_VERSION_51

public static final ProtocolVersion PROTO_VERSION_51

MythTV Development Version 2009-11-23.

Protocol Changes:

• IMythCommand.QUERY_FILE_HASH added.

Since:

2009-11-23

MythTV Protocol Version Info:

SVN-Rev.	22892 | 22886
Git Commit	8c36504df2f3eb89502a | d02b0d7c0ae9ffcb916d

PROTO_VERSION_52

public static final ProtocolVersion PROTO_VERSION_52

MythTV Development Version 2009-11-30. TODO:

Protocol Changes:

• IMythCommand.BACKEND_MESSAGE_UPDATE_PROG_INFO added.
• IMythCommand.MESSAGE changed.

Since:

2009-11-30

MythTV Protocol Version Info:

SVN-Rev.	22932
Git Commit	bddb06933b3932730990

PROTO_VERSION_53

public static final ProtocolVersion PROTO_VERSION_53

MythTV Development Version 2009-12-06.

Protocol Changes:

• IProgramFlags.Flags.FL_COMMPROCESSING added.
• IProgramFlags.Flags.FL_DELETEPENDING added.
• IProgramFlags.Flags.FL_REALLYEDITING added.
• IMythCommand.BACKEND_MESSAGE_RECORDING_LIST_CHANGE ADD added.

Since:

2009-12-06

MythTV Protocol Version Info:

SVN-Rev.	22955
Git Commit	5b6770d22545a21211d8

PROTO_VERSION_54

public static final ProtocolVersion PROTO_VERSION_54

MythTV Development Version 2009-12-18. TODO:

Protocol Changes:

• IMythCommand.BACKEND_MESSAGE_MASTER_UPDATE_PROG_INFO added.
• IMythCommand.BACKEND_MESSAGE_UPDATE_FILE_SIZE added.

Since:

2009-12-18

MythTV Protocol Version Info:

SVN-Rev.	22976
Git Commit	fead9968a5f28c33bb7d

PROTO_VERSION_55

public static final ProtocolVersion PROTO_VERSION_55

MythTV Development Version 2009-12-21. TODO

Protocol Changes:

• IMythCommand.BACKEND_MESSAGE_RECORDING_LIST_CHANGE UPDATE added.
• IMythCommand.BACKEND_MESSAGE_UPDATE_PROG_INFO removed.
• MASTER_UPDATE_PROG_INFO changed. Dends only the channel-id and rec-start-time now

Since:

2009-12-21

MythTV Protocol Version Info:

SVN-Rev.	22992
Git Commit	b2247829b3050be1da88

PROTO_VERSION_56

public static final ProtocolVersion PROTO_VERSION_56

MythTV Release Version 0.23 - 2009-12-29.

TODO: what changes were done in this Version?

Protocol Changes:

• MythTV event handling system changed. Various events added? XXX
• IMythCommand.DELETE_RECORDING changed. Parameter FORCE added.
• IMythCommand.UNDELETE_RECORDING changed. Undelete can be done by channel-id and rec-start-time now. TODO

Since:

2009-12-29

MythTV Protocol Version Info:

SVN-Rev.	23028 | 23012
MythBuntu-Release	10.04
Git Commit	c1a564c9b62e3150d7c3 | 07948b49f4f7ecd79e6d28ff2faf1a7c4f516078
MythTV-Release	0.23

PROTO_VERSION_23056

public static final ProtocolVersion PROTO_VERSION_23056

MythTV Bugfix Version 0.23.1 - 2010-07-17.

Some bugfixes from trunk were backported into this version.

Since:

2010-07-17

MythTV Protocol Version Info:

SVN-Rev.	25366
Git Commit	feafbbce465d0a573937
MythTV-Release	0.23.1

PROTO_VERSION_57

public static final ProtocolVersion PROTO_VERSION_57

MythTV Development Version 2010-05-16.

Protocol Changes:

• IMythCommand.ANN changed. More event-modes possible.
• EPlaybackSockEventsMode.NON_SYSTEM added.
• EPlaybackSockEventsMode.SYSTEM_ONLY added.
• IProgramFlags.Flags.FL_NONE added
• IProgramFlags.Flags.FL_INUSERECORDING changed
• IProgramFlags.Flags.FL_INUSEPLAYING changed
• IProgramFlags.Flags.FL_REALLYEDITING changed
• IProgramFlags.Flags.FL_COMMPROCESSING changed
• IProgramFlags.Flags.FL_DELETEPENDING changed
• IProgramFlags.Flags.FL_TRANSCODED changed
• IProgramFlags.Flags.FL_WATCHED changed
• IProgramFlags.Flags.FL_PRESERVED changed
• IProgramFlags.Flags.FL_CHANCOMMFREE added
• IProgramFlags.Flags.FL_REPEAT added
• IProgramFlags.Flags.FL_DUPLICATE added
• IProgramFlags.Flags.FL_REACTIVATE added
• IProgramFlags.Flags.FL_IGNOREBOOKMARK added
• IProgramFlags.Flags.FL_TYPEMASK added
• IProgramFlags.Flags.FL_INUSEOTHER added
• IMythCommand.QUERY_GETCONFLICTING changed. A programInfo must be specified as request parameter now.

Since:

2010-05-16

MythTV Protocol Version Info:

SVN-Rev.	24694 | 23636
Git Commit	6e17b4de938428becdee | bfa20e9cd66ce89929f10bdeeecf75d2b7fd1166

PROTO_VERSION_58

public static final ProtocolVersion PROTO_VERSION_58

MythTV Development Version 2010-07-17.

Protocol Changes:

• IMythCommand.DOWNLOAD_FILE added.
• IMythCommand.DOWNLOAD_FILE_NOW added.
• IMythCommand.BACKEND_MESSAGE_DOWNLOAD_FILE added.
• IRemoteEncoderState.State.WATCHING_BD added.
• IMythCommand.QUERY_SG_FILEQUERY changed. A relative path can be used as pathname now. The backend IP can be used as hostname now.

Since:

2010-07-17

PROTO_VERSION_59

public static final ProtocolVersion PROTO_VERSION_59

MythTV Development Version 2010-08-26.

Protocol Changes:

• IFileStatus.Props.DEV added
• IFileStatus.Props.INO added
• IFileStatus.Props.MODE added
• IFileStatus.Props.NLINK added
• IFileStatus.Props.UID added
• IFileStatus.Props.GID added
• IFileStatus.Props.RDEV added
• IFileStatus.Props.SIZE added
• IFileStatus.Props.BLKSIZE added
• IFileStatus.Props.BLOCKS added
• IFileStatus.Props.ATIME added
• IFileStatus.Props.MTIME added
• IFileStatus.Props.CTIME added
• IMythCommand.DELETE_RECORDING changed. Parameter FORGET added.
• Adds support for ISOs over remote file access (SVN 25858) TODO:

Since:

2010-08-26

MythTV Protocol Version Info:

SVN-Rev.	25858
Git Commit	3af3489357da268916c0

PROTO_VERSION_60

public static final ProtocolVersion PROTO_VERSION_60

MythTV Development Version 2010-09-03.

Protocol Changes:

• IMythCommand.ANN_FILE_TRANSFER changed. A timeout value is used instead fo the retry counter now.

Since:

2010-09-03

MythTV Protocol Version Info:

SVN-Rev.	26101
Git Commit	961dc80a878226da3f39

PROTO_VERSION_61

public static final ProtocolVersion PROTO_VERSION_61

MythTV Development Version 2010-09-03.

Protocol Changes:

• IMythCommand.QUERY_GENPIXMAP removed
• IMythCommand.QUERY_GENPIXMAP2 added
• IMythCommand.BACKEND_MESSAGE_GENERATED_PIXMAP added

Since:

2010-09-03

MythTV Protocol Version Info:

SVN-Rev.	26106
Git Commit	c65a45682845f16c3ce6

PROTO_VERSION_62

public static final ProtocolVersion PROTO_VERSION_62

MythTV Development Version 2010-09-13.

Protocol Changes:

• IMythCommand.MYTH_PROTO_VERSION changed. Protocol token added.

Since:

2010-09-13

MythTV Protocol Version Info:

SVN-Rev.	26280
Git Commit	c590e97346959463ef05
Protocol Token	78B5631E

PROTO_VERSION_63

public static final ProtocolVersion PROTO_VERSION_63

MythTV Release Version 0.24 - 2010-09-25.

Protocol Changes:

• IMythCommand.QUERY_REMOTEENCODER_GET_RECORDING_STATUS added.
• IProgramRecordingStatus.Status.TUNING added.
• IMythCommand.BACKEND_MESSAGE_VIDEO_LIST_CHANGE added.

Since:

2010-09-25

MythTV Protocol Version Info:

SVN-Rev.	26518
MythBuntu-Release	11.04
Git Commit	67fd5cffa0c31d2eddac | 20097268b71d947908636e09f38ead4f875fc12e
MythTV-Release	0.24
Protocol Token	3875641D

PROTO_VERSION_64

public static final ProtocolVersion PROTO_VERSION_64

MythTV Development Version 2010-11-20.

Protocol Changes:

• IMythCommand.SCAN_VIDEOS added.

Since:

2010-11-20

MythTV Protocol Version Info:

SVN-Rev.	27308
Git Commit	69f594d3d3dbc573b90e
Protocol Token	8675309J

PROTO_VERSION_65

public static final ProtocolVersion PROTO_VERSION_65

MythTV Development Version 2011-03-08.

Protocol Changes:

• IMythCommand.QUERY_RECORDINGS changed.
• ERecordingsType.Play removed.
• ERecordingsType.Delete removed.
• ERecordingsType.Unsorted added.
• ERecordingsType.Ascending added.
• ERecordingsType.Descending added.
• IMythCommand.QUERY_FILE_EXISTS changed: Storage group argument made optional.
• IProgramRecordingStatus.Status.MISSED_FUTURE added.

Since:

2011-03-08

MythTV Protocol Version Info:

Git Commit	e965e4bab1d37fd9fa94 | 543d7836c99adc4817fb
Protocol Token	D2BB94C2

PROTO_VERSION_66

public static final ProtocolVersion PROTO_VERSION_66

MythTV Development Version 2011-05-25.

Protocol Changes:

• IMythCommand.ANN_FILE_TRANSFER changed.
• IMythCommand.QUERY_FILETRANSFER_SEEK changed.
• IMythCommand.QUERY_FREE_SPACE_SUMMARY changed.
• IMythCommand.QUERY_FREE_SPACE_LIST changed.
• IMythCommand.QUERY_RECORDER_GET_FILE_POSITION changed.
• IMythCommand.QUERY_RECORDER_GET_FRAMES_WRITTEN changed.
• IMythCommand.QUERY_RECORDER_GET_MAX_BITRATE changed.
• IMythCommand.QUERY_REMOTEENCODER_GET_MAX_BITRATE changed.
• IMythCommand.QUERY_RECORDER_FILL_POSITION_MAP changed (TODO).
• IMythCommand.QUERY_RECORDER_GET_KEYFRAME_POS changed (TODO).
• IMythCommand.SET_BOOKMARK changed (TODO).
• IMythCommand.QUERY_BOOKMARK changed (TODO).
• IMythCommand.QUERY_COMMBREAK changed (TODO).
• IMythCommand.QUERY_CUTLIST changed (TODO).
• IMythCommand.QUERY_REMOTEENCODER_START_RECORDING changed (response value changes)

Since:

2011-05-25

MythTV Protocol Version Info:

Git Commit	64d448acdd27b0384748 | 1508085eb3cf5f5b88af
Protocol Token	0C0FFEE0

PROTO_VERSION_67

public static final ProtocolVersion PROTO_VERSION_67

MythTV Development Version 2011-06-03.

Protocol Changes:

• IProgramInfo.Props.EPISODE added
• IProgramInfo.Props.SEASON added
• IProgramInfo.Props.INETREF added

Since:

2011-06-03

MythTV Protocol Version Info:

Git Commit	a41e9657c0e9dfbfb412
Protocol Token	0G0G0G0

PROTO_VERSION_68

public static final ProtocolVersion PROTO_VERSION_68

MythTV Development Version 2011-07-09.

Protocol Changes:

• IMythCommand.BACKEND_MESSAGE_VIDEO_LIST_CHANGE changed.
• TODO: ANN MediaServer added

Since:

2011-07-09

MythTV Protocol Version Info:

Git Commit	a17e689bdc00df4f04ca
Protocol Token	90094EAD

PROTO_VERSION_69

public static final ProtocolVersion PROTO_VERSION_69

MythTV Development Version 2011-07-11.

Protocol Changes:

• IMythCommand.QUERY_FILE_HASH changed
• IMythCommand.BACKEND_MESSAGE_VIDEO_LIST_NO_CHANGE added.

Since:

2011-07-11

MythTV Protocol Version Info:

Git Commit	fb34130d3a7d3c5991fa | 82c763ac10994866c74ffb0f0ba7b924bac0df93
Protocol Token	63835135

PROTO_VERSION_70

public static final ProtocolVersion PROTO_VERSION_70

MythTV Development Version 2011-11-30.

Protocol Changes:

• IMythCommand.QUERY_FILETRANSFER_REOPEN added TODO
• IProgramVideoProperties.Flags#VID_DAMAGED added.

Since:

2011-07-11

MythTV Protocol Version Info:

Git Commit	1da9d23d2838bc2d2e0bc06e2e9e1d382897d21d
Protocol Token	53153836

PROTO_VERSION_71

public static final ProtocolVersion PROTO_VERSION_71

MythTV Development Version 2012-01-15.

Protocol Changes:

• IInputInfoTuned.Props.LIVETV_ORDER added.
• IInputInfoFree.Props.LIVETV_ORDER added.

Since:

2012-01-15

MythTV Protocol Version Info:

Git Commit	3281cdd32cbc7fe27a6b693bbc1406aa98b288ca
Protocol Token	05e82186

PROTO_VERSION_72

public static final ProtocolVersion PROTO_VERSION_72

MythTV Release Version 0.25 2012-01-29.

Protocol Changes:

• IMythCommand.QUERY_ACTIVE_BACKENDS added.

Since:

2012-01-29

MythTV Protocol Version Info:

MythBuntu-Release	12.04
Git Commit	7a94153c8cbd637e6b84ead48e3fedcfb94b0241
MythTV-Release	0.25
Protocol Token	D78EFD6F

PROTO_VERSION_73

public static final ProtocolVersion PROTO_VERSION_73

MythTV Development Version 2012-04-11. Protocol Changes:

• IProgramRecordingStatus.Status.OTHER_RECORDING added.
• IProgramRecordingStatus.Status.OTHER_TUNING added.
• IMythCommand.RESCHEDULE_RECORDINGS changed. TODO

Since:

2012-04-11

MythTV Protocol Version Info:

Git Commit	cbb8eb1ee32a658a519d2d5fb751ace114f63bf9 | 090f847f1549e28cd92d6273f0b492293a9e421c
Protocol Token	D7FE8D6F

PROTO_VERSION_74

public static final ProtocolVersion PROTO_VERSION_74

MythTV Development Version 2012-05-09. Protocol Changes:

• IProgramRecordingType.Type.TEMPLATE_RECORD added.
• Some settings from the settings table were removed (see here).
  This settings are replaced by a default recording rule template.

PROTO_VERSION_75

public static final ProtocolVersion PROTO_VERSION_75

MythTV Release Version 0.26 2012-05-30.

Protocol Changes:

• MythTV now return the localtime and not the UTC time for the timezone queries.
• Update DB times to UTC.

Since:

2012-05-30

MythTV Protocol Version Info:

Git Commit	1f8c59021075d4c46889d19b0082c6dcdf04a455 | a7cf09d9df392e8ce22d05d19bb10dc779fa9583 | 4f028f388c38c1677b6c79c5efcc461f8b20cb4c
MythTV-Release	0.26
Protocol Token	SweetRock

PROTO_VERSION_76

public static final ProtocolVersion PROTO_VERSION_76

MythTV Development Version 2012-11-23. Protocol Changes:

• IProgramInfo.Props.SYNDICATED_EPISODE added.
• Some command response messages changed from ok to OK

PROTO_VERSION_77

public static final ProtocolVersion PROTO_VERSION_77

MythTV Release Version 0.27 Version 2013-01-01. Protocol Changes:

• IMythCommand.QUERY_RECORDER_FILL_DURATION_MAP added.

PROTO_VERSION_LATEST

public static final ProtocolVersion PROTO_VERSION_LATEST

MythTV Current Development Version.

Method Detail

values

public static ProtocolVersion[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ProtocolVersion c : ProtocolVersion.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ProtocolVersion valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getVersion

public int getVersion()

Gets the protocol version number.

Specified by:

getVersion in interface IVersion

Returns:

the version number, e.g. 5

getToken

public String getToken()

Gets the protocol version "handshake" token.

This token is used starting from version 62 to establish a connection with the backend.

Returns:

the handshake token.

getMetaData

public Map<String,String> getMetaData()

Gets some known metadata about the protocol version.

Metadata are e.g. the Date and SVN revision the version was introduced, or the Git commit id. See ProtocolVersionInfo for the supported types of data.

Returns:

metadata about the protocol version.

getPredecessor

public ProtocolVersion getPredecessor()

Gets the predecessor version of the current version.

Returns:

the predecessor version.

getSuccessor

public ProtocolVersion getSuccessor()

Gets the successor version of the current version.

Returns:

the successor version.

valueOf

public static ProtocolVersion valueOf(int protoVersion)

Gets the protocol-version whose value matches the given protocol version.

Parameters:

protoVersion - the requested protocol version

Returns:

the found protocol version property or null.

getMaxVersion

public static ProtocolVersion getMaxVersion()

Gets the maximum protocol version that is currently supported.

This returns the last enum constant excluding PROTO_VERSION_LATEST.

Returns:

the maximum supported protocol version