org.deepsymmetry.beatlink

Class DeviceUpdate

java.lang.Object

org.deepsymmetry.beatlink.DeviceUpdate

Direct Known Subclasses:

Beat, CdjStatus, MixerStatus

public abstract class DeviceUpdate
extends Object

Represents a device status update seen on a DJ Link network.

Author:

James Elliott

Field Summary

Fields

Modifier and Type	Field and Description
protected InetAddress	address The address from which this device update was received.
protected String	deviceName The name of the device sending the update.
protected int	deviceNumber The player/device number sending the update.
protected byte[]	packetBytes The packet data containing the device update.
protected long	timestamp When this update was received.

Constructor Summary

Constructors

Constructor and Description
DeviceUpdate(DatagramPacket packet, String name, int length) Constructor sets all the immutable interpreted fields based on the packet content.

Method Summary

Modifier and Type	Method and Description
InetAddress	getAddress() Get the address of the device from which this update was seen.
abstract int	getBeatWithinBar() Get the position within a measure of music at which this beat falls (a value from 1 to 4, where 1 represents the down beat).
String	getDeviceName() Get the name reported by the device sending the update.
int	getDeviceNumber() Get the player/device number reporting the update.
abstract double	getEffectiveTempo() Get the effective tempo reflected by this update, which reflect both its track BPM and pitch as needed.
byte[]	getPacketBytes() Get the raw data bytes of the device update packet.
long	getTimestamp() Get the timestamp recording when the device update was received.
abstract boolean	isBeatWithinBarMeaningful() Returns true if this update is coming from a device where getBeatWithinBar() can reasonably be expected to have musical significance, because it respects the way a track was configured within rekordbox.
abstract boolean	isTempoMaster() Is this device reporting itself to be the current tempo master?

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

address

protected final InetAddress address

The address from which this device update was received.

timestamp

protected final long timestamp

When this update was received.

deviceName

protected final String deviceName

The name of the device sending the update.

deviceNumber

protected final int deviceNumber

The player/device number sending the update.

packetBytes

protected final byte[] packetBytes

The packet data containing the device update.

Constructor Detail

DeviceUpdate

public DeviceUpdate(DatagramPacket packet,
                    String name,
                    int length)

Constructor sets all the immutable interpreted fields based on the packet content.

Parameters:

packet - the device update packet that was received

name - the type of packet that is being processed, in case a problem needs to be reported

length - the expected length of the packet

Method Detail

getAddress

public InetAddress getAddress()

Get the address of the device from which this update was seen.

Returns:

the network address from which the update was sent

getTimestamp

public long getTimestamp()

Get the timestamp recording when the device update was received.

Returns:

the millisecond timestamp at which we received this update

getDeviceName

public String getDeviceName()

Get the name reported by the device sending the update.

Returns:

the device name

getDeviceNumber

public int getDeviceNumber()

Get the player/device number reporting the update.

Returns:

the player number found in the update packet

getPacketBytes

public byte[] getPacketBytes()

Get the raw data bytes of the device update packet.

Returns:

the data sent by the device to update its status

isTempoMaster

public abstract boolean isTempoMaster()

Is this device reporting itself to be the current tempo master?

Returns:

true if the device that sent this update is the master

Throws:

IllegalStateException - if the VirtualCdj is not running.

getEffectiveTempo

public abstract double getEffectiveTempo()

Get the effective tempo reflected by this update, which reflect both its track BPM and pitch as needed.

Returns:

the beats per minute this device is reporting

getBeatWithinBar

public abstract int getBeatWithinBar()

Get the position within a measure of music at which this beat falls (a value from 1 to 4, where 1 represents the down beat). This value will be accurate for players when the track was properly configured within rekordbox (and if the music follows a standard House 4/4 time signature). The mixer makes no effort to synchronize down beats with players, however, so this value is meaningless when coming from the mixer. The usefulness of this value can be checked with isBeatWithinBarMeaningful().

Returns:

the beat number within the current measure of music

isBeatWithinBarMeaningful

public abstract boolean isBeatWithinBarMeaningful()

Returns true if this update is coming from a device where getBeatWithinBar() can reasonably be expected to have musical significance, because it respects the way a track was configured within rekordbox.

Returns:

true for status packets from players, false for status packets from mixers