Mercurialavr / file revision
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | raw | help
ds1307.h
author darius@Inchoate
Mon, 19 Jan 2009 22:54:19 +1030
changeset 71 553c061fda7c
permissions -rw-r--r--
Keep the newer GCC happy. 
     1 /*

     2  * DS1307 headers

     3  *

     4  * Copyright (c) 2008

     5  *      Daniel O'Connor <darius@dons.net.au>.  All rights reserved.

     6  *

     7  * Redistribution and use in source and binary forms, with or without

     8  * modification, are permitted provided that the following conditions

     9  * are met:

    10  * 1. Redistributions of source code must retain the above copyright

    11  *    notice, this list of conditions and the following disclaimer.

    12  * 2. Redistributions in binary form must reproduce the above copyright

    13  *    notice, this list of conditions and the following disclaimer in the

    14  *    documentation and/or other materials provided with the distribution.

    15  *

    16  * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND

    17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

    18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

    19  * ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE

    20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

    21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

    22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

    23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

    24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

    25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

    26  * SUCH DAMAGE.

    27  */

    28 

    29 #define IIC_STFAIL	-1

    30 #define IIC_FAILARB	-2

    31 #define IIC_SLNAK	-3

    32 #define IIC_NOREPLY	-4

    33 #define IIC_UNKNOWN	-99

    34 

    35 #define DS1307_ADR	0xd0	// DS1307's TWI address

    36 

    37 typedef struct {

    38     uint8_t	year;

    39     uint8_t	month;

    40     uint8_t	day;

    41     uint8_t	hour;

    42     uint8_t	min;

    43     uint8_t	sec;

    44 

    45     uint8_t	ctrl;

    46     uint8_t	ram[56];

    47 } ds1307_t;

    48 

    49 typedef union {

    50     uint8_t	raw[8];

    51     struct {

    52 	uint8_t sec	: 4;

    53 	uint8_t	sec10	: 3;	// Seconds (0-59)

    54 	uint8_t	ch	: 1;	// Clock enable (1 = off)

    55 	

    56 	uint8_t min	: 4;

    57 	uint8_t min10	: 3;	// Minutes (0-59)

    58 	uint8_t	pad0	: 1;

    59 	

    60 	uint8_t hour	: 4;

    61 	uint8_t	hour10	: 1;	// Hours

    62 	uint8_t	pmam	: 1;	// AM/PM => 1 = PM or extra bit for hour10

    63 	uint8_t	s1224	: 1;	// 1 = 12 hour mode

    64 	uint8_t pad1	: 1;

    65 

    66 	uint8_t dow	: 3;	// Day of the week (1-7)

    67 	uint8_t	pad2	: 5;	

    68 	

    69 	uint8_t	day	: 4;

    70 	uint8_t day10	: 2;	// Day of the month (1-31)

    71 	uint8_t pad3	: 2;

    72 	

    73 	uint8_t month	: 4;

    74 	uint8_t month10	: 1;

    75 	uint8_t	pad4 	: 3;	// Month (1-12)

    76 	

    77 	uint8_t year	: 4;

    78 	uint8_t	year10	: 4;	// Year (0-99)

    79 	

    80 	uint8_t	rs	: 2;	// Rate select

    81 	uint8_t	pad6	: 2;

    82 	uint8_t sqwe	: 1;	// Square wave enable

    83 	uint8_t pad5	: 2;

    84 	uint8_t	out	: 1;	// Output control enable

    85     } split;

    86 } ds1307raw_t;

    87 	

    88 int	ds1307_init(void);

    89 int	iic_read(uint8_t *data, uint8_t len, uint8_t adr, uint8_t sla);

    90 int	iic_write(uint8_t *data, uint8_t len, uint8_t adr, uint8_t sla);

    91 int	ds1307_gettod(ds1307raw_t *time);

    92 int	ds1307_settod(char *date);

    93 void	ds1307_printtime(char *leader, char *trailer);
avr