1d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood/* 2d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * Copyright (C) 2015 The Android Open Source Project 3d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * 4d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * Licensed under the Apache License, Version 2.0 (the "License"); 5d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * you may not use this file except in compliance with the License. 6d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * You may obtain a copy of the License at 7d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * 8d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * http://www.apache.org/licenses/LICENSE-2.0 9d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * 10d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * Unless required by applicable law or agreed to in writing, software 11d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * distributed under the License is distributed on an "AS IS" BASIS, 12d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * See the License for the specific language governing permissions and 14d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * limitations under the License. 15d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood */ 16d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 17d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwoodpackage com.android.internal.midi; 18d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 19d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood/** 20d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * MIDI related constants and static methods. 21d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood */ 22f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwoodpublic final class MidiConstants { 23d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_COMMAND_MASK = (byte) 0xF0; 24d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_CHANNEL_MASK = (byte) 0x0F; 25d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 26d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood // Channel voice messages. 27d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_NOTE_OFF = (byte) 0x80; 28d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_NOTE_ON = (byte) 0x90; 29d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_POLYPHONIC_AFTERTOUCH = (byte) 0xA0; 30d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_CONTROL_CHANGE = (byte) 0xB0; 31d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_PROGRAM_CHANGE = (byte) 0xC0; 32d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_CHANNEL_PRESSURE = (byte) 0xD0; 33d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_PITCH_BEND = (byte) 0xE0; 34d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 35d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood // System Common Messages. 36d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_SYSTEM_EXCLUSIVE = (byte) 0xF0; 37d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_MIDI_TIME_CODE = (byte) 0xF1; 38d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_SONG_POSITION = (byte) 0xF2; 39d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_SONG_SELECT = (byte) 0xF3; 40d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_TUNE_REQUEST = (byte) 0xF6; 41d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_END_SYSEX = (byte) 0xF7; 42d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 43d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood // System Real-Time Messages 44d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_TIMING_CLOCK = (byte) 0xF8; 45d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_START = (byte) 0xFA; 46d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_CONTINUE = (byte) 0xFB; 47d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_STOP = (byte) 0xFC; 48d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_ACTIVE_SENSING = (byte) 0xFE; 49d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static final byte STATUS_RESET = (byte) 0xFF; 50d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 51d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood /** Number of bytes in a message nc from 8c to Ec */ 52d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public final static int CHANNEL_BYTE_LENGTHS[] = { 3, 3, 3, 3, 2, 2, 3 }; 53d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 54d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood /** Number of bytes in a message Fn from F0 to FF */ 55d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public final static int SYSTEM_BYTE_LENGTHS[] = { 1, 2, 3, 2, 1, 1, 1, 1, 1, 56d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 1, 1, 1, 1, 1, 1, 1 }; 57d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 58d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 5998e94aead75dda707eef97828df1db44ce1e7e96Phil Burk /** 6098e94aead75dda707eef97828df1db44ce1e7e96Phil Burk * MIDI messages, except for SysEx, are 1,2 or 3 bytes long. 6198e94aead75dda707eef97828df1db44ce1e7e96Phil Burk * You can tell how long a MIDI message is from the first status byte. 6298e94aead75dda707eef97828df1db44ce1e7e96Phil Burk * Do not call this for SysEx, which has variable length. 6398e94aead75dda707eef97828df1db44ce1e7e96Phil Burk * @param statusByte 6498e94aead75dda707eef97828df1db44ce1e7e96Phil Burk * @return number of bytes in a complete message or zero if data byte passed 6598e94aead75dda707eef97828df1db44ce1e7e96Phil Burk */ 6698e94aead75dda707eef97828df1db44ce1e7e96Phil Burk public static int getBytesPerMessage(byte statusByte) { 6798e94aead75dda707eef97828df1db44ce1e7e96Phil Burk // Java bytes are signed so we need to mask off the high bits 6898e94aead75dda707eef97828df1db44ce1e7e96Phil Burk // to get a value between 0 and 255. 6998e94aead75dda707eef97828df1db44ce1e7e96Phil Burk int statusInt = statusByte & 0xFF; 7098e94aead75dda707eef97828df1db44ce1e7e96Phil Burk if (statusInt >= 0xF0) { 7198e94aead75dda707eef97828df1db44ce1e7e96Phil Burk // System messages use low nibble for size. 7298e94aead75dda707eef97828df1db44ce1e7e96Phil Burk return SYSTEM_BYTE_LENGTHS[statusInt & 0x0F]; 7398e94aead75dda707eef97828df1db44ce1e7e96Phil Burk } else if(statusInt >= 0x80) { 7498e94aead75dda707eef97828df1db44ce1e7e96Phil Burk // Channel voice messages use high nibble for size. 7598e94aead75dda707eef97828df1db44ce1e7e96Phil Burk return CHANNEL_BYTE_LENGTHS[(statusInt >> 4) - 8]; 76d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood } else { 7798e94aead75dda707eef97828df1db44ce1e7e96Phil Burk return 0; // data byte 78d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood } 79d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood } 80d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood 8198e94aead75dda707eef97828df1db44ce1e7e96Phil Burk 82d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood /** 83d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * @param msg 84d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * @param offset 85d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * @param count 86d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood * @return true if the entire message is ActiveSensing commands 87d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood */ 88d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood public static boolean isAllActiveSensing(byte[] msg, int offset, 89d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood int count) { 90d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood // Count bytes that are not active sensing. 91d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood int goodBytes = 0; 92d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood for (int i = 0; i < count; i++) { 93d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood byte b = msg[offset + i]; 94d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood if (b != MidiConstants.STATUS_ACTIVE_SENSING) { 95d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood goodBytes++; 96d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood } 97d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood } 98d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood return (goodBytes == 0); 99d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood } 100f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood 101f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood // Returns true if this command can be used for running status 1028c26d843a786e5ee56046245fbf72a81b533bcb9Mike Lockwood public static boolean allowRunningStatus(byte command) { 103f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood // only Channel Voice and Channel Mode commands can use running status 104f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood return (command >= STATUS_NOTE_OFF && command < STATUS_SYSTEM_EXCLUSIVE); 105f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood } 106f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood 107f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood // Returns true if this command cancels running status 1088c26d843a786e5ee56046245fbf72a81b533bcb9Mike Lockwood public static boolean cancelsRunningStatus(byte command) { 109f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood // System Common messages cancel running status 110f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood return (command >= STATUS_SYSTEM_EXCLUSIVE && command <= STATUS_END_SYSEX); 111f0a41d1c591193fbe02c9ddbaf24c79af4da9972Mike Lockwood } 112d1b16fe2fb7527eee214898263ec4d6dabbfb0b4Mike Lockwood} 113