mirrors
/
micropython
mirror of https://github.com/micropython/micropython.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs/esp8266: Update quickref and tutorial for OneWire/DS18X20 driver.

This commit is contained in:
Damien George 2016-08-29 12:52:50 +10:00
parent 59a9509703
commit 13c5a228c9
2 changed files with 6 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/esp8266/quickref.rst
View File

@ -253,15 +253,14 @@ The OneWire driver is implemented in software and works on all pins::
ow.scan() # return a list of devices on the bus ow.scan() # return a list of devices on the bus
ow.reset() # reset the bus ow.reset() # reset the bus
ow.readbyte() # read a byte ow.readbyte() # read a byte
ow.read(5) # read 5 bytes
ow.writebyte(0x12) # write a byte on the bus ow.writebyte(0x12) # write a byte on the bus
ow.write('123') # write bytes on the bus ow.write('123') # write bytes on the bus
ow.select_rom(b'12345678') # select a specific device by its ROM code ow.select_rom(b'12345678') # select a specific device by its ROM code
There is a specific driver for DS18B20 devices:: There is a specific driver for DS18S20 and DS18B20 devices::
import time import time, ds18x20
ds = onewire.DS18B20(ow) ds = ds18x20.DS18X20(ow)
roms = ds.scan() roms = ds.scan()
ds.convert_temp() ds.convert_temp()
time.sleep_ms(750) time.sleep_ms(750)

6
docs/esp8266/tutorial/onewire.rst
View File

@ -6,19 +6,19 @@ The 1-wire bus is a serial bus that uses just a single wire for communication
is a very popular 1-wire device, and here we show how to use the onewire module is a very popular 1-wire device, and here we show how to use the onewire module
to read from such a device. to read from such a device.
For the following code to work you need to have at least one DS18B20 temperature For the following code to work you need to have at least one DS18S20 or DS18B20 temperature
sensor with its data line connected to GPIO12. You must also power the sensors sensor with its data line connected to GPIO12. You must also power the sensors
and connect a 4.7k Ohm resistor between the data pin and the power pin. :: and connect a 4.7k Ohm resistor between the data pin and the power pin. ::
import time import time
import machine import machine
import onewire import onewire, ds18x20
# the device is on GPIO12 # the device is on GPIO12
dat = machine.Pin(12) dat = machine.Pin(12)
# create the onewire object # create the onewire object
ds = onewire.DS18B20(onewire.OneWire(dat)) ds = ds18x20.DS18X20(onewire.OneWire(dat))
# scan for devices on the bus # scan for devices on the bus
roms = ds.scan() roms = ds.scan()