nv-oui's Introduction

Utility for OUI

Overview

This library contains a utility class for OUI. OUI is short for Organizationally Unique Identifier. It is a 24-bit number assigned to organizations by IEEE Standards Association, Registration Authority.

License

Apache License, Version 2.0

Maven

<dependency>
    <groupId>com.neovisionaries</groupId>
    <artifactId>nv-oui</artifactId>
    <version>1.1</version>
</dependency>

Gradle

dependencies {
    compile 'com.neovisionaries:nv-oui:1.1'
}

OSGi

Bundle-SymbolicName: com.neovisionaries.oui
Export-Package: com.neovisionaries.oui;version="1.1.0"

Source Code

https://github.com/TakahikoKawasaki/nv-oui

JavaDoc

http://TakahikoKawasaki.github.io/nv-oui/

Usage

// Load an 'oui.csv' file.
Oui oui = new Oui(new OuiCsvParser().parse(new URL("file:data/oui.csv")));

// (1) Look up by a 6-hexadecimal OUI. ("Apple, Inc." is returned.)
String name = oui.getName("00CDFE");

// (2) Case-insensitive. ("Google, Inc.")
oui.getName("3c5ab4");

// (3) Semi-colons can be interleaved. ("Microsoft Corporation")
oui.getName("48:50:73");

// (4) A 48-bit device address is okay. ("Facebook")
oui.getName("48:57:dd:01:02:03");

// (5) Hyphens are okay, too. ("Amazon Technologies Inc.")
oui.getName("F0-D2-F1");

// (6) Only the first 6 hexadecimal letters have a meeting. ("Oracle Corporation")
oui.getName("0010e0#XYZ")

// (7) This is parsed successfully, too. ("Intel Corporation")
oui.getName("00:03-47@XYZ");

// (8) Look up by a byte array. ("IBM Corp")
byte[] data = { 0x00, 0x04, (byte)0xAC };
oui.getName(data);