*
* EXPERTS ONLY!! EXPERTS ONLY!!
*
- * This class implements the mapping functions needed to lay out the physical
+ * This file implements the mapping functions needed to lay out the physical
* cubes and the output ports on the panda board. It should only be modified
* when physical changes or tuning is being done to the structure.
*/
-class SCMapping implements GLucose.Mapping {
- public Cube[] buildCubeArray() {
- // TODO(mcslee): find a cleaner way of representing this data, probably
- // serialized in some more neutral form. also figure out what's going on
- // with the indexing starting at 1 and some indices missing.
- Cube[] cubes = new Cube[79];
-
- int cubeIndex = 1;
+
+public Model buildModel() {
+
+ final float BASS_FLOOR = BassBox.EDGE_HEIGHT + BoothFloor.PLEXI_WIDTH;
+
+ // Shorthand helpers for specifying wiring more quickly
+ final Cube.Wiring WFL = Cube.Wiring.FRONT_LEFT;
+ final Cube.Wiring WFR = Cube.Wiring.FRONT_RIGHT;
+ final Cube.Wiring WRL = Cube.Wiring.REAR_LEFT;
+ final Cube.Wiring WRR = Cube.Wiring.REAR_RIGHT;
+
+ // The model is represented as an array of towers. The cubes in the tower
+ // are represenented relatively. Each tower has an x, y, z reference position,
+ // which is typically the base cube's bottom left corner.
+ //
+ // Following that is an array of floats. A 2-d array contains an x-offset
+ // and a z-offset from the previous reference position. Typically the first cube
+ // will just be {0, 0}. Each successive cube uses the position of the previous
+ // cube as its reference.
+ //
+ // A 3-d array contains an x-offset, a z-offset, and a rotation about the
+ // y-axis.
+ //
+ // The cubes automatically increment their y-position by Cube.EDGE_HEIGHT.
+ TowerMapping[] towerCubes = new TowerMapping[] {
- cubes[cubeIndex++] = new Cube(0, 0, 0, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(5, Cube.EDGE_HEIGHT, -10, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(0, 2*Cube.EDGE_HEIGHT, -6, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(-5, 3*Cube.EDGE_HEIGHT, -2, 0, -20, 0);
-
- cubes[cubeIndex++] = new Cube(15, 0, 50, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(20, Cube.EDGE_HEIGHT, 40, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(15, 2*Cube.EDGE_HEIGHT, 46, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(10, 3*Cube.EDGE_HEIGHT, 42, 0, -20, 0);
- cubes[cubeIndex++] = new Cube(15, 4*Cube.EDGE_HEIGHT, 42, 0, 0, 0);
-
- cubes[cubeIndex++] = new Cube(40, BASS_HEIGHT + 5, 20, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(45, BASS_HEIGHT + 5+Cube.EDGE_HEIGHT, 10, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(40, BASS_HEIGHT + 5+2*Cube.EDGE_HEIGHT, 14, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(35, BASS_HEIGHT + 5+3*Cube.EDGE_HEIGHT, 18, 0, -20, 0);
- cubes[cubeIndex++] = new Cube(40, BASS_HEIGHT + 5+4*Cube.EDGE_HEIGHT, 13, 0, 0, 0);
-
- cubes[cubeIndex++] = new Cube(80, BASS_HEIGHT + 0, 10, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(85, BASS_HEIGHT + Cube.EDGE_HEIGHT, 0, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(80, BASS_HEIGHT + 2*Cube.EDGE_HEIGHT, 4, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(75, BASS_HEIGHT + 3*Cube.EDGE_HEIGHT, 8, 0, -20, 0);
- cubes[cubeIndex++] = new Cube(80, BASS_HEIGHT + 4*Cube.EDGE_HEIGHT, 3, 0, 0, 0);
-
- cubes[cubeIndex++] = new Cube(120, BASS_HEIGHT + 10, 10, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(125, BASS_HEIGHT + 10+Cube.EDGE_HEIGHT, 0, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(120, BASS_HEIGHT + 10+2*Cube.EDGE_HEIGHT, 4, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(115, BASS_HEIGHT + 10+3*Cube.EDGE_HEIGHT, 8, 0, -20, 0);
- cubes[cubeIndex++] = new Cube(120, BASS_HEIGHT + 10+4*Cube.EDGE_HEIGHT, 3, 0, 0, 0);
-
- cubes[cubeIndex++] = new Cube(160, BASS_HEIGHT + 0, 30, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(165, BASS_HEIGHT + Cube.EDGE_HEIGHT, 20, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(160, BASS_HEIGHT + 2*Cube.EDGE_HEIGHT, 24, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(155, BASS_HEIGHT + 3*Cube.EDGE_HEIGHT, 28, 0, -20, 0);
- cubes[cubeIndex++] = new Cube(160, BASS_HEIGHT + 4*Cube.EDGE_HEIGHT, 23, 0, 0, 0);
-
- cubes[cubeIndex++] = new Cube(200, 0, 10, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(205, Cube.EDGE_HEIGHT, 0, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(200, 2*Cube.EDGE_HEIGHT, 4, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(195, 3*Cube.EDGE_HEIGHT, 8, 0, -20, 0);
- cubes[cubeIndex++] = new Cube(200, 4*Cube.EDGE_HEIGHT, 3, 0, 0, 0);
-
- cubes[cubeIndex++] = new Cube(210, 0, 60, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(215, Cube.EDGE_HEIGHT, 50, 0, 20, 0);
- cubes[cubeIndex++] = new Cube(210, 2*Cube.EDGE_HEIGHT, 54, 0, 0, 0);
- cubes[cubeIndex++] = new Cube(205, 3*Cube.EDGE_HEIGHT, 58, 0, -20, 0);
+ new TowerMapping(50, 0, 80, new CubeMapping[] {
+ new CubeMapping(0, 0, WFL),
+ }),
- return cubes;
+ };
+
+ // Single cubes can be constructed directly here if you need them
+ Cube[] singleCubes = new Cube[] {
+ // new Cube(x, y, z, rx, ry, rz, wiring),
+ };
+
+ // The bass box!
+ BassBox bassBox = new BassBox(56, 0, 2);
+
+ // The speakers!
+ List<Speaker> speakers = Arrays.asList(new Speaker[] {
+ new Speaker(-12, 6, 0, 15),
+ new Speaker(TRAILER_WIDTH - Speaker.EDGE_WIDTH, 6, 6, -15)
+ });
+
+ // These guts just convert the shorthand mappings into usable objects
+ ArrayList<Tower> towerList = new ArrayList<Tower>();
+ ArrayList<Cube> tower;
+ Cube[] cubes = new Cube[80];
+ int cubeIndex = 1;
+ float px, pz, ny;
+ for (TowerMapping tm : towerCubes) {
+ px = tm.x;
+ ny = tm.y;
+ pz = tm.z;
+ tower = new ArrayList<Cube>();
+ for (CubeMapping cm : tm.cubeMappings) {
+ tower.add(cubes[cubeIndex++] = new Cube(px = px + cm.dx, ny, pz = pz + cm.dz, 0, cm.ry, 0, cm.wiring));
+ ny += Cube.EDGE_HEIGHT;
+ }
+ towerList.add(new Tower(tower));
+ }
+ for (Cube cube : singleCubes) {
+ cubes[cubeIndex++] = cube;
+ }
+
+ return new Model(towerList, cubes, bassBox, speakers);
+}
+
+public PandaMapping[] buildPandaList() {
+ return new PandaMapping[] {
+ new PandaMapping(
+ "10.200.1.28", new ChannelMapping[] {
+ new ChannelMapping(ChannelMapping.MODE_BASS),
+ new ChannelMapping(ChannelMapping.MODE_FLOOR),
+ new ChannelMapping(ChannelMapping.MODE_SPEAKER, 0),
+ new ChannelMapping(ChannelMapping.MODE_SPEAKER, 1),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { 1 }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ }),
+
+ new PandaMapping(
+ "10.200.1.29", new ChannelMapping[] {
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ new ChannelMapping(ChannelMapping.MODE_CUBES, new int[] { }),
+ }),
+ };
+}
+
+class TowerMapping {
+ public final float x, y, z;
+ public final CubeMapping[] cubeMappings;
+
+ TowerMapping(float x, float y, float z, CubeMapping[] cubeMappings) {
+ this.x = x;
+ this.y = y;
+ this.z = z;
+ this.cubeMappings = cubeMappings;
+ }
+}
+
+class CubeMapping {
+ public final float dx, dz, ry;
+ public final Cube.Wiring wiring;
+
+ CubeMapping(float dx, float dz, Cube.Wiring wiring) {
+ this(dx, dz, 0, wiring);
}
- public int[][] buildFrontChannelList() {
- return new int[][] {
- { 1, 2, 3, 0, 0 }, // ch1
- { 4, 5, 6, 0, 0 }, // ch2
- { 0, 0, 0, 0, 0 }, // ch3
- { 0, 0, 0, 0, 0 }, // ch4
- { 0, 0, 0, 0, 0 }, // ch5
- { 0, 0, 0, 0, 0 }, // ch6
- { 0, 0, 0, 0, 0 }, // ch7
- { 0, 0, 0, 0, 0 }, // ch8
- };
+ CubeMapping(float dx, float dz, float ry) {
+ this(dz, dz, ry, Cube.Wiring.FRONT_LEFT);
}
+
+ CubeMapping(float dx, float dz, float ry, Cube.Wiring wiring) {
+ this.dx = dx;
+ this.dz = dz;
+ this.ry = ry;
+ this.wiring = wiring;
+ }
+}
+
+/**
+ * Each panda board has an IP address and a fixed number of channels. The channels
+ * each have a fixed number of pixels on them. Whether or not that many physical
+ * pixels are connected to the channel, we still send it that much data.
+ */
+class PandaMapping {
+
+ // How many channels are on the panda board
+ public final static int CHANNELS_PER_BOARD = 13;
+
+ // How many total pixels on the whole board
+ public final static int PIXELS_PER_BOARD = ChannelMapping.PIXELS_PER_CHANNEL * CHANNELS_PER_BOARD;
+
+ final String ip;
+ final ChannelMapping[] channelList = new ChannelMapping[CHANNELS_PER_BOARD];
+
+ PandaMapping(String ip, ChannelMapping[] rawChannelList) {
+ this.ip = ip;
+
+ // Ensure our array is the right length and has all valid items in it
+ for (int i = 0; i < channelList.length; ++i) {
+ channelList[i] = (i < rawChannelList.length) ? rawChannelList[i] : new ChannelMapping();
+ if (channelList[i] == null) {
+ channelList[i] = new ChannelMapping();
+ }
+ }
+ }
+}
+
+/**
+ * Each channel on a pandaboard can be mapped in a number of modes. The typial is
+ * to a series of connected cubes, but we also have special mappings for the bass box,
+ * the speaker enclosures, and the DJ booth floor.
+ *
+ * This class is just the mapping meta-data. It sanitizes the input to make sure
+ * that the cubes and objects being referenced actually exist in the model.
+ *
+ * The logic for how to encode the pixels is contained in the PandaDriver.
+ */
+class ChannelMapping {
+
+ // How many cubes per channel xc_PB is configured for
+ public final static int CUBES_PER_CHANNEL = 4;
- public int[][] buildRearChannelList() {
- return new int[][] {
- { 0, 0, 0, 0, 0 }, // ch9
- { 0, 0, 0, 0, 0 }, // ch10
- { 0, 0, 0, 0, 0 }, // ch11
- { 0, 0, 0, 0, 0 }, // ch12
- { 0, 0, 0, 0, 0 }, // ch13
- { 0, 0, 0, 0, 0 }, // ch14
- { 0, 0, 0, 0, 0 }, // ch15
- { 0, 0, 0, 0, 0 }, // ch16
- };
+ // How many total pixels on each channel
+ public final static int PIXELS_PER_CHANNEL = Cube.POINTS_PER_CUBE * CUBES_PER_CHANNEL;
+
+ public static final int MODE_NULL = 0;
+ public static final int MODE_CUBES = 1;
+ public static final int MODE_BASS = 2;
+ public static final int MODE_SPEAKER = 3;
+ public static final int MODE_FLOOR = 4;
+ public static final int MODE_INVALID = 5;
+
+ public static final int NO_OBJECT = -1;
+
+ final int mode;
+ final int[] objectIndices = new int[CUBES_PER_CHANNEL];
+
+ ChannelMapping() {
+ this(MODE_NULL);
+ }
+
+ ChannelMapping(int mode) {
+ this(mode, new int[]{});
+ }
+
+ ChannelMapping(int mode, int rawObjectIndex) {
+ this(mode, new int[]{ rawObjectIndex });
+ }
+
+ ChannelMapping(int mode, int[] rawObjectIndices) {
+ if (mode < 0 || mode >= MODE_INVALID) {
+ throw new RuntimeException("Invalid channel mapping mode: " + mode);
+ }
+ if (mode == MODE_SPEAKER) {
+ if (rawObjectIndices.length != 1) {
+ throw new RuntimeException("Speaker channel mapping mode must specify one speaker index");
+ }
+ int speakerIndex = rawObjectIndices[0];
+ if (speakerIndex < 0 || speakerIndex >= glucose.model.speakers.size()) {
+ throw new RuntimeException("Invalid speaker channel mapping: " + speakerIndex);
+ }
+ } else if ((mode == MODE_FLOOR) || (mode == MODE_BASS) || (mode == MODE_NULL)) {
+ if (rawObjectIndices.length > 0) {
+ throw new RuntimeException("Bass/floor/null mappings cannot specify object indices");
+ }
+ } else if (mode == MODE_CUBES) {
+ for (int rawCubeIndex : rawObjectIndices) {
+ if (glucose.model.getCubeByRawIndex(rawCubeIndex) == null) {
+ throw new RuntimeException("Non-existing cube specified in cube mapping: " + rawCubeIndex);
+ }
+ }
+ }
+
+ this.mode = mode;
+ for (int i = 0; i < objectIndices.length; ++i) {
+ objectIndices[i] = (i < rawObjectIndices.length) ? rawObjectIndices[i] : NO_OBJECT;
+ }
}
}