tools/BlinkenOutput.c (c9469b6) - BlinkenLib · BlinkenArea

BlinkenOutput.c

/* BlinkenLib
   Copyright 2004-2014 Stefan Schuermans <stefan@schuermans.info>
   Copyleft GNU public license - http://www.gnu.org/copyleft/gpl.html
   a blinkenarea.org project */
/* OS X support by Manfred Wuits
   <manfred@werkzeugH.at> */

#include <errno.h>
#include <fcntl.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <termios.h>
#include <time.h>
#include <unistd.h>
#include <arpa/inet.h>
#include <netinet/in.h>
#include <sys/types.h>
#include <sys/time.h>
#include <sys/socket.h>

#include <BlinkenLib/BlinkenLib.h>

// get serial settings from text
static int serial_settings_parse(char *str, int *settings, int *speed)
{
  int baud, data, stop;
  char parity;
  int set = 0, sp = 0;

// split and parse settings string
  if (sscanf(str, "%i,%c,%i,%i", &baud, &parity, &data, &stop) != 4)
    return 0;

// baud rate
#define BAUD(rate) else if (baud == rate) sp = B ## rate;
  if (0) {}
  BAUD(300)
  BAUD(600)
  BAUD(1200)
  BAUD(2400)
  BAUD(4800)
  BAUD(9600)
  BAUD(19200)
  BAUD(38400)
  BAUD(57600)
  BAUD(115200)
#ifdef B230400
  BAUD(230400)
#endif
#ifdef B460800
  BAUD(460800)
#endif
#ifdef B576000
  BAUD(576000)
#endif
#ifdef B921600
  BAUD(921600)
#endif
#ifdef B1000000
  BAUD(1000000)
#endif
#ifdef B1152000
  BAUD(1152000)
#endif
#ifdef B1500000
  BAUD(1500000)
#endif
#ifdef B2000000
  BAUD(2000000)
#endif
#ifdef B2500000
  BAUD(2500000)
#endif
#ifdef B3000000
  BAUD(3000000)
#endif
#ifdef B3500000
  BAUD(3500000)
#endif
#ifdef B4000000
  BAUD(4000000)
#endif
  else {
    printf("illegal baudrate: %d\n", baud);
    return 0;
  }

// parity
  if (parity == 'n' || parity == 'N')
    set |= 0;
  else if (parity == 'e' || parity == 'E')
    set |= PARENB;
  else if (parity == 'o' || parity == 'O')
    set |= PARENB | PARODD;
  else {
    printf("invalid parity: %c\n", parity);
    return 0;
  }

// data bits
  if (data == 5)
    set |= CS5;
  else if (data == 6)
    set |= CS6;
  else if (data == 7)
    set |= CS7;
  else if (data == 8)
    set |= CS8;
  else {
    printf("illegal number of data bits: %d\n", data);
    return 0;
  }

// stop bits
  if (stop == 1)
    set |= 0;
  else if (stop == 2)
    set |= CSTOPB;
  else {
    printf("illegal number of stop bits: %d\n", stop);
    return 0;
  }

// success
  *settings = set;
  *speed = sp;
  return 1;
}

// convert serial settings to text
static void serial_settings_to_str(int settings, char *buf,
                                   unsigned int maxlen)
{
  int baud, data, stop;
  char parity;

// baud rate
  if (settings & B300)
    baud = 300;
  else if (settings & B600)
    baud = 600;
  else if (settings & B1200)
    baud = 1200;
  else if (settings & B2400)
    baud = 2400;
  else if (settings & B4800)
    baud = 4800;
  else if (settings & B9600)
    baud = 9600;
  else if (settings & B19200)
    baud = 19200;
  else if (settings & B38400)
    baud = 38400;
  else if (settings & B57600)
    baud = 57600;
  else if (settings & B115200)
    baud = 115200;
  else
    baud = 0;

// parity
  if (settings & PARENB)
    if (settings & PARODD)
      parity = 'O';
    else
      parity = 'E';
  else
    parity = 'N';

// data bits
  if (settings & CS5)
    data = 5;
  else if (settings & CS6)
    data = 6;
  else if (settings & CS7)
    data = 7;
  else if (settings & CS8)
    data = 8;
  else
    data = 0;

// stop bits
  if (settings & CSTOPB)
    stop = 2;
  else
    stop = 1;

snprintf(buf, maxlen, "%d,%c,%d,%d", baud, parity, data, stop);
}

