annotate 1wire-config.h @ 1:be930b34fcd3

Make it compile, no testing yet.
author Daniel O'Connor <darius@dons.net.au>
date Mon, 26 Jan 2015 23:04:09 +1030
parents 93d4ddff7dd0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
1 /*
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
2 * Example configuration header for 1-wire bus code.
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
3 *
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
4 * This is the user servicable stuff - how to do delays and how to
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
5 * frob the IO pins.
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
6 *
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
7 * Copyright (c) 2009
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
8 * Daniel O'Connor <darius@dons.net.au>. All rights reserved.
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
9 *
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
10 * Redistribution and use in source and binary forms, with or without
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
11 * modification, are permitted provided that the following conditions
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
12 * are met:
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
13 * 1. Redistributions of source code must retain the above copyright
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
14 * notice, this list of conditions and the following disclaimer.
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
15 * 2. Redistributions in binary form must reproduce the above copyright
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
16 * notice, this list of conditions and the following disclaimer in the
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
17 * documentation and/or other materials provided with the distribution.
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
18 *
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
19 * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
22 * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
29 * SUCH DAMAGE.
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
30 */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
31
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
32 /*
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
33 * Alter these for your configuration
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
34 *
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
35 * The configuration described here has the 1-wire read on D3,
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
36 * a pulldown transistor on D4 and VPP controlled by D5.
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
37 */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
38
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
39 #include <avr/io.h>
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
40 #include <avr/pgmspace.h>
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
41 #include <util/delay.h>
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
42 #include "cons.h"
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
43
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
44 /* Initialise the DDR pins if necessary */
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
45 #define OWBUSINIT() do { \
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
46 DDRD |= _BV(4); \
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
47 DDRD &= ~_BV(3); \
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
48 } while (0)
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
49
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
50 /* Set the port up to allow reading from the 1 wire bus */
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
51 #define OWSETREAD() \
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
52 do { \
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
53 } while (0)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
54
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
55
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
56 /* Read the 1-wire bus, non-inverting logic */
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
57 #define OWREADBUS() (PIND & _BV(3) ? 1 : 0)
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
58
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
59 /* Set the 1-wire bus to 0
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
60 * Turns a transistor on to pull it low
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
61 */
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
62 #define OWSETBUSLOW() PORTD |= _BV(4)
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
63
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
64 /* Set the 1-wire bus to 1
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
65 * Turn the transistor off to let the pullup do its job
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
66 */
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
67 #define OWSETBUSHIGH() PORTD &= ~_BV(4)
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
68
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
69 /* Turn Vpp on (ie put +12V on the bus
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
70 * This is optional, if it is undefined OWProgROM always fails */
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
71 #define OWSETVPPON() PORTD |= _BV(5)
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
72 #define OWSETVPPOFF() PORTD &= ~_BV(5)
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
73
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
74 /* _delay_us can only do a delay of 768/clock_freq */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
75 #if F_CPU > 16000000
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
76 #error F_CPU > 16MHz, delays need adjusting
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
77 #endif
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
78
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
79 #define OWDELAY_A _delay_us(6) /* 6 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
80 #define OWDELAY_B do { _delay_us(48); _delay_us(16); } while (0) /* 64 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
81 #define OWDELAY_C do { _delay_us(48); _delay_us(12); } while (0) /* 60 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
82 #define OWDELAY_D _delay_us(10) /* 10 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
83 #define OWDELAY_E _delay_us(9) /* 9 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
84 #define OWDELAY_F do { _delay_us(55); } while (0) /* 55 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
85 #define OWDELAY_G /* 0 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
86 #define OWDELAY_H do { _delay_us(48); _delay_us(48); _delay_us(48); \
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
87 _delay_us(48); _delay_us(48); _delay_us(48); _delay_us(48); \
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
88 _delay_us(48);_delay_us(48); _delay_us(48); } while (0) /* 480 usec */
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
89 #define OWDELAY_I do { _delay_us(48); _delay_us(22); } while (0) /* 70 usec */
1
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
90 #define OWDELAY_J do { _delay_us(41); _delay_us(41); _delay_us(41); \
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
91 _delay_us(41); _delay_us(41); _delay_us(41); _delay_us(41); \
be930b34fcd3 Make it compile, no testing yet.
Daniel O'Connor <darius@dons.net.au>
parents: 0
diff changeset
92 _delay_us(41);_delay_us(41); _delay_us(41); } while (0) /* 410 usec */
0
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
93
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
94 #ifdef OW_DEBUG
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
95 #define OWPUTS(x) puts_P(x)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
96 #define OWPUTSP(x) puts_P(x)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
97 #define OWPRINTFP(fmt, ...) printf_P(fmt, ## __VA_ARGS__)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
98 #else
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
99 #define OWPUTS(x)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
100 #define OWPUTSP(x)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
101 #define OWPRINTFP(fmt, ...)
93d4ddff7dd0 Jumbo commit since I appear to have forgotten to do this before..
Daniel O'Connor <darius@dons.net.au>
parents:
diff changeset
102 #endif