eui64.h

Go to the documentation of this file.

/* Copyright 2013-2014, Peter A. Bigot
 *
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * * Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 *
 * * Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution.
 *
 * * Neither the name of the software nor the names of its contributors may be
 *   used to endorse or promote products derived from this software without
 *   specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef BSP430_UTILITY_EUI64_H
#define BSP430_UTILITY_EUI64_H

#include <bsp430/core.h>

#ifndef configBSP430_EUI64
#define configBSP430_EUI64 0
#endif /* configBSP430_EUI64 */

#if defined(BSP430_DOXYGEN) || defined(configBSP430_EUI64)
#ifndef BSP430_EUI64
#define BSP430_EUI64 (configBSP430_EUI64 - 0)
#endif /* BSP430_EUI64 */
#endif /* BSP430_DOXYGEN */

#ifndef configBSP430_EUI64_USE_PLATFORM
#define configBSP430_EUI64_USE_PLATFORM 1
#endif /*  configBSP430_EUI64_USE_PLATFORM */

#ifndef configBSP430_EUI64_USE_GENERIC
#define configBSP430_EUI64_USE_GENERIC 1
#endif /*  configBSP430_EUI64_USE_GENERIC */

#define BSP430_EUI64_PERM 0

#define BSP430_EUI64_RANDOM 1

#define BSP430_EUI64_STOLEN 2

#define BSP430_EUI64_MASK_GROUP 0x01

#define BSP430_EUI64_MASK_LOCAL 0x02

typedef union uBSP430eui64 {
  uint8_t bytes[8];

  uint64_t u64;

  int16_t ints[4];

  struct as48 {
    uint8_t oui[3];

    uint8_t label[2];

    uint8_t extension_id[3];
  } as48;
} uBSP430eui64;

typedef uBSP430eui64 * hBSP430eui64;

#define BSP430_EUI64_IS_NULL(h_) ((0 == (h_)->ints[0])    \
                                  & (0 == (h_)->ints[1])  \
                                  & (0 == (h_)->ints[2])  \
                                  & (0 == (h_)->ints[3]))

#define BSP430_EUI64_IS_INVALID(h_) ((-1 == (h_)->ints[0])    \
                                     & (-1 == (h_)->ints[1])  \
                                     & (-1 == (h_)->ints[2])  \
                                     & (-1 == (h_)->ints[3]))

#define BSP430_EUI64_INVALIDATE(h_) do { \
    hBSP430eui64 const h = (h_);         \
    h->ints[0] = -1;                     \
    h->ints[1] = -1;                     \
    h->ints[2] = -1;                     \
    h->ints[3] = -1;                     \
  } while (0)

#if defined(BSP430_DOXYGEN) || (BSP430_EUI64 - 0)
int iBSP430eui64 (hBSP430eui64 eui64);
#endif /* BSP430_EUI64 */

int iBSP430eui64Parse (const char * cfp,
                       size_t len,
                       hBSP430eui64 eui64);

#define BSP430_EUI64_AS_TEXT_LENGTH sizeof("01-02-03-04-05-06-07-08")

char * xBSP430eui64AsText (hBSP430eui64 eui64,
                           char * buffer);

#endif /* BSP430_UTILITY_EUI64_H */