# Universal Hardware Registry?

by donblair | | 21 views | 5 comments | 15 Dec 16:33

Hi all!

[WARNING: this idea is not fully thought through. Would love your thoughts!]

### Motivations

One issue that arises in electronic environmental instrumentation is: calibration. You put a device out in the world, and -- things always fall apart a little. Metal probes corrode, materials degrade, and you end up with a temperature measurement, say, that is off by X degrees.

Actually, this problem starts even earlier: while a lot of factories will do some basic testing to make sure that their devices are "accurate to within +/-1 Y (measurement units)", it's really best practice to check this number yourself before deploying. And further: you can often do a lot better than their stated accuracy, but finding out exactly how off you are, and calibrating.

But okay, so you calibrate your temperature probe, and let's say that you see that, to get better measurements, you should multiply its readings by 1.5. What do you do with that number? Do you program the electronic instrument you're using to report values from that probe (I'M LOOKING AT YOU, ARDUINO/RIFFLE/MICROCONTROLLERS) to multiply every reading by 1.5? This is a possibility, but it means you need to know how to program the electronic instrument / Arduino, and you need to reprogram it every time you recalibrate the (constantly corroding) instrument.

Instead, what I've often heard suggested is: keep track of the calibration information for your temperature probe, have the electronic instrument report its "raw" value, and do all the conversations and compensations when you're doing your data analysis.

This seems sensible, because usually it's easier to transform numbers when you're doing data analysis (you were likely setting up to do that anyway -- it's often on a full-fledged, easily scriptable computer / spreadsheet / online database, etc). But the trouble now is that you need to keep track of the particular temperature probe that you were using, and associate your calibration number to it ...

It gets even more interesting. When you want to get really accurate and precise, you need to worry not just about individual probes, but about entire instruments -- the impact of which probes are hooked up to the instrument, how the instrument is situated in an enclosure, and especially, the effect of temperature on e.g. the instrumentation circuitry (timing crystal "clocks" vary with temperature, so our digitization schemes will start to drift as the temperature changes, changing the values we get) ...

### A Universal Registry?

So what you need is a way to easily store some metadata about your hardware. In the simplest case, it might be: "last time I measured, this temp probe's numbers ought to be measured by 1.5 to get a true reading"

So, at minimum, you need to "name" your temperature probe -- some serial number that will be unique to it -- and you need to be able to associate some data with that name. It won't always be a single number, it might be an equation -- some people like to do more complex corrections to achieve greater accuracy over a wider range.

Additionally, some sensors out there are great within a certain range of parameters -- air sensors vis a vis humidity, say -- but fail outside them, and their numbers should no longer be trusted outside that range. This sort of registry could record that fact.

Then, you'd want to make it easy for folks who are doing data analysis to query this registry and get the "correction factor" back. In general, making this algorithmic, so that your data corrections happen automatically, is not easy. But at least at first version of this registry could offer plain text metadata describing your last calibration procedure. And if someone e.g. is using R or Matlab, it could contain a snippet of code in those languages to make the corrections.

This almost makes me think that a simple software repository structure like Git, or github's gists, could accomplish what's wanted here ...

Anyway, it seems an interesting problem that could be ameliorated by online infrastructure of the sort that has been put together at Public Lab. A universal hardware registry, where every hardware part is given a unique ID. This could be done for cardboard enclosures, too. For webcams that you purchase off the shelf. We won't run out of numbers -- we can make more. We just need to keep track of them.

I also like the idea that any object that we use as part of an instrument gets "named", and has a "history" ... this tends to encourage re-use, and to discourage us of thinking of plastic and metal and paper objects as things that we ought to just throw away. It would be so cool to have e.g. a barcode on such objects and be able to look up some of the uses it has been put to. If someone took the time, it could even have some information about the "embedded energy / materials" in the object, in some units that made sense "This object required 10 Liters of water to make ..."

What do y'all think? @tonyc @mathew is there already some system like this, designed for recycled hardware, say, in existence?

pl_codex noes ur hardware

Hi, Don - hmm, i wonder if it could relate to this idea for a "contributors.json" file attached to each hardware project -- at least in format?

https://publiclab.org/notes/warren/02-24-2015/standardizing-open-source-hardware-publication-practices-with-contributors-json

Is this a question? Click here to post it to the Questions page.

some sensors, like 1-wire sensors, have a unique hex code already to allow them to be networked. You could record a registry of those easily and associated metadata.

Given that temperature is basic functionality, the inclusion of a one-wire temp sensor on a board like the riffle could then be used as a unique device ID.

here's an idea for a registry that builds on existing infrastructure:

1) make a wiki page for a piece of hardware with some details about said hardware. maybe even a series of standard fields that some software might want to look for. Tag the shortlink with 'HWregistry' and a parent:project tag so it is a part of a project specific hardware 'registry' linked at the top of the object page.

2) use the wiki page 'shortlink' as a unique ID, write shortlink on the device as its ID.

3)??? machine read wiki pages if needed? standardized label templates? labels that ship with stuff?

Is this a question? Click here to post it to the Questions page.

+1 wiki system; if you need a machine readable thing, we can make something like that using tags, so just invent whatever new tagging standards you want.

Love the wiki idea! Also love the .json idea. Sounds as though, as long as we come up with a tagging / formatting convention, we could do the wiki thing, and generate .json if interested in export?

E.g. we could just say: for each "field", use a wiki header, like "#"? and then we can nested structures, using subheadings? So that exporting the wiki as json would be standardized? And perhaps tags would end up going into a "keywords" field upon export?

Is this a question? Click here to post it to the Questions page.

Go for it, although we'll probably adapt this as we go; I think probably auto-converting from markdown to json is a bit hairy, but if you put it up as a wiki, that's a good starting place. Say, you could put it in a block like:

{
field: value,
field2: value2
}