// set serial settings for fd
static int serial_settings_set(int fd, int settings, int speed)
{
  struct termios tio;

// set port settings
  bzero(&tio, sizeof(tio));
  tio.c_cflag = CLOCAL | HUPCL | CREAD | settings;
  tio.c_iflag = IGNBRK | IGNPAR;
  tio.c_oflag = 0;
  tio.c_lflag = 0;
  tio.c_cc[VTIME] = 10; // 1 sec timeout
  tio.c_cc[VMIN] = 0;   // return on single char read

#ifdef BLINKENLIB_CFG_OSX
  if (cfsetspeed(&tio, speed) == -1) {
    printf("cfsetspeed: error: %s\n", strerror(errno));
    return 0;
  }
#else // #ifdef BLINKENLIB_CFG_OSX
  tio.c_cflag |= speed;
#endif // #ifdef BLINKENLIB_CFG_OSX

if (tcsetattr(fd, TCSANOW, &tio) == -1) {
    printf("tcsetattr: error: %s\n", strerror(errno));
    return 0;
  }
  // success
  return 1;
}

// receive frames from socket and output them
// dev_fd may be -1 for not doing anything with device
// returns error code (not for device-errors, 0 for success)
static int recv_and_out(SOCKET udpSocket, int dev_fd,
                        int *p_device_output_active,
                        unsigned int min_interval_ms,
                        unsigned int format_change,
                        unsigned int format_height, unsigned int format_width,
                        unsigned int format_channels,
                        unsigned int format_colors, etBlinkenProto proto,
                        int use_msecs, unsigned int msecs)
{
  fd_set readFds, errFds;
  stBlinkenFrame *pFrame;
  char buffer[65536];   // 64kB is more than maximum UDP size
  int maxFd, len, dev_eof, out_ok;
  struct timeval start, timeout, *p_timeout, end;
  struct timeval out_last, out_now;

dev_eof = 0;
  gettimeofday(&out_last, NULL);
  for (;;) {
    // wait for next frame
    FD_ZERO(&readFds);
    FD_SET(udpSocket, &readFds);
    if (dev_fd != -1 && !dev_eof)
      FD_SET(dev_fd, &readFds);
    FD_ZERO(&errFds);
    FD_SET(udpSocket, &errFds);
    if (dev_fd != -1)
      FD_SET(dev_fd, &errFds);
    maxFd = 0;
    if (udpSocket > maxFd)
      maxFd = udpSocket;
    if (dev_fd != -1 && dev_fd > maxFd)
      maxFd = dev_fd;
    if (use_msecs)      // timeout
    {
      gettimeofday(&start, NULL);
      timeout.tv_sec = msecs / 1000;
      timeout.tv_usec = msecs % 1000 * 1000;
      p_timeout = &timeout;
    } else
      p_timeout = NULL;
    if (select(maxFd + 1, &readFds, NULL, &errFds, p_timeout) < 0)      // error
    {
      printf("error during select: %s\n", strerror(errno));
      return -1;
    }
    // error on socket or device
    if (FD_ISSET(udpSocket, &errFds)) {
      printf("error on socket\n");
      return -1;
    }
    if (dev_fd != -1 && FD_ISSET(dev_fd, &errFds)) {
      if (*p_device_output_active)
        printf("error on device\n");
      break;
    }
    // received frame
    if (FD_ISSET(udpSocket, &readFds)) {
      // fetch data
      len = recv(udpSocket, buffer, sizeof(buffer), 0);
      if (len < 0) {
        printf("could not read from socket\n");
        return -1;
      }
      if (len == 0)
        return -1;

// get frame from data
      pFrame = BlinkenFrameFromNetwork(buffer, len, NULL);
      if (pFrame != NULL) {
        // change format
        if (format_change)
          BlinkenFrameResize(pFrame, format_height, format_width,
                             format_channels, format_colors - 1);

// create output data from frame
        len = BlinkenFrameToNetwork(pFrame, proto, buffer, sizeof(buffer));

// free frame
        BlinkenFrameFree(pFrame);

// check if minimum interval between output frames is met
        gettimeofday(&out_now, NULL);
        if (out_now.tv_sec > out_last.tv_sec - (int)min_interval_ms / 1000)
          out_ok = 1;
        else if ((out_now.tv_sec - out_last.tv_sec) * 1000 +
                 ((long)out_now.tv_usec - (long)out_last.tv_usec) / 1000 >
                 (long)min_interval_ms)
          out_ok = 1;
        else
          out_ok = 0;

// output data to device
        if (dev_fd != -1 && len > 0 && out_ok) {
          if (write(dev_fd, buffer, len) != len) {
            if (*p_device_output_active)
              printf("error writing to device\n");
            break;
          }
          // message: output to device was restarted
          if (!*p_device_output_active)
            printf("restarted output to device...\n");
          *p_device_output_active = 1;
          // remember last time of output
          out_last = out_now;
        }
      }
    }
    // received data from device
    if (dev_fd != -1 && FD_ISSET(dev_fd, &readFds)) {
      // read data
      len = read(dev_fd, buffer, sizeof(buffer));
      if (len < 0) {
        if (*p_device_output_active)
          printf("error reading from device\n");
        break;
      }
      if (len == 0)
        dev_eof = 1;
    }
    // using time limit
    if (use_msecs) {
      // get time elapsed
      int sec, usec;
      unsigned int msec;
      gettimeofday(&end, NULL);
      sec = end.tv_sec - start.tv_sec;
      usec = end.tv_usec - start.tv_usec;
      if (usec < 0) {
        usec += 1000000;
        sec--;
      }
      if (usec < 0)
        usec = 0;
      if (sec < 0)
        sec = 0;
      msec = sec * 1000 + usec / 1000;
      // more than rest of timeout (or exact match)
      if (msec >= msecs)
        break;
      msecs -= msec;
    }

}     // for( ; ; )

return 0;
}

