Git Product home page Git Product logo

openmoko-usb-oui's Introduction

Open registry for community / homebrew USB Product IDs + OUI

Do not apply before your project is published under a FOSS license!

As the openmoko products have been discontinued, Openmoko Inc. has been opening up the use of its USB Vendor ID and IEEE OUI 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 Product ID for free.

Do not apply before your project is published under a FOSS license!

Conditions

Do not apply before your project is published under a FOSS license!

By applying for an Openmoko Product ID, you acknowledge that either

  • the USB device you are developing is an open hardware project (as per the OSHW Definition), or
  • the firmware/software running on your USB device is Free / Open Source software, licensed under an OSI-Approved, FSF-Recognized or DFSG-Approved Free / Open Source software license

Do not apply before your project is published under a FOSS license!

How to Apply for an USB PID or IEEE OUI sub-range

In order to request a product ID, please send an pull-request to the openmoko-usb-oui github project.

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

  • the string "request" somewhere in the subject
  • a name and short description of your USB 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
  • a terse descriptive string for each ID you want, according to the examples below (field#3 in table). This string will show up in tools like lsusb etc and should avoid to use "USB" to describe what the device is/does, since those tools are implicitly about USB already. (bad: "USB keyboard", less bad: "Joe's USB-RS232 adapter" (established term in one word), BEST: "ACME1 secure mass storage device, type 512")
  • if you (might) need multiple Product IDs, please indicate + explain this at the first message, rather than applying for a second ID later, so we can allocate a contiguous range.

If you do not have a github account, do not wish to use it, or have any other question, you can contact us per email at usb-id AT lists.openmoko.org.

Do not apply before your project is published under a FOSS license!

Checklist for a perfect application

Here are a couple of aspects you should complete before applying for a USB PID or IEEE OUI. This is what we will look for before being able to grand you the ID.

Regarding hardware:

  1. Have a README[.txt|.md] file describing which part is under which license
    • this will help to quickly identify the project's license, particularly when several licenses are combined, or your are using libraries under other licenses. Also make sure the combination is allowed by the individual licenses.
  2. Include all full text licenses in a LICENSE[.txt] file
  3. Include a copyright notice in the schematic sheet(s), including author and date
    • this will determine who the copyright holder is, and when the copyright will expire.
  4. Include the license name in the schematic sheet(s)
    • this becomes important when different license are combined, and parts of the project, or libraries, are under different licenses
  5. Include all schematic symbols and board footprint libraries in the project
    • without that the project can't be seen as complete. Also ensure their license is compatible.
  6. Export the schematic capture as pdf, and board layout as gerber+NC drill [and other fabrication output] files
    • not every user can, or wants, to install the EDA suite you are using. This is even more important if in the future this suite stops supporting the current format. If you don't want to mix the fabrication output with the source files, have a general project page pointing to the source files and fabrication output.

Regarding software, firmware, or gateware:

  1. Have a README[.txt|.md] file describing which part is under which license
    • this will help to quickly identify the project's license, particularly when several licenses are combined, or your are using libraries under other licenses. Also make sure the combination is allowed by the individual licenses.
  2. Include all full text licenses in a LICENSE[.txt] file
  3. Ensure the source files have a copyright notice, including author and date
    • this will determine who the copyright holder is, and when the code will become public domain once the copyright expires
  4. Ensure the source files have a license header. A SPDX-License-Identifier is sufficient.
    • this becomes important when different license are combined, and parts of the project, or libraries, are under different licenses
  5. Don't request a sub-range to include each individual hardware supporting this software. Use one USB PID and include hardware information in the USB description
    • our USB PID range is not infinite, and we would like to be able to continue offering PIDs in the future.

openmoko-usb-oui's People

Contributors

andeutung avatar arksine avatar cuvoodoo avatar ddb0515 avatar ffy00 avatar flummer avatar forty-bot avatar jgressmann avatar jpconstantineau avatar kevinoconnor avatar kkatano avatar laf0rge avatar lukaso25 avatar mossmann avatar nanusefue avatar notro avatar oskirby avatar petejohanson avatar rafaelmartins avatar schodet avatar sdoira avatar sergiogarciacuevasgonzalez avatar shikshik avatar shurik179 avatar skiselev avatar smunaut avatar sol avatar spritetm avatar sugoku avatar tmaxelectronics avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

openmoko-usb-oui's Issues

Vendor names displayed by operating systems

Hey there ๐Ÿ‘‹

I noticed that lsusb under Linux will indiscriminately show OpenMoko, Inc. (instead of say the manufacturer reported by the USB device) if you use 0x1d50 as VID .

Alternatives:

  • If you use the VID from pid.codes then lsusb will show Generic.
  • If you use an unassigned VID then lsusb will show the manufacturer as reported by the USB device.

Behavior of other systems:

  • Other places on Linux seem to show the manufacturer as reported by the USB device.
  • Windows (tested via a VM) seems to only show the product name as reported by the device and omit vendor/manufacture entirely.

Questions:

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.