OUI

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(move to github)
 
(12 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
==MAC addresses==
 
==MAC addresses==
  
MAC addresses are of the form xx-xx-xx-yy-yy-yy where xx-xx-xx is the OUI and yy-yy-yy is an identifier assigned
+
MAC addresses as used for various link-layers such as Ethernet, WiFi, Bluetooth, are of the form xx-xx-xx-yy-yy-yy where xx-xx-xx is the OUI (00-1F-11) and yy-yy-yy is an identifier assigned by the owner of the OUI.
by the owner of the OUI.
+
  
{|border="1"
+
== Open registry for community / homebrew OUI ranges ==
|-
+
| '''First identifier'''
+
| '''Last identifier'''
+
| '''Date'''
+
| '''Purpose'''
+
|-
+
| 00-00-00
+
| 00-FF-FF
+
| 2008-02-27
+
| Reserved for R&D use
+
|-
+
| 01-00-00
+
| 01-27-FF
+
| 2008-02-27
+
| Factory allocation for GTA02 MP start
+
|-
+
| 01-28-00
+
| 01-55-FF
+
| 2008-07-07
+
| Factory allocation for GTA02 production
+
|-
+
| 01-56-00
+
| 01-79-FF
+
| 2008-08-21
+
| Factory allocation for GTA02 production
+
|}
+
  
==Generating MAC addresses==
+
As the openmoko products have been discontinued, Openmoko Inc. is opening up the use of its IEEE OUI range for use by the Free and Open Source software and hardware communities.  This means you can simply register your devices and will get an allocation of a OUI range for free.
  
We currently assign MAC addresses in groups of three, randomized within each block of assigned addresses.
+
=== Existing Allocations ===
To assign addresses, calculate how large a block you'll need. E.g., for 5000 groups, the block would have
+
to be at least 15'000 or 0x3A98 addresses wide. Since we like round numbers, round up to 0x4000 (unless
+
we know exactly how many we'll use, of course).
+
  
The '''mac''' tool can help with address generation. If we want to allocate the above block starting at
+
The current list of allocations can be found at https://raw.githubusercontent.com/openmoko/openmoko-usb-oui/master/ieee_oui.psv
02-00-00, we could use the following command:
+
  
<PRE>
+
=== Conditions ===
% cd svn.internal.openmoko.org/developer/werner/mac
+
% ./mac 020000 023fff >020000-023FFF
+
</PRE>
+
  
Then check the output from '''mac''' into SVN and enter the registration in this page.
+
By applying for an Openmoko OUI range, you acknowledge that either
 +
* the device you are developing is either an open hardware project with at least publicly available schematics, '''or'''
 +
* the firmware/software running on your Ethernet device is Free / Open Source software, licensed under an OSI-Approved, FSF-Recognized or DFSG-Approved Free / Open Source software license
  
Note that '''mac''' produces a different order of addresses for each invocation.
+
In order to request an OUI range, please send an pull-request to the https://github.com/openmoko/openmoko-usb-oui github project.
  
[[Category:Networking| ]]
+
Please make sure the commitlog message of your pull requests contains
 +
the following details:
 +
* a name and short description of your Ethernet enabled device project
 +
* the license under which you are releasing the hardware and/or software/firmware of the device
 +
* a link to the project website and/or source code repository, if any
 +
* the number of Unique MAC addresses you require, with some explanation why (i.e. intended production quantity, ..)
 +
 
 +
== More information ==
 +
More information is at the IEEE Standards Association.<br/>
 +
[http://standards.ieee.org/regauth/oui/index.shtml IEEE OUI and Company_id Assignments]
 +
 
 +
[[Category:Networking]]
 
[[Category:Hardware]]
 
[[Category:Hardware]]

Latest revision as of 09:14, 9 June 2018

Openmoko has been assigned the OUI (Organizationally Unique Identifier) 00-1F-11. This page lists allocations we have made under this OUI.

Contents

[edit] MAC addresses

MAC addresses as used for various link-layers such as Ethernet, WiFi, Bluetooth, are of the form xx-xx-xx-yy-yy-yy where xx-xx-xx is the OUI (00-1F-11) and yy-yy-yy is an identifier assigned by the owner of the OUI.

[edit] Open registry for community / homebrew OUI ranges

As the openmoko products have been discontinued, Openmoko Inc. is opening up the use of its IEEE OUI range for use by the Free and Open Source software and hardware communities. This means you can simply register your devices and will get an allocation of a OUI range for free.

[edit] Existing Allocations

The current list of allocations can be found at https://raw.githubusercontent.com/openmoko/openmoko-usb-oui/master/ieee_oui.psv

[edit] Conditions

By applying for an Openmoko OUI range, you acknowledge that either

  • the device you are developing is either an open hardware project with at least publicly available schematics, or
  • the firmware/software running on your Ethernet device is Free / Open Source software, licensed under an OSI-Approved, FSF-Recognized or DFSG-Approved Free / Open Source software license

In order to request an OUI range, please send an pull-request to the https://github.com/openmoko/openmoko-usb-oui github project.

Please make sure the commitlog message of your pull requests contains the following details:

  • a name and short description of your Ethernet enabled device project
  • the license under which you are releasing the hardware and/or software/firmware of the device
  • a link to the project website and/or source code repository, if any
  • the number of Unique MAC addresses you require, with some explanation why (i.e. intended production quantity, ..)

[edit] More information

More information is at the IEEE Standards Association.
IEEE OUI and Company_id Assignments

Personal tools

Openmoko has been assigned the OUI (Organizationally Unique Identifier) 00-1F-11. This page lists allocations we have made under this OUI.

MAC addresses

MAC addresses are of the form xx-xx-xx-yy-yy-yy where xx-xx-xx is the OUI and yy-yy-yy is an identifier assigned by the owner of the OUI.

First identifier Last identifier Date Purpose
00-00-00 00-FF-FF 2008-02-27 Reserved for R&D use
01-00-00 01-27-FF 2008-02-27 Factory allocation for GTA02 MP start
01-28-00 01-55-FF 2008-07-07 Factory allocation for GTA02 production
01-56-00 01-79-FF 2008-08-21 Factory allocation for GTA02 production

Generating MAC addresses

We currently assign MAC addresses in groups of three, randomized within each block of assigned addresses. To assign addresses, calculate how large a block you'll need. E.g., for 5000 groups, the block would have to be at least 15'000 or 0x3A98 addresses wide. Since we like round numbers, round up to 0x4000 (unless we know exactly how many we'll use, of course).

The mac tool can help with address generation. If we want to allocate the above block starting at 02-00-00, we could use the following command:

% cd svn.internal.openmoko.org/developer/werner/mac
% ./mac 020000 023fff >020000-023FFF

Then check the output from mac into SVN and enter the registration in this page.

Note that mac produces a different order of addresses for each invocation.