// open device and output frames
// returns error code (not for device-errors, 0 for success)
static int open_and_output(SOCKET udpSocket, char *device,
                           int *p_device_output_active,
                           int serial_settings_change, int serial_settings,
                           int serial_speed,
                           unsigned int min_interval_ms,
                           unsigned int format_change,
                           unsigned int format_height,
                           unsigned int format_width,
                           unsigned int format_channels,
                           unsigned int format_colors, etBlinkenProto proto)
{
  int dev_fd, err;
  char txt[64];

// open device
  dev_fd = open(device, O_RDWR | O_NOCTTY | O_NONBLOCK);
  if (dev_fd == -1) {
    if (*p_device_output_active)
      printf("could not open \"%s\": error: %s\n", device, strerror(errno));
    return 0;
  }
  // setup serial port
  if (serial_settings_change) {
    if (!serial_settings_set(dev_fd, serial_settings, serial_speed)) {
      if (*p_device_output_active) {
        serial_settings_to_str(serial_settings, txt, sizeof(txt));
        printf("could not set serial port to \"%s\"\n", txt);
      }
      close(dev_fd);
      return 0;
    }
  }
  // receive frames and output to device
  err = recv_and_out(udpSocket, dev_fd, p_device_output_active,
                     min_interval_ms,
                     format_change, format_height, format_width,
                     format_channels, format_colors, proto, 0, 0);

// close device
  close(dev_fd);

return err;
}

// open device and output frames in a loop
// returns error code (not for device-errors, 0 for success)
static int open_and_output_loop(SOCKET udpSocket, char *device,
                                int serial_settings_change,
                                int serial_settings, int serial_speed,
                                int reopen_device,
                                unsigned int reopen_device_ms,
                                unsigned int min_interval_ms,
                                unsigned int format_change,
                                unsigned int format_height,
                                unsigned int format_width,
                                unsigned int format_channels,
                                unsigned int format_colors,
                                etBlinkenProto proto)
{
  int device_output_active, err;

printf("receiving frames and outputting them to \"%s\"...\n", device);
  device_output_active = 1;

for (;;) {

// try to open device and output frames
    err = open_and_output(udpSocket, device,
                          &device_output_active,
                          serial_settings_change, serial_settings,
                          serial_speed, min_interval_ms,
                          format_change, format_height,
                          format_width, format_channels, format_colors,
                          proto);
    if (err != 0 || !reopen_device)
      break;

// output to device stopped
    if (device_output_active)
      printf("output to device stopped...\n");
    device_output_active = 0;

// only fetch data from socket for a short time
    err = recv_and_out(udpSocket, -1, &device_output_active,
                       min_interval_ms,
                       format_change, format_height, format_width,
                       format_channels, format_colors, proto, 1,
                       reopen_device_ms);
    if (err != 0)
      break;

}

// output to device finshed
  if (device_output_active)
    printf("output to device finished...\n");
  device_output_active = 0;

return err;
}

