SandNetPackets.h

/*
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Library General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *
 * SandnetPackets.h
 * Datagram definitions for Sandnet
 * Copyright (C) 2005-2009 Simon Newton
 */

#ifndef PLUGINS_SANDNET_SANDNETPACKETS_H_
#define PLUGINS_SANDNET_SANDNETPACKETS_H_

#include <sys/types.h>
#include <stdint.h>
#include <netinet/in.h>

#include <ola/network/InterfacePicker.h> // MAC_LENGTH
#include <ola/BaseTypes.h>
#include "plugins/sandnet/SandNetCommon.h"

namespace ola {
namespace plugin {
namespace sandnet {

using ola::network::MAC_LENGTH;

enum { SANDNET_NAME_LENGTH = 31};

/*
 * Sandnet opcodes.
 * These are transmitted as little-endian which why they appear strange.
 */
enum packet_type_e {
 SANDNET_ADVERTISMENT = 0x0100,
 SANDNET_CONTROL = 0x0200,
 SANDNET_DMX = 0x0300,
 SANDNET_NAME = 0x0400,
 SANDNET_IDENTIFY = 0x0500,
 SANDNET_PROG = 0x0600,
 SANDNET_LED = 0x0700,
 SANDNET_COMPRESSED_DMX = 0x0a00,
}__attribute__((packed));

typedef enum packet_type_e packet_type_t;

enum protocol_id_e {
 SANDNET_SANDNET = 0x02,
 SANDNET_ARTNET = 0x04,
 SANDNET_COMPULIGHT = 0x06,
 SANDNET_SHOWNET = 0x09,
 SANDNET_IPX = 0x0d,
 SANDNET_ACN = 0x0e,
}__attribute__((packed));

typedef enum protocol_id_e protocol_id_t;

struct sandnet_packet_advertisement_port_s {
 protocol_id_t protocol; // protocol
 uint8_t mode; // mode
 uint8_t term; // terminate
 uint8_t b; // ??
 uint8_t group; // group
 uint8_t universe; // universe
 uint8_t crap[53]; // ??
}__attribute__((packed));


/*
 * A Sandnet Advertisment
 */
struct sandnet_advertisement_s {
 uint8_t mac[ola::network::MAC_LENGTH]; // mac address
 uint32_t firmware; // firmware version
 struct sandnet_packet_advertisement_port_s ports[SANDNET_MAX_PORTS]; // ports
 uint8_t nlen; // length of the name field
 char name[SANDNET_NAME_LENGTH]; // name field (null terminated)
 uint8_t magic3[9]; // magic numbers
 uint8_t led; // flash the led
 uint8_t magic4; // ??
 uint8_t zero4[64]; // null
}__attribute__((packed));

typedef struct sandnet_advertisement_s sandnet_advertisement;


/*
 * The first of the DMX packets
 */
struct sandnet_dmx_s {
 uint8_t group; // group
 uint8_t universe; // universe
 uint8_t port; // physical port number
 uint8_t dmx[DMX_UNIVERSE_SIZE]; // dmx buffer
}__attribute__((packed));

typedef struct sandnet_dmx_s sandnet_dmx;


/*
 * Changes the port attributes
 */
struct sandnet_port_control_s {
 uint8_t mac[MAC_LENGTH]; // mac address
 uint8_t magic[4]; // ?? seems to change
 struct sandnet_packet_advertisement_port_s ports[SANDNET_MAX_PORTS]; // ports
}__attribute__((packed));

typedef struct sandnet_port_control_s sandnet_port_control;


/*
 * Sets the name of the sandnet node
 */
struct sandnet_name_s {
 uint8_t mac[MAC_LENGTH]; // mac address
 uint8_t name_length; // length of the name field
 uint8_t name[SANDNET_NAME_LENGTH]; // name field
}__attribute__((packed));

typedef struct sandnet_name_s sandnet_name;


/*
 * identify packet
 * (presumably this flashes the leds or something)
 */
struct sandnet_identify_s {
 uint8_t mac[MAC_LENGTH]; // mac address
}__attribute__((packed));

typedef struct sandnet_identify_s sandnet_identify;


/*
 * ip program packet
 * sets the node's networking parameters
 */
struct sandnet_program_s {
 uint8_t mac[MAC_LENGTH]; // mac address
 uint8_t ip[4];
 uint8_t dhcp;
 uint8_t netmask[4];
}__attribute__((packed));

typedef struct sandnet_program_s sandnet_program;


/*
 * Turns the led on and off
 */
struct sandnet_led_s {
 uint8_t mac[MAC_LENGTH]; // mac address
 uint8_t led; // 0x00 off, 0xff on
}__attribute__((packed));

typedef struct sandnet_led_s sandnet_led;


/*
 * DMX data
 */
struct sandnet_compressed_dmx_s {
 uint8_t group; // group
 uint8_t universe; // universe
 uint8_t port; // physical port number
 uint8_t zero1[4]; // could be the offset
 uint8_t two; // 0x02
 uint16_t length; // length of data
 uint8_t dmx[DMX_UNIVERSE_SIZE];
} __attribute__((packed));

typedef struct sandnet_compressed_dmx_s sandnet_compressed_dmx;


// A generic Sandnet packet containing the union of all possible packets
struct sandnet_packet {
 uint16_t opcode;
 union {
 sandnet_advertisement advertisement;
 sandnet_port_control port_control;
 sandnet_dmx dmx;
 sandnet_name name;
 sandnet_identify id;
 sandnet_program program;
 sandnet_led led;
 sandnet_compressed_dmx compressed_dmx;
 } contents;
} __attribute__((packed));
} // namespace sandnet
} // namespace plugin
} // namespace ola
#endif // PLUGINS_SANDNET_SANDNETPACKETS_H_