Changeset View
Changeset View
Standalone View
Standalone View
sys/dev/ow/README.txt
- This file was added.
Quick Design Document for one wire bus | |||||
In new bus terms, One wire devices are attached to one wire busses | |||||
which are attached to a one wire bridge. | |||||
The implementation follows the termonology used in the Maxim AN927 | |||||
Application note which defines the 1-wire bus as implemented for the | |||||
wblock: Typo:
s/termonology/terminology/ | |||||
iButton product. This is considered to be the canonical definition of | |||||
the 1wire bus. This means that the one wire bridge will implement the | |||||
owll interface. ow is one wire. ll is for Link Level to | |||||
mirror the ISO stack terminology used by AN927. The one wire bus is | |||||
implemented in ow device, which implements the own interface (n | |||||
Done Inline ActionsDifferent terms used in this paragraph should be consistent: "one wire", "One wire", "1-wire", "1wire". I think the vendor uses "1-wire", but not sure. wblock: Different terms used in this paragraph should be consistent: "one wire", "One wire", "1-wire"… | |||||
Not Done Inline ActionsMissing a "the": wblock: Missing a "the":
s/in ow/in the ow/ | |||||
for network, the layer described in the AN927). The Transport layer | |||||
Done Inline Actionss/in ow/in the ow/ wblock: s/in ow/in the ow/ | |||||
Not Done Inline ActionsMaybe use own(4) to make this not seem to be the word "own". wblock: Maybe use own(4) to make this not seem to be the word "own". | |||||
and above is the responsibility of the client device drivers to | |||||
implement. While there is some commonality at the Transport layer, too | |||||
Not Done Inline Actions"to implement" is not needed. wblock: "to implement" is not needed.
responsibility of the client device drivers. | |||||
many devices aren't compatible with it because they don't implement | |||||
all the commands. While the presentation layer is common enough for | |||||
Done Inline ActionsStrictly speaking, this is not bound by the guideline to avoid contractions, but it would not hurt. That guideline is meant to make it simpler for non-native English speakers. wblock: Strictly speaking, this is not bound by the guideline to avoid contractions, but it would not… | |||||
Not Done Inline ActionsAs above, own(4) rather than just "own". (It is easy to read this as a type saying "their own". wblock: As above, own(4) rather than just "own". (It is easy to read this as a type saying "their own". | |||||
useful implementaitons, it is currently unimplemented because the | |||||
Not Done Inline Actionss/the own/own/ But other than that, nice! wblock: s/the own/own/
But other than that, nice! | |||||
focus of this work is on temperature sensors and product ID ROMs. | |||||
Done Inline ActionsTypo: wblock: Typo:
s/implementaitons/implementations/ |
Typo:
s/termonology/terminology/