int main(int argCnt, char **args)
{
  int i, bound, serial_settings, serial_speed;
  SOCKET udpSocket;
  etBlinkenProto proto;
  unsigned int format_change, format_height, format_width, format_channels,
      format_colors;
  unsigned int height, width, channels, colors;
  unsigned int reopen_device_ms, min_interval_ms;
  int serial_settings_change, reopen_device;
  char txt[64];
  unsigned short port;
  struct sockaddr_in addr;
  char *device;

// print info
  printf("BlinkenLib - BlinkenOutput\n"
         "version %d.%d.%d\n"
         "config " BLINKENLIB_CONFIG "\n"
         "Copyright 2004-2014 Stefan Schuermans <stefan@schuermans.info>\n"
         "Copyleft GNU public license - http://www.gnu.org/copyleft/gpl.html\n"
         "a blinkenarea.org project\n\n",
         BLINKENLIB_VERSION_MAJOR, BLINKENLIB_VERSION_MINOR,
         BLINKENLIB_VERSION_REVISION);

// print syntax
  if (argCnt <= 1) {
    printf("syntax: %s <parameter> [...]\n\n"
           "parameters:\n"
           "  -l [<ip>:]<port>\n"
           "     local address (defaults to 0.0.0.0:2323)\n"
           "     must occur before -r, may only occur once\n"
           "  -r <ip>[:<port>]\n"
           "     remote addess (defaults to every remote address)\n"
           "  -p [BLP|EBLP|MCUF]\n"
           "     protocol to output frames in (defaults to MCUF)\n"
           "  -f <width>x<height>-<channels>/<colors>\n"
           "     format to output frames in (defaults to no change)\n"
           "  -d <device>\n"
           "     device to output frames to (defaults to \"/dev/null\")\n"
           "  -s <baud-rate>,<parity>,<data-bits>,<stop-bits>\n"
           "     settings to use for serial devices (defaults to no change)\n"
           "  -o <milliseconds>\n"
           "     reopen device after short time on error (defaults to not reopen)\n"
           "  -i <milliseconds>\n"
           "     minimum interval between two frames on output (defaults to 0)\n"
           "\n", args[0]);
    return 0;
  }
  // create udp socket
  udpSocket = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP);
  if (udpSocket == INVALID_SOCKET) {
    printf("cannot create UDP socket\n");
    return -1;
  }
  bound = 0;

// process parameters
  proto = BlinkenProtoMcuf;
  format_change = 0;
  format_height = 0;
  format_width = 0;
  format_channels = 0;
  format_colors = 0;
  device = "/dev/null";
  serial_settings = 0;
  serial_speed = 0;
  serial_settings_change = 0;
  reopen_device = 0;
  min_interval_ms = 0;
  for (i = 1; i < argCnt; i++) {

// local address
    if (strcmp(args[i], "-l") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (sscanf(args[i], "%32[0-9.]:%hu", txt, &port) == 2) {
          addr.sin_family = AF_INET;
          addr.sin_port = htons(port);
          addr.sin_addr.s_addr = inet_addr(txt);
          if (bind(udpSocket, (struct sockaddr *)&addr, sizeof(addr)) != 0)
            printf("could not set local address to \"%s\"\n", args[i]);
          else
            bound = 1;
        } else if (sscanf(args[i], "%hu", &port) == 1) {
          addr.sin_family = AF_INET;
          addr.sin_port = htons(port);
          addr.sin_addr.s_addr = htonl(INADDR_ANY);
          if (bind(udpSocket, (struct sockaddr *)&addr, sizeof(addr)) != 0)
            printf("could not set local address to \"%s\"\n", args[i]);
          else
            bound = 1;
        } else
          printf("invalid local address \"%s\"\n", args[i]);
      } else
        printf("missing local address for \"-l\"\n");
    }
    // remote address
    else if (strcmp(args[i], "-r") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (sscanf(args[i], "%32[0-9.]:%hu", txt, &port) == 2) {
          addr.sin_family = AF_INET;
          addr.sin_port = htons(port);
          addr.sin_addr.s_addr = inet_addr(txt);
          if (connect(udpSocket, (struct sockaddr *)&addr, sizeof(addr)) != 0)
            printf("could not set remote address to \"%s\"\n", args[i]);
        } else if (sscanf(args[i], "%32[0-9.]", txt) == 1) {
          addr.sin_family = AF_INET;
          addr.sin_port = htons(23230);
          addr.sin_addr.s_addr = inet_addr(txt);
          if (connect(udpSocket, (struct sockaddr *)&addr, sizeof(addr)) != 0)
            printf("could not set remote address to \"%s\"\n", args[i]);
        } else
          printf("invalid remote address \"%s\"\n", args[i]);
      } else
        printf("missing remote address for \"-r\"\n");
    }
    // protocol to output frames in
    else if (strcmp(args[i], "-p") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (strcasecmp(args[i], "BLP") == 0)
          proto = BlinkenProtoBlp;
        else if (strcasecmp(args[i], "EBLP") == 0)
          proto = BlinkenProtoEblp;
        else if (strcasecmp(args[i], "MCUF") == 0)
          proto = BlinkenProtoMcuf;
        else
          printf("unknown protocol \"%s\"\n", args[i]);
      } else
        printf("missing protocol for \"-p\"\n");
    }
    // format to output frames in
    else if (strcmp(args[i], "-f") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (sscanf
            (args[i], "%ux%u-%u/%u", &width, &height, &channels, &colors) == 4
            && width > 0 && width < 1000 && height > 0 && height < 1000
            && channels > 0 && channels < 20 && colors > 1 && colors <= 256) {
          format_change = 1;
          format_height = height;
          format_width = width;
          format_channels = channels;
          format_colors = colors;
        } else
          printf("invalid frame format \"%s\"\n", args[i]);
      } else
        printf("missing frame format for \"-r\"\n");
    }
    // device to output frames to
    else if (strcmp(args[i], "-d") == 0) {
      if (i + 1 < argCnt) {
        i++;
        device = args[i];
      } else
        printf("missing device name for \"-d\"\n");
    }
    // settings for serial output devices
    else if (strcmp(args[i], "-s") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (serial_settings_parse(args[i], &serial_settings, &serial_speed)) {
          serial_settings_change = 1;
        } else
          printf("invalid serial settings \"%s\"\n", args[i]);
      } else
        printf("missing serial settings for \"-s\"\n");
    }
    // reopen device on error after some time
    else if (strcmp(args[i], "-o") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (sscanf(args[i], "%u", &reopen_device_ms) == 1
            && reopen_device_ms >= 1)
          reopen_device = 1;
        else
          printf("invalid number of milliseconds \"%s\"\n", args[i]);
      } else
        printf("missing time for \"-o\"\n");
    }
    // minimum interval between two frame on output
    else if (strcmp(args[i], "-i") == 0) {
      if (i + 1 < argCnt) {
        i++;
        if (sscanf(args[i], "%u", &min_interval_ms) != 1) {
          min_interval_ms = 0;
          printf("invalid number of milliseconds \"%s\"\n", args[i]);
        }
      } else
        printf("missing time for \"-i\"\n");
    }
    // unknown parameter
    else
      printf
          ("unknown parameter \"%s\", call without parameters to get help\n",
           args[i]);

}     // for( i ...

// try to bind if not bound
  if (!bound) {
    printf("no local address to receive frames on,\n"
           "  using default local address \"0.0.0.0:2323\"\n");
    addr.sin_family = AF_INET;
    addr.sin_port = htons(2323);
    addr.sin_addr.s_addr = htonl(INADDR_ANY);
    if (bind(udpSocket, (struct sockaddr *)&addr, sizeof(addr)) == 0)
      bound = 1;
    else {
      printf("could not set local address to \"0.0.0.0:2323\"\n");
      close(udpSocket);
      return -1;
    }
  }
  // open device and output frames in a loop
  open_and_output_loop(udpSocket, device,
                       serial_settings_change, serial_settings, serial_speed,
                       reopen_device, reopen_device_ms, min_interval_ms,
                       format_change, format_height, format_width,
                       format_channels, format_colors, proto);

// close socket
  close(udpSocket);

return 0;
}

BlinkenLib

restructure directories