/trunk/Clock/Clock.ino |
---|
0,0 → 1,510 |
/**************************************************************************//** |
* \brief Arduino clock. |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120428 |
* |
* This program is free software: you can redistribute it and/or modify |
* it under the terms of the GNU General Public License as published by |
* the Free Software Foundation, either version 3 of the License, or |
* (at your option) any later version. |
* |
* This program is distributed in the hope that it will be useful, |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
* GNU General Public License for more details. |
* |
* You should have received a copy of the GNU General Public License |
* along with this program. If not, see http://www.gnu.org/licenses. |
******************************************************************************/ |
/**************************************************************************//** |
* \file clock.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include "Keyboard.h" |
#include <Deuligne.h> |
#include <RTClib.h> |
#include <Arduino.h> |
#include <Wire.h> |
#include <stdio.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
#define CLOCK__DAY_MIN 1 |
#define CLOCK__DAY_MAX 31 |
#define CLOCK__MONTH_MIN 1 |
#define CLOCK__MONTH_MAX 12 |
#define CLOCK__YEAR_MIN 2000 |
#define CLOCK__YEAR_MAX 2099 |
#define CLOCK__HOUR_MIN 0 |
#define CLOCK__HOUR_MAX 23 |
#define CLOCK__MINUTE_MIN 0 |
#define CLOCK__MINUTE_MAX 59 |
#define CLOCK__SECOND_MIN 0 |
#define CLOCK__SECOND_MAX 59 |
/****************************************************************************** |
* Private type definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \enum clock__members |
* \brief |
* |
* \type clock__member_t |
* \brief |
******************************************************************************/ |
typedef enum clock__members |
{ |
clock__MemberDay, |
clock__MemberMonth, |
clock__MemberYear, |
clock__MemberHour, |
clock__MemberMinute, |
clock__MemberSecond |
} clock__member_t; |
/****************************************************************************** |
* Private function prototypes. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn static void clock__handleKey(Keyboard::Key_t key) |
* |
* \brief Handle pressed key. |
* |
* \param key Pressed key. |
******************************************************************************/ |
static |
void |
clock__handleKey |
( |
Keyboard::Key_t key |
); |
/**************************************************************************//** |
* \fn static void clock__setCursor() |
* |
* \brief Set cursor position. |
******************************************************************************/ |
static |
void |
clock__setCursor(); |
/**************************************************************************//** |
* \fn static clock__incrementMember() |
* |
* \brief Increment current member: day, month, year, hour, minute or second. |
******************************************************************************/ |
static |
void |
clock__incrementMember(); |
/**************************************************************************//** |
* \fn static void clock__decrementMember() |
* |
* \brief Decrement current member: day, month, year, hour, minute or second. |
******************************************************************************/ |
static |
void |
clock__decrementMember(); |
/**************************************************************************//** |
* \fn static void clock__printDatetime() |
* |
* \brief Print current datetime. |
******************************************************************************/ |
static |
void |
clock__printDatetime(); |
/****************************************************************************** |
* Private variable declarations. |
******************************************************************************/ |
static Deuligne clock__lcd; |
static RTC_DS1307 clock__rtc; |
static DateTime clock__currentTime; |
static bool clock__adjustMode = false; |
static clock__member_t clock__currentMember = clock__MemberDay; |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief System initialization. |
******************************************************************************/ |
void setup() |
{ |
// Initialize TWI bus. |
Wire.begin(); |
// Initialize RTC. |
clock__rtc.begin(); |
// Initialize LCD. |
clock__lcd.init(); |
clock__lcd.clear(); |
clock__lcd.backLight(true); |
// Get current time and print it. |
clock__currentTime = clock__rtc.now(); |
clock__printDatetime(); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief Infinite loop. |
******************************************************************************/ |
void loop() |
{ |
// Get pressed key and process it. |
Keyboard::Key_t key = (Keyboard::Key_t)(clock__lcd.get_key()); |
if (key > Keyboard::KeyNone) |
{ |
clock__handleKey(key); |
} |
// If we aren't in adjust mode, get current time and print it. |
if (!clock__adjustMode) |
{ |
clock__currentTime = clock__rtc.now(); |
clock__printDatetime(); |
} |
delay(200); |
} |
/****************************************************************************** |
* Private function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn static void clock__handleKey(Keyboard::Key_t key) |
* |
* \brief Handle pressed key. |
* |
* \param key Pressed key. |
******************************************************************************/ |
static |
void |
clock__handleKey |
( |
Keyboard::Key_t key |
){ |
switch (key) |
{ |
case Keyboard::KeyRight: |
{ |
if (clock__adjustMode) |
{ |
if (clock__currentMember < clock__MemberSecond) |
{ |
byte tmpMember = (byte)clock__currentMember; |
tmpMember++; |
clock__currentMember = (clock__member_t)tmpMember; |
} |
else |
{ |
clock__currentMember = clock__MemberDay; |
} |
clock__setCursor(); |
} |
} |
break; |
case Keyboard::KeyUp: |
{ |
if (clock__adjustMode) |
{ |
clock__incrementMember(); |
clock__setCursor(); |
} |
} |
break; |
case Keyboard::KeyDown: |
{ |
if (clock__adjustMode) |
{ |
clock__decrementMember(); |
clock__setCursor(); |
} |
} |
break; |
case Keyboard::KeyLeft: |
{ |
if (clock__adjustMode) |
{ |
if (clock__currentMember > clock__MemberDay) |
{ |
byte tmpMember = (byte)clock__currentMember; |
tmpMember--; |
clock__currentMember = (clock__member_t)tmpMember; |
} |
else |
{ |
clock__currentMember = clock__MemberSecond; |
} |
clock__setCursor(); |
} |
} |
break; |
case Keyboard::KeySelect: |
{ |
if (clock__adjustMode) |
{ |
// If we are in adjust mode, update RTC time. |
clock__rtc.adjust(clock__currentTime); |
clock__lcd.noBlink(); |
clock__lcd.noCursor(); |
clock__currentMember = clock__MemberDay; |
clock__adjustMode = false; |
} |
else |
{ |
// Enter adjust mode. |
clock__adjustMode = true; |
clock__lcd.setCursor(1, 0); |
clock__lcd.blink(); |
clock__lcd.cursor(); |
} |
} |
break; |
case Keyboard::KeyNone: |
case Keyboard::KeyInvalid: |
default: |
break; |
} |
} |
/**************************************************************************//** |
* \fn static void clock__setCursor() |
* |
* \brief Set cursor position. |
******************************************************************************/ |
static |
void |
clock__setCursor() |
{ |
switch (clock__currentMember) |
{ |
case clock__MemberDay: |
clock__lcd.setCursor(1, 0); |
break; |
case clock__MemberMonth: |
clock__lcd.setCursor(4, 0); |
break; |
case clock__MemberYear: |
clock__lcd.setCursor(9, 0); |
break; |
case clock__MemberHour: |
clock__lcd.setCursor(1, 1); |
break; |
case clock__MemberMinute: |
clock__lcd.setCursor(4, 1); |
break; |
case clock__MemberSecond: |
clock__lcd.setCursor(7, 1); |
break; |
default: |
break; |
} |
} |
/**************************************************************************//** |
* \fn static void clock__incrementMember() |
* |
* \brief Increment current member: day, month, year, hour, minute or second. |
******************************************************************************/ |
static |
void |
clock__incrementMember() |
{ |
switch (clock__currentMember) |
{ |
case clock__MemberDay: |
{ |
byte day = clock__currentTime.day(); |
day = (day + 1 <= CLOCK__DAY_MAX) ? (day + 1) : CLOCK__DAY_MIN; |
clock__currentTime.setDay(day); |
} |
break; |
case clock__MemberMonth: |
{ |
byte month = clock__currentTime.month(); |
month = (month + 1 <= CLOCK__MONTH_MAX) ? (month + 1) : CLOCK__MONTH_MIN; |
clock__currentTime.setMonth(month); |
} |
break; |
case clock__MemberYear: |
{ |
word year = clock__currentTime.year(); |
year = (year + 1 <= CLOCK__YEAR_MAX) ? (year + 1) : CLOCK__YEAR_MIN; |
clock__currentTime.setYear(year); |
} |
break; |
case clock__MemberHour: |
{ |
byte hour = clock__currentTime.hour(); |
hour = (hour + 1 <= CLOCK__HOUR_MAX) ? (hour + 1) : CLOCK__HOUR_MIN; |
clock__currentTime.setHour(hour); |
} |
break; |
case clock__MemberMinute: |
{ |
byte minute = clock__currentTime.minute(); |
minute = (minute + 1 <= CLOCK__MINUTE_MAX) ? (minute + 1) : CLOCK__MINUTE_MIN; |
clock__currentTime.setMinute(minute); |
} |
break; |
case clock__MemberSecond: |
{ |
byte second = clock__currentTime.second(); |
second = (second + 1 <= CLOCK__SECOND_MAX) ? (second + 1) : CLOCK__SECOND_MIN; |
clock__currentTime.setSecond(second); |
} |
break; |
default: |
break; |
} |
clock__printDatetime(); |
} |
/**************************************************************************//** |
* \fn static void clock__decrementMember() |
* |
* \brief Decrement current member: day, month, year, hour, minute or second. |
******************************************************************************/ |
static |
void |
clock__decrementMember() |
{ |
switch (clock__currentMember) |
{ |
case clock__MemberDay: |
{ |
byte day = clock__currentTime.day(); |
day = (day - 1 >= CLOCK__DAY_MIN) ? (day - 1) : CLOCK__DAY_MAX; |
clock__currentTime.setDay(day); |
} |
break; |
case clock__MemberMonth: |
{ |
byte month = clock__currentTime.month(); |
month = (month - 1 >= CLOCK__MONTH_MIN) ? (month - 1) : CLOCK__MONTH_MAX; |
clock__currentTime.setMonth(month); |
} |
break; |
case clock__MemberYear: |
{ |
word year = clock__currentTime.year(); |
year = (year - 1 >= CLOCK__YEAR_MIN) ? (year - 1) : CLOCK__YEAR_MAX; |
clock__currentTime.setYear(year); |
} |
break; |
case clock__MemberHour: |
{ |
byte hour = clock__currentTime.hour(); |
hour = (hour - 1 >= CLOCK__HOUR_MIN) ? (hour - 1) : CLOCK__HOUR_MIN; |
clock__currentTime.setHour(hour); |
} |
break; |
case clock__MemberMinute: |
{ |
byte minute = clock__currentTime.minute(); |
minute = (minute - 1 >= CLOCK__MINUTE_MIN) ? (minute - 1) : CLOCK__MINUTE_MAX; |
clock__currentTime.setMinute(minute); |
} |
break; |
case clock__MemberSecond: |
{ |
byte second = clock__currentTime.second(); |
second = (second - 1 >= CLOCK__SECOND_MIN) ? (second - 1) : CLOCK__SECOND_MAX; |
clock__currentTime.setSecond(second); |
} |
break; |
default: |
break; |
} |
clock__printDatetime(); |
} |
/**************************************************************************//** |
* \fn static void clock__printDatetime() |
* |
* \brief Print current datetime. |
******************************************************************************/ |
static |
void |
clock__printDatetime() |
{ |
// Build date string. |
char date[] = "01/01/2000"; |
snprintf |
( |
date, |
strlen(date) + 1, |
"%02d/%02d/%04d", |
clock__currentTime.day(), |
clock__currentTime.month(), |
clock__currentTime.year() |
); |
// Build time string. |
char time[] = "00:00:00"; |
snprintf |
( |
time, |
strlen(time) + 1, |
"%02d:%02d:%02d", |
clock__currentTime.hour(), |
clock__currentTime.minute(), |
clock__currentTime.second() |
); |
// Print date. |
clock__lcd.setCursor(0, 0); |
clock__lcd.print(date); |
// Print time. |
clock__lcd.setCursor(0, 1); |
clock__lcd.print(time); |
} |
/trunk/Clock/Keyboard.h |
---|
0,0 → 1,20 |
#ifndef H__IDREAMMICRO__KEYBOARD__H |
#define H__IDREAMMICRO__KEYBOARD__H |
class Keyboard |
{ |
public: |
typedef enum Keys |
{ |
KeyNone = -1, |
KeyRight, |
KeyUp, |
KeyDown, |
KeyLeft, |
KeySelect, |
KeyInvalid |
} Key_t; |
}; |
#endif // H__IDREAMMICRO__KEYBOARD__H |
/trunk/Clock/gpl-3.0.txt |
---|
0,0 → 1,674 |
GNU GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
Preamble |
The GNU General Public License is a free, copyleft license for |
software and other kinds of works. |
The licenses for most software and other practical works are designed |
to take away your freedom to share and change the works. By contrast, |
the GNU General Public License is intended to guarantee your freedom to |
share and change all versions of a program--to make sure it remains free |
software for all its users. We, the Free Software Foundation, use the |
GNU General Public License for most of our software; it applies also to |
any other work released this way by its authors. You can apply it to |
your programs, too. |
When we speak of free software, we are referring to freedom, not |
price. Our General Public Licenses are designed to make sure that you |
have the freedom to distribute copies of free software (and charge for |
them if you wish), that you receive source code or can get it if you |
want it, that you can change the software or use pieces of it in new |
free programs, and that you know you can do these things. |
To protect your rights, we need to prevent others from denying you |
these rights or asking you to surrender the rights. Therefore, you have |
certain responsibilities if you distribute copies of the software, or if |
you modify it: responsibilities to respect the freedom of others. |
For example, if you distribute copies of such a program, whether |
gratis or for a fee, you must pass on to the recipients the same |
freedoms that you received. You must make sure that they, too, receive |
or can get the source code. And you must show them these terms so they |
know their rights. |
Developers that use the GNU GPL protect your rights with two steps: |
(1) assert copyright on the software, and (2) offer you this License |
giving you legal permission to copy, distribute and/or modify it. |
For the developers' and authors' protection, the GPL clearly explains |
that there is no warranty for this free software. For both users' and |
authors' sake, the GPL requires that modified versions be marked as |
changed, so that their problems will not be attributed erroneously to |
authors of previous versions. |
Some devices are designed to deny users access to install or run |
modified versions of the software inside them, although the manufacturer |
can do so. This is fundamentally incompatible with the aim of |
protecting users' freedom to change the software. The systematic |
pattern of such abuse occurs in the area of products for individuals to |
use, which is precisely where it is most unacceptable. Therefore, we |
have designed this version of the GPL to prohibit the practice for those |
products. If such problems arise substantially in other domains, we |
stand ready to extend this provision to those domains in future versions |
of the GPL, as needed to protect the freedom of users. |
Finally, every program is threatened constantly by software patents. |
States should not allow patents to restrict development and use of |
software on general-purpose computers, but in those that do, we wish to |
avoid the special danger that patents applied to a free program could |
make it effectively proprietary. To prevent this, the GPL assures that |
patents cannot be used to render the program non-free. |
The precise terms and conditions for copying, distribution and |
modification follow. |
TERMS AND CONDITIONS |
0. Definitions. |
"This License" refers to version 3 of the GNU General Public License. |
"Copyright" also means copyright-like laws that apply to other kinds of |
works, such as semiconductor masks. |
"The Program" refers to any copyrightable work licensed under this |
License. Each licensee is addressed as "you". "Licensees" and |
"recipients" may be individuals or organizations. |
To "modify" a work means to copy from or adapt all or part of the work |
in a fashion requiring copyright permission, other than the making of an |
exact copy. The resulting work is called a "modified version" of the |
earlier work or a work "based on" the earlier work. |
A "covered work" means either the unmodified Program or a work based |
on the Program. |
To "propagate" a work means to do anything with it that, without |
permission, would make you directly or secondarily liable for |
infringement under applicable copyright law, except executing it on a |
computer or modifying a private copy. Propagation includes copying, |
distribution (with or without modification), making available to the |
public, and in some countries other activities as well. |
To "convey" a work means any kind of propagation that enables other |
parties to make or receive copies. Mere interaction with a user through |
a computer network, with no transfer of a copy, is not conveying. |
An interactive user interface displays "Appropriate Legal Notices" |
to the extent that it includes a convenient and prominently visible |
feature that (1) displays an appropriate copyright notice, and (2) |
tells the user that there is no warranty for the work (except to the |
extent that warranties are provided), that licensees may convey the |
work under this License, and how to view a copy of this License. If |
the interface presents a list of user commands or options, such as a |
menu, a prominent item in the list meets this criterion. |
1. Source Code. |
The "source code" for a work means the preferred form of the work |
for making modifications to it. "Object code" means any non-source |
form of a work. |
A "Standard Interface" means an interface that either is an official |
standard defined by a recognized standards body, or, in the case of |
interfaces specified for a particular programming language, one that |
is widely used among developers working in that language. |
The "System Libraries" of an executable work include anything, other |
than the work as a whole, that (a) is included in the normal form of |
packaging a Major Component, but which is not part of that Major |
Component, and (b) serves only to enable use of the work with that |
Major Component, or to implement a Standard Interface for which an |
implementation is available to the public in source code form. A |
"Major Component", in this context, means a major essential component |
(kernel, window system, and so on) of the specific operating system |
(if any) on which the executable work runs, or a compiler used to |
produce the work, or an object code interpreter used to run it. |
The "Corresponding Source" for a work in object code form means all |
the source code needed to generate, install, and (for an executable |
work) run the object code and to modify the work, including scripts to |
control those activities. However, it does not include the work's |
System Libraries, or general-purpose tools or generally available free |
programs which are used unmodified in performing those activities but |
which are not part of the work. For example, Corresponding Source |
includes interface definition files associated with source files for |
the work, and the source code for shared libraries and dynamically |
linked subprograms that the work is specifically designed to require, |
such as by intimate data communication or control flow between those |
subprograms and other parts of the work. |
The Corresponding Source need not include anything that users |
can regenerate automatically from other parts of the Corresponding |
Source. |
The Corresponding Source for a work in source code form is that |
same work. |
2. Basic Permissions. |
All rights granted under this License are granted for the term of |
copyright on the Program, and are irrevocable provided the stated |
conditions are met. This License explicitly affirms your unlimited |
permission to run the unmodified Program. The output from running a |
covered work is covered by this License only if the output, given its |
content, constitutes a covered work. This License acknowledges your |
rights of fair use or other equivalent, as provided by copyright law. |
You may make, run and propagate covered works that you do not |
convey, without conditions so long as your license otherwise remains |
in force. You may convey covered works to others for the sole purpose |
of having them make modifications exclusively for you, or provide you |
with facilities for running those works, provided that you comply with |
the terms of this License in conveying all material for which you do |
not control copyright. Those thus making or running the covered works |
for you must do so exclusively on your behalf, under your direction |
and control, on terms that prohibit them from making any copies of |
your copyrighted material outside their relationship with you. |
Conveying under any other circumstances is permitted solely under |
the conditions stated below. Sublicensing is not allowed; section 10 |
makes it unnecessary. |
3. Protecting Users' Legal Rights From Anti-Circumvention Law. |
No covered work shall be deemed part of an effective technological |
measure under any applicable law fulfilling obligations under article |
11 of the WIPO copyright treaty adopted on 20 December 1996, or |
similar laws prohibiting or restricting circumvention of such |
measures. |
When you convey a covered work, you waive any legal power to forbid |
circumvention of technological measures to the extent such circumvention |
is effected by exercising rights under this License with respect to |
the covered work, and you disclaim any intention to limit operation or |
modification of the work as a means of enforcing, against the work's |
users, your or third parties' legal rights to forbid circumvention of |
technological measures. |
4. Conveying Verbatim Copies. |
You may convey verbatim copies of the Program's source code as you |
receive it, in any medium, provided that you conspicuously and |
appropriately publish on each copy an appropriate copyright notice; |
keep intact all notices stating that this License and any |
non-permissive terms added in accord with section 7 apply to the code; |
keep intact all notices of the absence of any warranty; and give all |
recipients a copy of this License along with the Program. |
You may charge any price or no price for each copy that you convey, |
and you may offer support or warranty protection for a fee. |
5. Conveying Modified Source Versions. |
You may convey a work based on the Program, or the modifications to |
produce it from the Program, in the form of source code under the |
terms of section 4, provided that you also meet all of these conditions: |
a) The work must carry prominent notices stating that you modified |
it, and giving a relevant date. |
b) The work must carry prominent notices stating that it is |
released under this License and any conditions added under section |
7. This requirement modifies the requirement in section 4 to |
"keep intact all notices". |
c) You must license the entire work, as a whole, under this |
License to anyone who comes into possession of a copy. This |
License will therefore apply, along with any applicable section 7 |
additional terms, to the whole of the work, and all its parts, |
regardless of how they are packaged. This License gives no |
permission to license the work in any other way, but it does not |
invalidate such permission if you have separately received it. |
d) If the work has interactive user interfaces, each must display |
Appropriate Legal Notices; however, if the Program has interactive |
interfaces that do not display Appropriate Legal Notices, your |
work need not make them do so. |
A compilation of a covered work with other separate and independent |
works, which are not by their nature extensions of the covered work, |
and which are not combined with it such as to form a larger program, |
in or on a volume of a storage or distribution medium, is called an |
"aggregate" if the compilation and its resulting copyright are not |
used to limit the access or legal rights of the compilation's users |
beyond what the individual works permit. Inclusion of a covered work |
in an aggregate does not cause this License to apply to the other |
parts of the aggregate. |
6. Conveying Non-Source Forms. |
You may convey a covered work in object code form under the terms |
of sections 4 and 5, provided that you also convey the |
machine-readable Corresponding Source under the terms of this License, |
in one of these ways: |
a) Convey the object code in, or embodied in, a physical product |
(including a physical distribution medium), accompanied by the |
Corresponding Source fixed on a durable physical medium |
customarily used for software interchange. |
b) Convey the object code in, or embodied in, a physical product |
(including a physical distribution medium), accompanied by a |
written offer, valid for at least three years and valid for as |
long as you offer spare parts or customer support for that product |
model, to give anyone who possesses the object code either (1) a |
copy of the Corresponding Source for all the software in the |
product that is covered by this License, on a durable physical |
medium customarily used for software interchange, for a price no |
more than your reasonable cost of physically performing this |
conveying of source, or (2) access to copy the |
Corresponding Source from a network server at no charge. |
c) Convey individual copies of the object code with a copy of the |
written offer to provide the Corresponding Source. This |
alternative is allowed only occasionally and noncommercially, and |
only if you received the object code with such an offer, in accord |
with subsection 6b. |
d) Convey the object code by offering access from a designated |
place (gratis or for a charge), and offer equivalent access to the |
Corresponding Source in the same way through the same place at no |
further charge. You need not require recipients to copy the |
Corresponding Source along with the object code. If the place to |
copy the object code is a network server, the Corresponding Source |
may be on a different server (operated by you or a third party) |
that supports equivalent copying facilities, provided you maintain |
clear directions next to the object code saying where to find the |
Corresponding Source. Regardless of what server hosts the |
Corresponding Source, you remain obligated to ensure that it is |
available for as long as needed to satisfy these requirements. |
e) Convey the object code using peer-to-peer transmission, provided |
you inform other peers where the object code and Corresponding |
Source of the work are being offered to the general public at no |
charge under subsection 6d. |
A separable portion of the object code, whose source code is excluded |
from the Corresponding Source as a System Library, need not be |
included in conveying the object code work. |
A "User Product" is either (1) a "consumer product", which means any |
tangible personal property which is normally used for personal, family, |
or household purposes, or (2) anything designed or sold for incorporation |
into a dwelling. In determining whether a product is a consumer product, |
doubtful cases shall be resolved in favor of coverage. For a particular |
product received by a particular user, "normally used" refers to a |
typical or common use of that class of product, regardless of the status |
of the particular user or of the way in which the particular user |
actually uses, or expects or is expected to use, the product. A product |
is a consumer product regardless of whether the product has substantial |
commercial, industrial or non-consumer uses, unless such uses represent |
the only significant mode of use of the product. |
"Installation Information" for a User Product means any methods, |
procedures, authorization keys, or other information required to install |
and execute modified versions of a covered work in that User Product from |
a modified version of its Corresponding Source. The information must |
suffice to ensure that the continued functioning of the modified object |
code is in no case prevented or interfered with solely because |
modification has been made. |
If you convey an object code work under this section in, or with, or |
specifically for use in, a User Product, and the conveying occurs as |
part of a transaction in which the right of possession and use of the |
User Product is transferred to the recipient in perpetuity or for a |
fixed term (regardless of how the transaction is characterized), the |
Corresponding Source conveyed under this section must be accompanied |
by the Installation Information. But this requirement does not apply |
if neither you nor any third party retains the ability to install |
modified object code on the User Product (for example, the work has |
been installed in ROM). |
The requirement to provide Installation Information does not include a |
requirement to continue to provide support service, warranty, or updates |
for a work that has been modified or installed by the recipient, or for |
the User Product in which it has been modified or installed. Access to a |
network may be denied when the modification itself materially and |
adversely affects the operation of the network or violates the rules and |
protocols for communication across the network. |
Corresponding Source conveyed, and Installation Information provided, |
in accord with this section must be in a format that is publicly |
documented (and with an implementation available to the public in |
source code form), and must require no special password or key for |
unpacking, reading or copying. |
7. Additional Terms. |
"Additional permissions" are terms that supplement the terms of this |
License by making exceptions from one or more of its conditions. |
Additional permissions that are applicable to the entire Program shall |
be treated as though they were included in this License, to the extent |
that they are valid under applicable law. If additional permissions |
apply only to part of the Program, that part may be used separately |
under those permissions, but the entire Program remains governed by |
this License without regard to the additional permissions. |
When you convey a copy of a covered work, you may at your option |
remove any additional permissions from that copy, or from any part of |
it. (Additional permissions may be written to require their own |
removal in certain cases when you modify the work.) You may place |
additional permissions on material, added by you to a covered work, |
for which you have or can give appropriate copyright permission. |
Notwithstanding any other provision of this License, for material you |
add to a covered work, you may (if authorized by the copyright holders of |
that material) supplement the terms of this License with terms: |
a) Disclaiming warranty or limiting liability differently from the |
terms of sections 15 and 16 of this License; or |
b) Requiring preservation of specified reasonable legal notices or |
author attributions in that material or in the Appropriate Legal |
Notices displayed by works containing it; or |
c) Prohibiting misrepresentation of the origin of that material, or |
requiring that modified versions of such material be marked in |
reasonable ways as different from the original version; or |
d) Limiting the use for publicity purposes of names of licensors or |
authors of the material; or |
e) Declining to grant rights under trademark law for use of some |
trade names, trademarks, or service marks; or |
f) Requiring indemnification of licensors and authors of that |
material by anyone who conveys the material (or modified versions of |
it) with contractual assumptions of liability to the recipient, for |
any liability that these contractual assumptions directly impose on |
those licensors and authors. |
All other non-permissive additional terms are considered "further |
restrictions" within the meaning of section 10. If the Program as you |
received it, or any part of it, contains a notice stating that it is |
governed by this License along with a term that is a further |
restriction, you may remove that term. If a license document contains |
a further restriction but permits relicensing or conveying under this |
License, you may add to a covered work material governed by the terms |
of that license document, provided that the further restriction does |
not survive such relicensing or conveying. |
If you add terms to a covered work in accord with this section, you |
must place, in the relevant source files, a statement of the |
additional terms that apply to those files, or a notice indicating |
where to find the applicable terms. |
Additional terms, permissive or non-permissive, may be stated in the |
form of a separately written license, or stated as exceptions; |
the above requirements apply either way. |
8. Termination. |
You may not propagate or modify a covered work except as expressly |
provided under this License. Any attempt otherwise to propagate or |
modify it is void, and will automatically terminate your rights under |
this License (including any patent licenses granted under the third |
paragraph of section 11). |
However, if you cease all violation of this License, then your |
license from a particular copyright holder is reinstated (a) |
provisionally, unless and until the copyright holder explicitly and |
finally terminates your license, and (b) permanently, if the copyright |
holder fails to notify you of the violation by some reasonable means |
prior to 60 days after the cessation. |
Moreover, your license from a particular copyright holder is |
reinstated permanently if the copyright holder notifies you of the |
violation by some reasonable means, this is the first time you have |
received notice of violation of this License (for any work) from that |
copyright holder, and you cure the violation prior to 30 days after |
your receipt of the notice. |
Termination of your rights under this section does not terminate the |
licenses of parties who have received copies or rights from you under |
this License. If your rights have been terminated and not permanently |
reinstated, you do not qualify to receive new licenses for the same |
material under section 10. |
9. Acceptance Not Required for Having Copies. |
You are not required to accept this License in order to receive or |
run a copy of the Program. Ancillary propagation of a covered work |
occurring solely as a consequence of using peer-to-peer transmission |
to receive a copy likewise does not require acceptance. However, |
nothing other than this License grants you permission to propagate or |
modify any covered work. These actions infringe copyright if you do |
not accept this License. Therefore, by modifying or propagating a |
covered work, you indicate your acceptance of this License to do so. |
10. Automatic Licensing of Downstream Recipients. |
Each time you convey a covered work, the recipient automatically |
receives a license from the original licensors, to run, modify and |
propagate that work, subject to this License. You are not responsible |
for enforcing compliance by third parties with this License. |
An "entity transaction" is a transaction transferring control of an |
organization, or substantially all assets of one, or subdividing an |
organization, or merging organizations. If propagation of a covered |
work results from an entity transaction, each party to that |
transaction who receives a copy of the work also receives whatever |
licenses to the work the party's predecessor in interest had or could |
give under the previous paragraph, plus a right to possession of the |
Corresponding Source of the work from the predecessor in interest, if |
the predecessor has it or can get it with reasonable efforts. |
You may not impose any further restrictions on the exercise of the |
rights granted or affirmed under this License. For example, you may |
not impose a license fee, royalty, or other charge for exercise of |
rights granted under this License, and you may not initiate litigation |
(including a cross-claim or counterclaim in a lawsuit) alleging that |
any patent claim is infringed by making, using, selling, offering for |
sale, or importing the Program or any portion of it. |
11. Patents. |
A "contributor" is a copyright holder who authorizes use under this |
License of the Program or a work on which the Program is based. The |
work thus licensed is called the contributor's "contributor version". |
A contributor's "essential patent claims" are all patent claims |
owned or controlled by the contributor, whether already acquired or |
hereafter acquired, that would be infringed by some manner, permitted |
by this License, of making, using, or selling its contributor version, |
but do not include claims that would be infringed only as a |
consequence of further modification of the contributor version. For |
purposes of this definition, "control" includes the right to grant |
patent sublicenses in a manner consistent with the requirements of |
this License. |
Each contributor grants you a non-exclusive, worldwide, royalty-free |
patent license under the contributor's essential patent claims, to |
make, use, sell, offer for sale, import and otherwise run, modify and |
propagate the contents of its contributor version. |
In the following three paragraphs, a "patent license" is any express |
agreement or commitment, however denominated, not to enforce a patent |
(such as an express permission to practice a patent or covenant not to |
sue for patent infringement). To "grant" such a patent license to a |
party means to make such an agreement or commitment not to enforce a |
patent against the party. |
If you convey a covered work, knowingly relying on a patent license, |
and the Corresponding Source of the work is not available for anyone |
to copy, free of charge and under the terms of this License, through a |
publicly available network server or other readily accessible means, |
then you must either (1) cause the Corresponding Source to be so |
available, or (2) arrange to deprive yourself of the benefit of the |
patent license for this particular work, or (3) arrange, in a manner |
consistent with the requirements of this License, to extend the patent |
license to downstream recipients. "Knowingly relying" means you have |
actual knowledge that, but for the patent license, your conveying the |
covered work in a country, or your recipient's use of the covered work |
in a country, would infringe one or more identifiable patents in that |
country that you have reason to believe are valid. |
If, pursuant to or in connection with a single transaction or |
arrangement, you convey, or propagate by procuring conveyance of, a |
covered work, and grant a patent license to some of the parties |
receiving the covered work authorizing them to use, propagate, modify |
or convey a specific copy of the covered work, then the patent license |
you grant is automatically extended to all recipients of the covered |
work and works based on it. |
A patent license is "discriminatory" if it does not include within |
the scope of its coverage, prohibits the exercise of, or is |
conditioned on the non-exercise of one or more of the rights that are |
specifically granted under this License. You may not convey a covered |
work if you are a party to an arrangement with a third party that is |
in the business of distributing software, under which you make payment |
to the third party based on the extent of your activity of conveying |
the work, and under which the third party grants, to any of the |
parties who would receive the covered work from you, a discriminatory |
patent license (a) in connection with copies of the covered work |
conveyed by you (or copies made from those copies), or (b) primarily |
for and in connection with specific products or compilations that |
contain the covered work, unless you entered into that arrangement, |
or that patent license was granted, prior to 28 March 2007. |
Nothing in this License shall be construed as excluding or limiting |
any implied license or other defenses to infringement that may |
otherwise be available to you under applicable patent law. |
12. No Surrender of Others' Freedom. |
If conditions are imposed on you (whether by court order, agreement or |
otherwise) that contradict the conditions of this License, they do not |
excuse you from the conditions of this License. If you cannot convey a |
covered work so as to satisfy simultaneously your obligations under this |
License and any other pertinent obligations, then as a consequence you may |
not convey it at all. For example, if you agree to terms that obligate you |
to collect a royalty for further conveying from those to whom you convey |
the Program, the only way you could satisfy both those terms and this |
License would be to refrain entirely from conveying the Program. |
13. Use with the GNU Affero General Public License. |
Notwithstanding any other provision of this License, you have |
permission to link or combine any covered work with a work licensed |
under version 3 of the GNU Affero General Public License into a single |
combined work, and to convey the resulting work. The terms of this |
License will continue to apply to the part which is the covered work, |
but the special requirements of the GNU Affero General Public License, |
section 13, concerning interaction through a network will apply to the |
combination as such. |
14. Revised Versions of this License. |
The Free Software Foundation may publish revised and/or new versions of |
the GNU General Public License from time to time. Such new versions will |
be similar in spirit to the present version, but may differ in detail to |
address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Program specifies that a certain numbered version of the GNU General |
Public License "or any later version" applies to it, you have the |
option of following the terms and conditions either of that numbered |
version or of any later version published by the Free Software |
Foundation. If the Program does not specify a version number of the |
GNU General Public License, you may choose any version ever published |
by the Free Software Foundation. |
If the Program specifies that a proxy can decide which future |
versions of the GNU General Public License can be used, that proxy's |
public statement of acceptance of a version permanently authorizes you |
to choose that version for the Program. |
Later license versions may give you additional or different |
permissions. However, no additional obligations are imposed on any |
author or copyright holder as a result of your choosing to follow a |
later version. |
15. Disclaimer of Warranty. |
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY |
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT |
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY |
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, |
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM |
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF |
ALL NECESSARY SERVICING, REPAIR OR CORRECTION. |
16. Limitation of Liability. |
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING |
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS |
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY |
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE |
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF |
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD |
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), |
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF |
SUCH DAMAGES. |
17. Interpretation of Sections 15 and 16. |
If the disclaimer of warranty and limitation of liability provided |
above cannot be given local legal effect according to their terms, |
reviewing courts shall apply local law that most closely approximates |
an absolute waiver of all civil liability in connection with the |
Program, unless a warranty or assumption of liability accompanies a |
copy of the Program in return for a fee. |
END OF TERMS AND CONDITIONS |
How to Apply These Terms to Your New Programs |
If you develop a new program, and you want it to be of the greatest |
possible use to the public, the best way to achieve this is to make it |
free software which everyone can redistribute and change under these terms. |
To do so, attach the following notices to the program. It is safest |
to attach them to the start of each source file to most effectively |
state the exclusion of warranty; and each file should have at least |
the "copyright" line and a pointer to where the full notice is found. |
<one line to give the program's name and a brief idea of what it does.> |
Copyright (C) <year> <name of author> |
This program is free software: you can redistribute it and/or modify |
it under the terms of the GNU General Public License as published by |
the Free Software Foundation, either version 3 of the License, or |
(at your option) any later version. |
This program is distributed in the hope that it will be useful, |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
GNU General Public License for more details. |
You should have received a copy of the GNU General Public License |
along with this program. If not, see <http://www.gnu.org/licenses/>. |
Also add information on how to contact you by electronic and paper mail. |
If the program does terminal interaction, make it output a short |
notice like this when it starts in an interactive mode: |
<program> Copyright (C) <year> <name of author> |
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. |
This is free software, and you are welcome to redistribute it |
under certain conditions; type `show c' for details. |
The hypothetical commands `show w' and `show c' should show the appropriate |
parts of the General Public License. Of course, your program's commands |
might be different; for a GUI interface, you would use an "about box". |
You should also get your employer (if you work as a programmer) or school, |
if any, to sign a "copyright disclaimer" for the program, if necessary. |
For more information on this, and how to apply and follow the GNU GPL, see |
<http://www.gnu.org/licenses/>. |
The GNU General Public License does not permit incorporating your program |
into proprietary programs. If your program is a subroutine library, you |
may consider it more useful to permit linking proprietary applications with |
the library. If this is what you want to do, use the GNU Lesser General |
Public License instead of this License. But first, please read |
<http://www.gnu.org/philosophy/why-not-lgpl.html>. |
/trunk/libraries/AdafruitRTClib/RTClib.h |
---|
0,0 → 1,54 |
// Code by JeeLabs http://news.jeelabs.org/code/ |
// Released to the public domain! Enjoy! |
// Simple general-purpose date/time class (no TZ / DST / leap second handling!) |
class DateTime { |
public: |
DateTime (uint32_t t =0); |
DateTime (uint16_t year, uint8_t month, uint8_t day, |
uint8_t hour =0, uint8_t min =0, uint8_t sec =0); |
DateTime (const char* date, const char* time); |
uint16_t year() const { return 2000 + yOff; } |
uint8_t month() const { return m; } |
uint8_t day() const { return d; } |
uint8_t hour() const { return hh; } |
uint8_t minute() const { return mm; } |
uint8_t second() const { return ss; } |
uint8_t dayOfWeek() const; |
void setYear(uint16_t year) { yOff = year - 2000; } |
void setMonth(uint8_t month) { m = month; } |
void setDay(uint8_t day) { d = day; } |
void setHour(uint8_t hour) { hh = hour; } |
void setMinute(uint8_t minute) { mm = minute; } |
void setSecond(uint8_t second) { ss = second; } |
// 32-bit times as seconds since 1/1/2000 |
long secondstime() const; |
// 32-bit times as seconds since 1/1/1970 |
uint32_t unixtime(void) const; |
protected: |
uint8_t yOff, m, d, hh, mm, ss; |
}; |
// RTC based on the DS1307 chip connected via I2C and the Wire library |
class RTC_DS1307 { |
public: |
static uint8_t begin(void); |
static void adjust(const DateTime& dt); |
uint8_t isrunning(void); |
static DateTime now(); |
}; |
// RTC using the internal millis() clock, has to be initialized before use |
// NOTE: this clock won't be correct once the millis() timer rolls over (>49d?) |
class RTC_Millis { |
public: |
static void begin(const DateTime& dt) { adjust(dt); } |
static void adjust(const DateTime& dt); |
static DateTime now(); |
protected: |
static long offset; |
}; |
/trunk/libraries/AdafruitRTClib/RTClib.cpp |
---|
0,0 → 1,240 |
// Code by JeeLabs http://news.jeelabs.org/code/ |
// Released to the public domain! Enjoy! |
#include <Wire.h> |
#include <avr/pgmspace.h> |
#include "RTClib.h" |
#define DS1307_ADDRESS 0x68 |
#define SECONDS_PER_DAY 86400L |
#define SECONDS_FROM_1970_TO_2000 946684800 |
#if (ARDUINO >= 100) |
#include <Arduino.h> // capital A so it is error prone on case-sensitive filesystems |
#else |
#include <WProgram.h> |
#endif |
int i = 0; //The new wire library needs to take an int when you are sending for the zero register |
//////////////////////////////////////////////////////////////////////////////// |
// utility code, some of this could be exposed in the DateTime API if needed |
const uint8_t daysInMonth [] PROGMEM = { 31,28,31,30,31,30,31,31,30,31,30,31 }; //has to be const or compiler compaints |
// number of days since 2000/01/01, valid for 2001..2099 |
static uint16_t date2days(uint16_t y, uint8_t m, uint8_t d) { |
if (y >= 2000) |
y -= 2000; |
uint16_t days = d; |
for (uint8_t i = 1; i < m; ++i) |
days += pgm_read_byte(daysInMonth + i - 1); |
if (m > 2 && y % 4 == 0) |
++days; |
return days + 365 * y + (y + 3) / 4 - 1; |
} |
static long time2long(uint16_t days, uint8_t h, uint8_t m, uint8_t s) { |
return ((days * 24L + h) * 60 + m) * 60 + s; |
} |
//////////////////////////////////////////////////////////////////////////////// |
// DateTime implementation - ignores time zones and DST changes |
// NOTE: also ignores leap seconds, see http://en.wikipedia.org/wiki/Leap_second |
DateTime::DateTime (uint32_t t) { |
t -= SECONDS_FROM_1970_TO_2000; // bring to 2000 timestamp from 1970 |
ss = t % 60; |
t /= 60; |
mm = t % 60; |
t /= 60; |
hh = t % 24; |
uint16_t days = t / 24; |
uint8_t leap; |
for (yOff = 0; ; ++yOff) { |
leap = yOff % 4 == 0; |
if (days < 365 + leap) |
break; |
days -= 365 + leap; |
} |
for (m = 1; ; ++m) { |
uint8_t daysPerMonth = pgm_read_byte(daysInMonth + m - 1); |
if (leap && m == 2) |
++daysPerMonth; |
if (days < daysPerMonth) |
break; |
days -= daysPerMonth; |
} |
d = days + 1; |
} |
DateTime::DateTime (uint16_t year, uint8_t month, uint8_t day, uint8_t hour, uint8_t min, uint8_t sec) { |
if (year >= 2000) |
year -= 2000; |
yOff = year; |
m = month; |
d = day; |
hh = hour; |
mm = min; |
ss = sec; |
} |
static uint8_t conv2d(const char* p) { |
uint8_t v = 0; |
if ('0' <= *p && *p <= '9') |
v = *p - '0'; |
return 10 * v + *++p - '0'; |
} |
// A convenient constructor for using "the compiler's time": |
// DateTime now (__DATE__, __TIME__); |
// NOTE: using PSTR would further reduce the RAM footprint |
DateTime::DateTime (const char* date, const char* time) { |
// sample input: date = "Dec 26 2009", time = "12:34:56" |
yOff = conv2d(date + 9); |
// Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec |
switch (date[0]) { |
case 'J': m = date[1] == 'a' ? 1 : m = date[2] == 'n' ? 6 : 7; break; |
case 'F': m = 2; break; |
case 'A': m = date[2] == 'r' ? 4 : 8; break; |
case 'M': m = date[2] == 'r' ? 3 : 5; break; |
case 'S': m = 9; break; |
case 'O': m = 10; break; |
case 'N': m = 11; break; |
case 'D': m = 12; break; |
} |
d = conv2d(date + 4); |
hh = conv2d(time); |
mm = conv2d(time + 3); |
ss = conv2d(time + 6); |
} |
uint8_t DateTime::dayOfWeek() const { |
uint16_t day = date2days(yOff, m, d); |
return (day + 6) % 7; // Jan 1, 2000 is a Saturday, i.e. returns 6 |
} |
uint32_t DateTime::unixtime(void) const { |
uint32_t t; |
uint16_t days = date2days(yOff, m, d); |
t = time2long(days, hh, mm, ss); |
t += SECONDS_FROM_1970_TO_2000; // seconds from 1970 to 2000 |
return t; |
} |
//////////////////////////////////////////////////////////////////////////////// |
// RTC_DS1307 implementation |
static uint8_t bcd2bin (uint8_t val) { return val - 6 * (val >> 4); } |
static uint8_t bin2bcd (uint8_t val) { return val + 6 * (val / 10); } |
uint8_t RTC_DS1307::begin(void) { |
return 1; |
} |
#if (ARDUINO >= 100) |
uint8_t RTC_DS1307::isrunning(void) { |
Wire.beginTransmission(DS1307_ADDRESS); |
Wire.write(i); |
Wire.endTransmission(); |
Wire.requestFrom(DS1307_ADDRESS, 1); |
uint8_t ss = Wire.read(); |
return !(ss>>7); |
} |
void RTC_DS1307::adjust(const DateTime& dt) { |
Wire.beginTransmission(DS1307_ADDRESS); |
Wire.write(i); |
Wire.write(bin2bcd(dt.second())); |
Wire.write(bin2bcd(dt.minute())); |
Wire.write(bin2bcd(dt.hour())); |
Wire.write(bin2bcd(0)); |
Wire.write(bin2bcd(dt.day())); |
Wire.write(bin2bcd(dt.month())); |
Wire.write(bin2bcd(dt.year() - 2000)); |
Wire.write(i); |
Wire.endTransmission(); |
} |
DateTime RTC_DS1307::now() { |
Wire.beginTransmission(DS1307_ADDRESS); |
Wire.write(i); |
Wire.endTransmission(); |
Wire.requestFrom(DS1307_ADDRESS, 7); |
uint8_t ss = bcd2bin(Wire.read() & 0x7F); |
uint8_t mm = bcd2bin(Wire.read()); |
uint8_t hh = bcd2bin(Wire.read()); |
Wire.read(); |
uint8_t d = bcd2bin(Wire.read()); |
uint8_t m = bcd2bin(Wire.read()); |
uint16_t y = bcd2bin(Wire.read()) + 2000; |
return DateTime (y, m, d, hh, mm, ss); |
} |
#else |
uint8_t RTC_DS1307::isrunning(void) { |
Wire.beginTransmission(DS1307_ADDRESS); |
Wire.send(i); |
Wire.endTransmission(); |
Wire.requestFrom(DS1307_ADDRESS, 1); |
uint8_t ss = Wire.receive(); |
return !(ss>>7); |
} |
void RTC_DS1307::adjust(const DateTime& dt) { |
Wire.beginTransmission(DS1307_ADDRESS); |
Wire.send(i); |
Wire.send(bin2bcd(dt.second())); |
Wire.send(bin2bcd(dt.minute())); |
Wire.send(bin2bcd(dt.hour())); |
Wire.send(bin2bcd(0)); |
Wire.send(bin2bcd(dt.day())); |
Wire.send(bin2bcd(dt.month())); |
Wire.send(bin2bcd(dt.year() - 2000)); |
Wire.send(i); |
Wire.endTransmission(); |
} |
DateTime RTC_DS1307::now() { |
Wire.beginTransmission(DS1307_ADDRESS); |
Wire.send(i); |
Wire.endTransmission(); |
Wire.requestFrom(DS1307_ADDRESS, 7); |
uint8_t ss = bcd2bin(Wire.receive() & 0x7F); |
uint8_t mm = bcd2bin(Wire.receive()); |
uint8_t hh = bcd2bin(Wire.receive()); |
Wire.receive(); |
uint8_t d = bcd2bin(Wire.receive()); |
uint8_t m = bcd2bin(Wire.receive()); |
uint16_t y = bcd2bin(Wire.receive()) + 2000; |
return DateTime (y, m, d, hh, mm, ss); |
} |
#endif |
//////////////////////////////////////////////////////////////////////////////// |
// RTC_Millis implementation |
long RTC_Millis::offset = 0; |
void RTC_Millis::adjust(const DateTime& dt) { |
offset = dt.unixtime() - millis() / 1000; |
} |
DateTime RTC_Millis::now() { |
return (uint32_t)(offset + millis() / 1000); |
} |
//////////////////////////////////////////////////////////////////////////////// |
/trunk/libraries/AdafruitRTClib/keywords.txt |
---|
0,0 → 1,34 |
####################################### |
# Syntax Coloring Map For RTC |
####################################### |
####################################### |
# Datatypes (KEYWORD1) |
####################################### |
DateTime KEYWORD1 |
RTC_DS1307 KEYWORD1 |
RTC_Millis KEYWORD1 |
####################################### |
# Methods and Functions (KEYWORD2) |
####################################### |
year KEYWORD2 |
month KEYWORD2 |
day KEYWORD2 |
hour KEYWORD2 |
minute KEYWORD2 |
second KEYWORD2 |
dayOfWeek KEYWORD2 |
secondstime KEYWORD2 |
unixtime KEYWORD2 |
begin KEYWORD2 |
adjust KEYWORD2 |
isrunning KEYWORD2 |
now KEYWORD2 |
####################################### |
# Constants (LITERAL1) |
####################################### |
/trunk/libraries/AdafruitRTClib/examples/datecalc/datecalc.pde |
---|
0,0 → 1,65 |
// Simple date conversions and calculations |
#include <Wire.h> |
#include "RTClib.h" |
void showDate(const char* txt, const DateTime& dt) { |
Serial.print(txt); |
Serial.print(' '); |
Serial.print(dt.year(), DEC); |
Serial.print('/'); |
Serial.print(dt.month(), DEC); |
Serial.print('/'); |
Serial.print(dt.day(), DEC); |
Serial.print(' '); |
Serial.print(dt.hour(), DEC); |
Serial.print(':'); |
Serial.print(dt.minute(), DEC); |
Serial.print(':'); |
Serial.print(dt.second(), DEC); |
Serial.print(" = "); |
Serial.print(dt.unixtime()); |
Serial.print("s / "); |
Serial.print(dt.unixtime() / 86400L); |
Serial.print("d since 1970"); |
Serial.println(); |
} |
void setup () { |
Serial.begin(57600); |
DateTime dt0 (0, 1, 1, 0, 0, 0); |
showDate("dt0", dt0); |
DateTime dt1 (1, 1, 1, 0, 0, 0); |
showDate("dt1", dt1); |
DateTime dt2 (2009, 1, 1, 0, 0, 0); |
showDate("dt2", dt2); |
DateTime dt3 (2009, 1, 2, 0, 0, 0); |
showDate("dt3", dt3); |
DateTime dt4 (2009, 1, 27, 0, 0, 0); |
showDate("dt4", dt4); |
DateTime dt5 (2009, 2, 27, 0, 0, 0); |
showDate("dt5", dt5); |
DateTime dt6 (2009, 12, 27, 0, 0, 0); |
showDate("dt6", dt6); |
DateTime dt7 (dt6.unixtime() + 3600); // one hour later |
showDate("dt7", dt7); |
DateTime dt8 (dt6.unixtime() + 86400L); // one day later |
showDate("dt8", dt8); |
DateTime dt9 (dt6.unixtime() + 7 * 86400L); // one week later |
showDate("dt9", dt9); |
} |
void loop () { |
} |
/trunk/libraries/AdafruitRTClib/examples/ds1307/ds1307.pde |
---|
0,0 → 1,61 |
// Date and time functions using a DS1307 RTC connected via I2C and Wire lib |
#include <Wire.h> |
#include "RTClib.h" |
RTC_DS1307 RTC; |
void setup () { |
Serial.begin(57600); |
Wire.begin(); |
RTC.begin(); |
if (! RTC.isrunning()) { |
Serial.println("RTC is NOT running!"); |
// following line sets the RTC to the date & time this sketch was compiled |
RTC.adjust(DateTime(__DATE__, __TIME__)); |
} |
} |
void loop () { |
DateTime now = RTC.now(); |
Serial.print(now.year(), DEC); |
Serial.print('/'); |
Serial.print(now.month(), DEC); |
Serial.print('/'); |
Serial.print(now.day(), DEC); |
Serial.print(' '); |
Serial.print(now.hour(), DEC); |
Serial.print(':'); |
Serial.print(now.minute(), DEC); |
Serial.print(':'); |
Serial.print(now.second(), DEC); |
Serial.println(); |
Serial.print(" since midnight 1/1/1970 = "); |
Serial.print(now.unixtime()); |
Serial.print("s = "); |
Serial.print(now.unixtime() / 86400L); |
Serial.println("d"); |
// calculate a date which is 7 days and 30 seconds into the future |
DateTime future (now.unixtime() + 7 * 86400L + 30); |
Serial.print(" now + 7d + 30s: "); |
Serial.print(future.year(), DEC); |
Serial.print('/'); |
Serial.print(future.month(), DEC); |
Serial.print('/'); |
Serial.print(future.day(), DEC); |
Serial.print(' '); |
Serial.print(future.hour(), DEC); |
Serial.print(':'); |
Serial.print(future.minute(), DEC); |
Serial.print(':'); |
Serial.print(future.second(), DEC); |
Serial.println(); |
Serial.println(); |
delay(3000); |
} |
/trunk/libraries/AdafruitRTClib/examples/softrtc/softrtc.pde |
---|
0,0 → 1,52 |
// Date and time functions using just software, based on millis() & timer |
#include <Wire.h> |
#include "RTClib.h" |
RTC_Millis RTC; |
void setup () { |
Serial.begin(57600); |
// following line sets the RTC to the date & time this sketch was compiled |
RTC.begin(DateTime(__DATE__, __TIME__)); |
} |
void loop () { |
DateTime now = RTC.now(); |
Serial.print(now.year(), DEC); |
Serial.print('/'); |
Serial.print(now.month(), DEC); |
Serial.print('/'); |
Serial.print(now.day(), DEC); |
Serial.print(' '); |
Serial.print(now.hour(), DEC); |
Serial.print(':'); |
Serial.print(now.minute(), DEC); |
Serial.print(':'); |
Serial.print(now.second(), DEC); |
Serial.println(); |
Serial.print(" seconds since 1970: "); |
Serial.println(now.unixtime()); |
// calculate a date which is 7 days and 30 seconds into the future |
DateTime future (now.unixtime() + 7 * 86400L + 30); |
Serial.print(" now + 7d + 30s: "); |
Serial.print(future.year(), DEC); |
Serial.print('/'); |
Serial.print(future.month(), DEC); |
Serial.print('/'); |
Serial.print(future.day(), DEC); |
Serial.print(' '); |
Serial.print(future.hour(), DEC); |
Serial.print(':'); |
Serial.print(future.minute(), DEC); |
Serial.print(':'); |
Serial.print(future.second(), DEC); |
Serial.println(); |
Serial.println(); |
delay(3000); |
} |
/trunk/libraries/OneWire/keywords.txt |
---|
0,0 → 1,38 |
####################################### |
# Syntax Coloring Map For OneWire |
####################################### |
####################################### |
# Datatypes (KEYWORD1) |
####################################### |
OneWire KEYWORD1 |
####################################### |
# Methods and Functions (KEYWORD2) |
####################################### |
reset KEYWORD2 |
write_bit KEYWORD2 |
read_bit KEYWORD2 |
write KEYWORD2 |
write_bytes KEYWORD2 |
read KEYWORD2 |
read_bytes KEYWORD2 |
select KEYWORD2 |
skip KEYWORD2 |
depower KEYWORD2 |
reset_search KEYWORD2 |
search KEYWORD2 |
crc8 KEYWORD2 |
crc16 KEYWORD2 |
check_crc16 KEYWORD2 |
####################################### |
# Instances (KEYWORD2) |
####################################### |
####################################### |
# Constants (LITERAL1) |
####################################### |
/trunk/libraries/OneWire/OneWire.cpp |
---|
0,0 → 1,527 |
/* |
Copyright (c) 2007, Jim Studt (original old version - many contributors since) |
The latest version of this library may be found at: |
http://www.pjrc.com/teensy/td_libs_OneWire.html |
Version 2.1: |
Arduino 1.0 compatibility, Paul Stoffregen |
Improve temperature example, Paul Stoffregen |
DS250x_PROM example, Guillermo Lovato |
PIC32 (chipKit) compatibility, Jason Dangel, dangel.jason AT gmail.com |
Improvements from Glenn Trewitt: |
- crc16() now works |
- check_crc16() does all of calculation/checking work. |
- Added read_bytes() and write_bytes(), to reduce tedious loops. |
- Added ds2408 example. |
Delete very old, out-of-date readme file (info is here) |
Version 2.0: Modifications by Paul Stoffregen, January 2010: |
http://www.pjrc.com/teensy/td_libs_OneWire.html |
Search fix from Robin James |
http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1238032295/27#27 |
Use direct optimized I/O in all cases |
Disable interrupts during timing critical sections |
(this solves many random communication errors) |
Disable interrupts during read-modify-write I/O |
Reduce RAM consumption by eliminating unnecessary |
variables and trimming many to 8 bits |
Optimize both crc8 - table version moved to flash |
Modified to work with larger numbers of devices - avoids loop. |
Tested in Arduino 11 alpha with 12 sensors. |
26 Sept 2008 -- Robin James |
http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1238032295/27#27 |
Updated to work with arduino-0008 and to include skip() as of |
2007/07/06. --RJL20 |
Modified to calculate the 8-bit CRC directly, avoiding the need for |
the 256-byte lookup table to be loaded in RAM. Tested in arduino-0010 |
-- Tom Pollard, Jan 23, 2008 |
Jim Studt's original library was modified by Josh Larios. |
Tom Pollard, pollard@alum.mit.edu, contributed around May 20, 2008 |
Permission is hereby granted, free of charge, to any person obtaining |
a copy of this software and associated documentation files (the |
"Software"), to deal in the Software without restriction, including |
without limitation the rights to use, copy, modify, merge, publish, |
distribute, sublicense, and/or sell copies of the Software, and to |
permit persons to whom the Software is furnished to do so, subject to |
the following conditions: |
The above copyright notice and this permission notice shall be |
included in all copies or substantial portions of the Software. |
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE |
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION |
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
Much of the code was inspired by Derek Yerger's code, though I don't |
think much of that remains. In any event that was.. |
(copyleft) 2006 by Derek Yerger - Free to distribute freely. |
The CRC code was excerpted and inspired by the Dallas Semiconductor |
sample code bearing this copyright. |
//--------------------------------------------------------------------------- |
// Copyright (C) 2000 Dallas Semiconductor Corporation, All Rights Reserved. |
// |
// Permission is hereby granted, free of charge, to any person obtaining a |
// copy of this software and associated documentation files (the "Software"), |
// to deal in the Software without restriction, including without limitation |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// and/or sell copies of the Software, and to permit persons to whom the |
// Software is furnished to do so, subject to the following conditions: |
// |
// The above copyright notice and this permission notice shall be included |
// in all copies or substantial portions of the Software. |
// |
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
// IN NO EVENT SHALL DALLAS SEMICONDUCTOR BE LIABLE FOR ANY CLAIM, DAMAGES |
// OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
// OTHER DEALINGS IN THE SOFTWARE. |
// |
// Except as contained in this notice, the name of Dallas Semiconductor |
// shall not be used except as stated in the Dallas Semiconductor |
// Branding Policy. |
//-------------------------------------------------------------------------- |
*/ |
#include "OneWire.h" |
OneWire::OneWire(uint8_t pin) |
{ |
pinMode(pin, INPUT); |
bitmask = PIN_TO_BITMASK(pin); |
baseReg = PIN_TO_BASEREG(pin); |
#if ONEWIRE_SEARCH |
reset_search(); |
#endif |
} |
// Perform the onewire reset function. We will wait up to 250uS for |
// the bus to come high, if it doesn't then it is broken or shorted |
// and we return a 0; |
// |
// Returns 1 if a device asserted a presence pulse, 0 otherwise. |
// |
uint8_t OneWire::reset(void) |
{ |
IO_REG_TYPE mask = bitmask; |
volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg; |
uint8_t r; |
uint8_t retries = 125; |
noInterrupts(); |
DIRECT_MODE_INPUT(reg, mask); |
interrupts(); |
// wait until the wire is high... just in case |
do { |
if (--retries == 0) return 0; |
delayMicroseconds(2); |
} while ( !DIRECT_READ(reg, mask)); |
noInterrupts(); |
DIRECT_WRITE_LOW(reg, mask); |
DIRECT_MODE_OUTPUT(reg, mask); // drive output low |
interrupts(); |
delayMicroseconds(500); |
noInterrupts(); |
DIRECT_MODE_INPUT(reg, mask); // allow it to float |
delayMicroseconds(80); |
r = !DIRECT_READ(reg, mask); |
interrupts(); |
delayMicroseconds(420); |
return r; |
} |
// |
// Write a bit. Port and bit is used to cut lookup time and provide |
// more certain timing. |
// |
void OneWire::write_bit(uint8_t v) |
{ |
IO_REG_TYPE mask=bitmask; |
volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg; |
if (v & 1) { |
noInterrupts(); |
DIRECT_WRITE_LOW(reg, mask); |
DIRECT_MODE_OUTPUT(reg, mask); // drive output low |
delayMicroseconds(10); |
DIRECT_WRITE_HIGH(reg, mask); // drive output high |
interrupts(); |
delayMicroseconds(55); |
} else { |
noInterrupts(); |
DIRECT_WRITE_LOW(reg, mask); |
DIRECT_MODE_OUTPUT(reg, mask); // drive output low |
delayMicroseconds(65); |
DIRECT_WRITE_HIGH(reg, mask); // drive output high |
interrupts(); |
delayMicroseconds(5); |
} |
} |
// |
// Read a bit. Port and bit is used to cut lookup time and provide |
// more certain timing. |
// |
uint8_t OneWire::read_bit(void) |
{ |
IO_REG_TYPE mask=bitmask; |
volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg; |
uint8_t r; |
noInterrupts(); |
DIRECT_MODE_OUTPUT(reg, mask); |
DIRECT_WRITE_LOW(reg, mask); |
delayMicroseconds(3); |
DIRECT_MODE_INPUT(reg, mask); // let pin float, pull up will raise |
delayMicroseconds(10); |
r = DIRECT_READ(reg, mask); |
interrupts(); |
delayMicroseconds(53); |
return r; |
} |
// |
// Write a byte. The writing code uses the active drivers to raise the |
// pin high, if you need power after the write (e.g. DS18S20 in |
// parasite power mode) then set 'power' to 1, otherwise the pin will |
// go tri-state at the end of the write to avoid heating in a short or |
// other mishap. |
// |
void OneWire::write(uint8_t v, uint8_t power /* = 0 */) { |
uint8_t bitMask; |
for (bitMask = 0x01; bitMask; bitMask <<= 1) { |
OneWire::write_bit( (bitMask & v)?1:0); |
} |
if ( !power) { |
noInterrupts(); |
DIRECT_MODE_INPUT(baseReg, bitmask); |
DIRECT_WRITE_LOW(baseReg, bitmask); |
interrupts(); |
} |
} |
void OneWire::write_bytes(const uint8_t *buf, uint16_t count, bool power /* = 0 */) { |
for (uint16_t i = 0 ; i < count ; i++) |
write(buf[i]); |
if (!power) { |
noInterrupts(); |
DIRECT_MODE_INPUT(baseReg, bitmask); |
DIRECT_WRITE_LOW(baseReg, bitmask); |
interrupts(); |
} |
} |
// |
// Read a byte |
// |
uint8_t OneWire::read() { |
uint8_t bitMask; |
uint8_t r = 0; |
for (bitMask = 0x01; bitMask; bitMask <<= 1) { |
if ( OneWire::read_bit()) r |= bitMask; |
} |
return r; |
} |
void OneWire::read_bytes(uint8_t *buf, uint16_t count) { |
for (uint16_t i = 0 ; i < count ; i++) |
buf[i] = read(); |
} |
// |
// Do a ROM select |
// |
void OneWire::select( uint8_t rom[8]) |
{ |
int i; |
write(0x55); // Choose ROM |
for( i = 0; i < 8; i++) write(rom[i]); |
} |
// |
// Do a ROM skip |
// |
void OneWire::skip() |
{ |
write(0xCC); // Skip ROM |
} |
void OneWire::depower() |
{ |
noInterrupts(); |
DIRECT_MODE_INPUT(baseReg, bitmask); |
interrupts(); |
} |
#if ONEWIRE_SEARCH |
// |
// You need to use this function to start a search again from the beginning. |
// You do not need to do it for the first search, though you could. |
// |
void OneWire::reset_search() |
{ |
// reset the search state |
LastDiscrepancy = 0; |
LastDeviceFlag = FALSE; |
LastFamilyDiscrepancy = 0; |
for(int i = 7; ; i--) |
{ |
ROM_NO[i] = 0; |
if ( i == 0) break; |
} |
} |
// |
// Perform a search. If this function returns a '1' then it has |
// enumerated the next device and you may retrieve the ROM from the |
// OneWire::address variable. If there are no devices, no further |
// devices, or something horrible happens in the middle of the |
// enumeration then a 0 is returned. If a new device is found then |
// its address is copied to newAddr. Use OneWire::reset_search() to |
// start over. |
// |
// --- Replaced by the one from the Dallas Semiconductor web site --- |
//-------------------------------------------------------------------------- |
// Perform the 1-Wire Search Algorithm on the 1-Wire bus using the existing |
// search state. |
// Return TRUE : device found, ROM number in ROM_NO buffer |
// FALSE : device not found, end of search |
// |
uint8_t OneWire::search(uint8_t *newAddr) |
{ |
uint8_t id_bit_number; |
uint8_t last_zero, rom_byte_number, search_result; |
uint8_t id_bit, cmp_id_bit; |
unsigned char rom_byte_mask, search_direction; |
// initialize for search |
id_bit_number = 1; |
last_zero = 0; |
rom_byte_number = 0; |
rom_byte_mask = 1; |
search_result = 0; |
// if the last call was not the last one |
if (!LastDeviceFlag) |
{ |
// 1-Wire reset |
if (!reset()) |
{ |
// reset the search |
LastDiscrepancy = 0; |
LastDeviceFlag = FALSE; |
LastFamilyDiscrepancy = 0; |
return FALSE; |
} |
// issue the search command |
write(0xF0); |
// loop to do the search |
do |
{ |
// read a bit and its complement |
id_bit = read_bit(); |
cmp_id_bit = read_bit(); |
// check for no devices on 1-wire |
if ((id_bit == 1) && (cmp_id_bit == 1)) |
break; |
else |
{ |
// all devices coupled have 0 or 1 |
if (id_bit != cmp_id_bit) |
search_direction = id_bit; // bit write value for search |
else |
{ |
// if this discrepancy if before the Last Discrepancy |
// on a previous next then pick the same as last time |
if (id_bit_number < LastDiscrepancy) |
search_direction = ((ROM_NO[rom_byte_number] & rom_byte_mask) > 0); |
else |
// if equal to last pick 1, if not then pick 0 |
search_direction = (id_bit_number == LastDiscrepancy); |
// if 0 was picked then record its position in LastZero |
if (search_direction == 0) |
{ |
last_zero = id_bit_number; |
// check for Last discrepancy in family |
if (last_zero < 9) |
LastFamilyDiscrepancy = last_zero; |
} |
} |
// set or clear the bit in the ROM byte rom_byte_number |
// with mask rom_byte_mask |
if (search_direction == 1) |
ROM_NO[rom_byte_number] |= rom_byte_mask; |
else |
ROM_NO[rom_byte_number] &= ~rom_byte_mask; |
// serial number search direction write bit |
write_bit(search_direction); |
// increment the byte counter id_bit_number |
// and shift the mask rom_byte_mask |
id_bit_number++; |
rom_byte_mask <<= 1; |
// if the mask is 0 then go to new SerialNum byte rom_byte_number and reset mask |
if (rom_byte_mask == 0) |
{ |
rom_byte_number++; |
rom_byte_mask = 1; |
} |
} |
} |
while(rom_byte_number < 8); // loop until through all ROM bytes 0-7 |
// if the search was successful then |
if (!(id_bit_number < 65)) |
{ |
// search successful so set LastDiscrepancy,LastDeviceFlag,search_result |
LastDiscrepancy = last_zero; |
// check for last device |
if (LastDiscrepancy == 0) |
LastDeviceFlag = TRUE; |
search_result = TRUE; |
} |
} |
// if no device found then reset counters so next 'search' will be like a first |
if (!search_result || !ROM_NO[0]) |
{ |
LastDiscrepancy = 0; |
LastDeviceFlag = FALSE; |
LastFamilyDiscrepancy = 0; |
search_result = FALSE; |
} |
for (int i = 0; i < 8; i++) newAddr[i] = ROM_NO[i]; |
return search_result; |
} |
#endif |
#if ONEWIRE_CRC |
// The 1-Wire CRC scheme is described in Maxim Application Note 27: |
// "Understanding and Using Cyclic Redundancy Checks with Maxim iButton Products" |
// |
#if ONEWIRE_CRC8_TABLE |
// This table comes from Dallas sample code where it is freely reusable, |
// though Copyright (C) 2000 Dallas Semiconductor Corporation |
static const uint8_t PROGMEM dscrc_table[] = { |
0, 94,188,226, 97, 63,221,131,194,156,126, 32,163,253, 31, 65, |
157,195, 33,127,252,162, 64, 30, 95, 1,227,189, 62, 96,130,220, |
35,125,159,193, 66, 28,254,160,225,191, 93, 3,128,222, 60, 98, |
190,224, 2, 92,223,129, 99, 61,124, 34,192,158, 29, 67,161,255, |
70, 24,250,164, 39,121,155,197,132,218, 56,102,229,187, 89, 7, |
219,133,103, 57,186,228, 6, 88, 25, 71,165,251,120, 38,196,154, |
101, 59,217,135, 4, 90,184,230,167,249, 27, 69,198,152,122, 36, |
248,166, 68, 26,153,199, 37,123, 58,100,134,216, 91, 5,231,185, |
140,210, 48,110,237,179, 81, 15, 78, 16,242,172, 47,113,147,205, |
17, 79,173,243,112, 46,204,146,211,141,111, 49,178,236, 14, 80, |
175,241, 19, 77,206,144,114, 44,109, 51,209,143, 12, 82,176,238, |
50,108,142,208, 83, 13,239,177,240,174, 76, 18,145,207, 45,115, |
202,148,118, 40,171,245, 23, 73, 8, 86,180,234,105, 55,213,139, |
87, 9,235,181, 54,104,138,212,149,203, 41,119,244,170, 72, 22, |
233,183, 85, 11,136,214, 52,106, 43,117,151,201, 74, 20,246,168, |
116, 42,200,150, 21, 75,169,247,182,232, 10, 84,215,137,107, 53}; |
// |
// Compute a Dallas Semiconductor 8 bit CRC. These show up in the ROM |
// and the registers. (note: this might better be done without to |
// table, it would probably be smaller and certainly fast enough |
// compared to all those delayMicrosecond() calls. But I got |
// confused, so I use this table from the examples.) |
// |
uint8_t OneWire::crc8( uint8_t *addr, uint8_t len) |
{ |
uint8_t crc = 0; |
while (len--) { |
crc = pgm_read_byte(dscrc_table + (crc ^ *addr++)); |
} |
return crc; |
} |
#else |
// |
// Compute a Dallas Semiconductor 8 bit CRC directly. |
// this is much slower, but much smaller, than the lookup table. |
// |
uint8_t OneWire::crc8( uint8_t *addr, uint8_t len) |
{ |
uint8_t crc = 0; |
while (len--) { |
uint8_t inbyte = *addr++; |
for (uint8_t i = 8; i; i--) { |
uint8_t mix = (crc ^ inbyte) & 0x01; |
crc >>= 1; |
if (mix) crc ^= 0x8C; |
inbyte >>= 1; |
} |
} |
return crc; |
} |
#endif |
#if ONEWIRE_CRC16 |
bool OneWire::check_crc16(uint8_t* input, uint16_t len, uint8_t* inverted_crc) |
{ |
uint16_t crc = ~crc16(input, len); |
return (crc & 0xFF) == inverted_crc[0] && (crc >> 8) == inverted_crc[1]; |
} |
uint16_t OneWire::crc16(uint8_t* input, uint16_t len) |
{ |
static const uint8_t oddparity[16] = |
{ 0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0 }; |
uint16_t crc = 0; // Starting seed is zero. |
for (uint16_t i = 0 ; i < len ; i++) { |
// Even though we're just copying a byte from the input, |
// we'll be doing 16-bit computation with it. |
uint16_t cdata = input[i]; |
cdata = (cdata ^ (crc & 0xff)) & 0xff; |
crc >>= 8; |
if (oddparity[cdata & 0x0F] ^ oddparity[cdata >> 4]) |
crc ^= 0xC001; |
cdata <<= 6; |
crc ^= cdata; |
cdata <<= 1; |
crc ^= cdata; |
} |
return crc; |
} |
#endif |
#endif |
/trunk/libraries/OneWire/examples/DS250x_PROM/DS250x_PROM.pde |
---|
0,0 → 1,90 |
/* |
DS250x add-only programmable memory reader w/SKIP ROM. |
The DS250x is a 512/1024bit add-only PROM(you can add data but cannot change the old one) that's used mainly for device identification purposes |
like serial number, mfgr data, unique identifiers, etc. It uses the Maxim 1-wire bus. |
This sketch will use the SKIP ROM function that skips the 1-Wire search phase since we only have one device connected in the bus on digital pin 6. |
If more than one device is connected to the bus, it will fail. |
Sketch will not verify if device connected is from the DS250x family since the skip rom function effectively skips the family-id byte readout. |
thus it is possible to run this sketch with any Maxim OneWire device in which case the command CRC will most likely fail. |
Sketch will only read the first page of memory(32bits) starting from the lower address(0000h), if more than 1 device is present, then use the sketch with search functions. |
Remember to put a 4.7K pullup resistor between pin 6 and +Vcc |
To change the range or ammount of data to read, simply change the data array size, LSB/MSB addresses and for loop iterations |
This example code is in the public domain and is provided AS-IS. |
Built with Arduino 0022 and PJRC OneWire 2.0 library http://www.pjrc.com/teensy/td_libs_OneWire.html |
created by Guillermo Lovato <glovato@gmail.com> |
march/2011 |
*/ |
#include <OneWire.h> |
OneWire ds(6); // OneWire bus on digital pin 6 |
void setup() { |
Serial.begin (9600); |
} |
void loop() { |
byte i; // This is for the for loops |
boolean present; // device present var |
byte data[32]; // container for the data from device |
byte leemem[3] = { // array with the commands to initiate a read, DS250x devices expect 3 bytes to start a read: command,LSB&MSB adresses |
0xF0 , 0x00 , 0x00 }; // 0xF0 is the Read Data command, followed by 00h 00h as starting address(the beginning, 0000h) |
byte ccrc; // Variable to store the command CRC |
byte ccrc_calc; |
present = ds.reset(); // OneWire bus reset, always needed to start operation on the bus, returns a 1/TRUE if there's a device present. |
ds.skip(); // Skip ROM search |
if (present == TRUE){ // We only try to read the data if there's a device present |
Serial.println("DS250x device present"); |
ds.write(leemem[0],1); // Read data command, leave ghost power on |
ds.write(leemem[1],1); // LSB starting address, leave ghost power on |
ds.write(leemem[2],1); // MSB starting address, leave ghost power on |
ccrc = ds.read(); // DS250x generates a CRC for the command we sent, we assign a read slot and store it's value |
ccrc_calc = OneWire::crc8(leemem, 3); // We calculate the CRC of the commands we sent using the library function and store it |
if ( ccrc_calc != ccrc) { // Then we compare it to the value the ds250x calculated, if it fails, we print debug messages and abort |
Serial.println("Invalid command CRC!"); |
Serial.print("Calculated CRC:"); |
Serial.println(ccrc_calc,HEX); // HEX makes it easier to observe and compare |
Serial.print("DS250x readback CRC:"); |
Serial.println(ccrc,HEX); |
return; // Since CRC failed, we abort the rest of the loop and start over |
} |
Serial.println("Data is: "); // For the printout of the data |
for ( i = 0; i < 32; i++) { // Now it's time to read the PROM data itself, each page is 32 bytes so we need 32 read commands |
data[i] = ds.read(); // we store each read byte to a different position in the data array |
Serial.print(data[i]); // printout in ASCII |
Serial.print(" "); // blank space |
} |
Serial.println(); |
delay(5000); // Delay so we don't saturate the serial output |
} |
else { // Nothing is connected in the bus |
Serial.println("Nothing connected"); |
delay(3000); |
} |
} |
/trunk/libraries/OneWire/examples/DS2408_Switch/DS2408_Switch.pde |
---|
0,0 → 1,77 |
#include <OneWire.h> |
/* |
* DS2408 8-Channel Addressable Switch |
* |
* Writte by Glenn Trewitt, glenn at trewitt dot org |
* |
* Some notes about the DS2408: |
* - Unlike most input/output ports, the DS2408 doesn't have mode bits to |
* set whether the pins are input or output. If you issue a read command, |
* they're inputs. If you write to them, they're outputs. |
* - For reading from a switch, you should use 10K pull-up resisters. |
*/ |
void PrintBytes(uint8_t* addr, uint8_t count, bool newline=0) { |
for (uint8_t i = 0; i < count; i++) { |
Serial.print(addr[i]>>4, HEX); |
Serial.print(addr[i]&0x0f, HEX); |
} |
if (newline) |
Serial.println(); |
} |
void ReadAndReport(OneWire* net, uint8_t* addr) { |
Serial.print(" Reading DS2408 "); |
PrintBytes(addr, 8); |
Serial.println(); |
uint8_t buf[13]; // Put everything in the buffer so we can compute CRC easily. |
buf[0] = 0xF0; // Read PIO Registers |
buf[1] = 0x88; // LSB address |
buf[2] = 0x00; // MSB address |
net->write_bytes(buf, 3); |
net->read_bytes(buf+3, 10); // 3 cmd bytes, 6 data bytes, 2 0xFF, 2 CRC16 |
net->reset(); |
if (!OneWire::check_crc16(buf, 11, &buf[11])) { |
Serial.print("CRC failure in DS2408 at "); |
PrintBytes(addr, 8, true); |
return; |
} |
Serial.print(" DS2408 data = "); |
// First 3 bytes contain command, register address. |
Serial.println(buf[3], BIN); |
} |
OneWire net(10); // on pin 10 |
void setup(void) { |
Serial.begin(9600); |
} |
void loop(void) { |
byte i; |
byte present = 0; |
byte addr[8]; |
if (!net.search(addr)) { |
Serial.print("No more addresses.\n"); |
net.reset_search(); |
delay(1000); |
return; |
} |
if (OneWire::crc8(addr, 7) != addr[7]) { |
Serial.print("CRC is not valid!\n"); |
return; |
} |
if (addr[0] != 0x29) { |
PrintBytes(addr, 8); |
Serial.print(" is not a DS2408.\n"); |
return; |
} |
ReadAndReport(&net, addr); |
} |
/trunk/libraries/OneWire/examples/DS18x20_Temperature/DS18x20_Temperature.pde |
---|
0,0 → 1,109 |
#include <OneWire.h> |
// OneWire DS18S20, DS18B20, DS1822 Temperature Example |
// |
// http://www.pjrc.com/teensy/td_libs_OneWire.html |
// |
// The DallasTemperature library can do all this work for you! |
// http://milesburton.com/Dallas_Temperature_Control_Library |
OneWire ds(10); // on pin 10 |
void setup(void) { |
Serial.begin(9600); |
} |
void loop(void) { |
byte i; |
byte present = 0; |
byte type_s; |
byte data[12]; |
byte addr[8]; |
float celsius, fahrenheit; |
if ( !ds.search(addr)) { |
Serial.println("No more addresses."); |
Serial.println(); |
ds.reset_search(); |
delay(250); |
return; |
} |
Serial.print("ROM ="); |
for( i = 0; i < 8; i++) { |
Serial.write(' '); |
Serial.print(addr[i], HEX); |
} |
if (OneWire::crc8(addr, 7) != addr[7]) { |
Serial.println("CRC is not valid!"); |
return; |
} |
Serial.println(); |
// the first ROM byte indicates which chip |
switch (addr[0]) { |
case 0x10: |
Serial.println(" Chip = DS18S20"); // or old DS1820 |
type_s = 1; |
break; |
case 0x28: |
Serial.println(" Chip = DS18B20"); |
type_s = 0; |
break; |
case 0x22: |
Serial.println(" Chip = DS1822"); |
type_s = 0; |
break; |
default: |
Serial.println("Device is not a DS18x20 family device."); |
return; |
} |
ds.reset(); |
ds.select(addr); |
ds.write(0x44,1); // start conversion, with parasite power on at the end |
delay(1000); // maybe 750ms is enough, maybe not |
// we might do a ds.depower() here, but the reset will take care of it. |
present = ds.reset(); |
ds.select(addr); |
ds.write(0xBE); // Read Scratchpad |
Serial.print(" Data = "); |
Serial.print(present,HEX); |
Serial.print(" "); |
for ( i = 0; i < 9; i++) { // we need 9 bytes |
data[i] = ds.read(); |
Serial.print(data[i], HEX); |
Serial.print(" "); |
} |
Serial.print(" CRC="); |
Serial.print(OneWire::crc8(data, 8), HEX); |
Serial.println(); |
// convert the data to actual temperature |
unsigned int raw = (data[1] << 8) | data[0]; |
if (type_s) { |
raw = raw << 3; // 9 bit resolution default |
if (data[7] == 0x10) { |
// count remain gives full 12 bit resolution |
raw = (raw & 0xFFF0) + 12 - data[6]; |
} |
} else { |
byte cfg = (data[4] & 0x60); |
if (cfg == 0x00) raw = raw << 3; // 9 bit resolution, 93.75 ms |
else if (cfg == 0x20) raw = raw << 2; // 10 bit res, 187.5 ms |
else if (cfg == 0x40) raw = raw << 1; // 11 bit res, 375 ms |
// default is 12 bit resolution, 750 ms conversion time |
} |
celsius = (float)raw / 16.0; |
fahrenheit = celsius * 1.8 + 32.0; |
Serial.print(" Temperature = "); |
Serial.print(celsius); |
Serial.print(" Celsius, "); |
Serial.print(fahrenheit); |
Serial.println(" Fahrenheit"); |
} |
/trunk/libraries/OneWire/OneWire.h |
---|
0,0 → 1,192 |
#ifndef OneWire_h |
#define OneWire_h |
#include <inttypes.h> |
#if ARDUINO >= 100 |
#include "Arduino.h" // for delayMicroseconds, digitalPinToBitMask, etc |
#else |
#include "WProgram.h" // for delayMicroseconds |
#include "pins_arduino.h" // for digitalPinToBitMask, etc |
#endif |
// You can exclude certain features from OneWire. In theory, this |
// might save some space. In practice, the compiler automatically |
// removes unused code (technically, the linker, using -fdata-sections |
// and -ffunction-sections when compiling, and Wl,--gc-sections |
// when linking), so most of these will not result in any code size |
// reduction. Well, unless you try to use the missing features |
// and redesign your program to not need them! ONEWIRE_CRC8_TABLE |
// is the exception, because it selects a fast but large algorithm |
// or a small but slow algorithm. |
// you can exclude onewire_search by defining that to 0 |
#ifndef ONEWIRE_SEARCH |
#define ONEWIRE_SEARCH 1 |
#endif |
// You can exclude CRC checks altogether by defining this to 0 |
#ifndef ONEWIRE_CRC |
#define ONEWIRE_CRC 1 |
#endif |
// Select the table-lookup method of computing the 8-bit CRC |
// by setting this to 1. The lookup table enlarges code size by |
// about 250 bytes. It does NOT consume RAM (but did in very |
// old versions of OneWire). If you disable this, a slower |
// but very compact algorithm is used. |
#ifndef ONEWIRE_CRC8_TABLE |
#define ONEWIRE_CRC8_TABLE 1 |
#endif |
// You can allow 16-bit CRC checks by defining this to 1 |
// (Note that ONEWIRE_CRC must also be 1.) |
#ifndef ONEWIRE_CRC16 |
#define ONEWIRE_CRC16 1 |
#endif |
#define FALSE 0 |
#define TRUE 1 |
// Platform specific I/O definitions |
#if defined(__AVR__) |
#define PIN_TO_BASEREG(pin) (portInputRegister(digitalPinToPort(pin))) |
#define PIN_TO_BITMASK(pin) (digitalPinToBitMask(pin)) |
#define IO_REG_TYPE uint8_t |
#define IO_REG_ASM asm("r30") |
#define DIRECT_READ(base, mask) (((*(base)) & (mask)) ? 1 : 0) |
#define DIRECT_MODE_INPUT(base, mask) ((*(base+1)) &= ~(mask)) |
#define DIRECT_MODE_OUTPUT(base, mask) ((*(base+1)) |= (mask)) |
#define DIRECT_WRITE_LOW(base, mask) ((*(base+2)) &= ~(mask)) |
#define DIRECT_WRITE_HIGH(base, mask) ((*(base+2)) |= (mask)) |
#elif defined(__PIC32MX__) |
#include <plib.h> // is this necessary? |
#define PIN_TO_BASEREG(pin) (portModeRegister(digitalPinToPort(pin))) |
#define PIN_TO_BITMASK(pin) (digitalPinToBitMask(pin)) |
#define IO_REG_TYPE uint32_t |
#define IO_REG_ASM |
#define DIRECT_READ(base, mask) (((*(base+4)) & (mask)) ? 1 : 0) //PORTX + 0x10 |
#define DIRECT_MODE_INPUT(base, mask) ((*(base+2)) = (mask)) //TRISXSET + 0x08 |
#define DIRECT_MODE_OUTPUT(base, mask) ((*(base+1)) = (mask)) //TRISXCLR + 0x04 |
#define DIRECT_WRITE_LOW(base, mask) ((*(base+8+1)) = (mask)) //LATXCLR + 0x24 |
#define DIRECT_WRITE_HIGH(base, mask) ((*(base+8+2)) = (mask)) //LATXSET + 0x28 |
#else |
#error "Please define I/O register types here" |
#endif |
class OneWire |
{ |
private: |
IO_REG_TYPE bitmask; |
volatile IO_REG_TYPE *baseReg; |
#if ONEWIRE_SEARCH |
// global search state |
unsigned char ROM_NO[8]; |
uint8_t LastDiscrepancy; |
uint8_t LastFamilyDiscrepancy; |
uint8_t LastDeviceFlag; |
#endif |
public: |
OneWire( uint8_t pin); |
// Perform a 1-Wire reset cycle. Returns 1 if a device responds |
// with a presence pulse. Returns 0 if there is no device or the |
// bus is shorted or otherwise held low for more than 250uS |
uint8_t reset(void); |
// Issue a 1-Wire rom select command, you do the reset first. |
void select( uint8_t rom[8]); |
// Issue a 1-Wire rom skip command, to address all on bus. |
void skip(void); |
// Write a byte. If 'power' is one then the wire is held high at |
// the end for parasitically powered devices. You are responsible |
// for eventually depowering it by calling depower() or doing |
// another read or write. |
void write(uint8_t v, uint8_t power = 0); |
void write_bytes(const uint8_t *buf, uint16_t count, bool power = 0); |
// Read a byte. |
uint8_t read(void); |
void read_bytes(uint8_t *buf, uint16_t count); |
// Write a bit. The bus is always left powered at the end, see |
// note in write() about that. |
void write_bit(uint8_t v); |
// Read a bit. |
uint8_t read_bit(void); |
// Stop forcing power onto the bus. You only need to do this if |
// you used the 'power' flag to write() or used a write_bit() call |
// and aren't about to do another read or write. You would rather |
// not leave this powered if you don't have to, just in case |
// someone shorts your bus. |
void depower(void); |
#if ONEWIRE_SEARCH |
// Clear the search state so that if will start from the beginning again. |
void reset_search(); |
// Look for the next device. Returns 1 if a new address has been |
// returned. A zero might mean that the bus is shorted, there are |
// no devices, or you have already retrieved all of them. It |
// might be a good idea to check the CRC to make sure you didn't |
// get garbage. The order is deterministic. You will always get |
// the same devices in the same order. |
uint8_t search(uint8_t *newAddr); |
#endif |
#if ONEWIRE_CRC |
// Compute a Dallas Semiconductor 8 bit CRC, these are used in the |
// ROM and scratchpad registers. |
static uint8_t crc8( uint8_t *addr, uint8_t len); |
#if ONEWIRE_CRC16 |
// Compute the 1-Wire CRC16 and compare it against the received CRC. |
// Example usage (reading a DS2408): |
// // Put everything in a buffer so we can compute the CRC easily. |
// uint8_t buf[13]; |
// buf[0] = 0xF0; // Read PIO Registers |
// buf[1] = 0x88; // LSB address |
// buf[2] = 0x00; // MSB address |
// WriteBytes(net, buf, 3); // Write 3 cmd bytes |
// ReadBytes(net, buf+3, 10); // Read 6 data bytes, 2 0xFF, 2 CRC16 |
// if (!CheckCRC16(buf, 11, &buf[11])) { |
// // Handle error. |
// } |
// |
// @param input - Array of bytes to checksum. |
// @param len - How many bytes to use. |
// @param inverted_crc - The two CRC16 bytes in the received data. |
// This should just point into the received data, |
// *not* at a 16-bit integer. |
// @return True, iff the CRC matches. |
static bool check_crc16(uint8_t* input, uint16_t len, uint8_t* inverted_crc); |
// Compute a Dallas Semiconductor 16 bit CRC. This is required to check |
// the integrity of data received from many 1-Wire devices. Note that the |
// CRC computed here is *not* what you'll get from the 1-Wire network, |
// for two reasons: |
// 1) The CRC is transmitted bitwise inverted. |
// 2) Depending on the endian-ness of your processor, the binary |
// representation of the two-byte return value may have a different |
// byte order than the two bytes you get from 1-Wire. |
// @param input - Array of bytes to checksum. |
// @param len - How many bytes to use. |
// @return The CRC16, as defined by Dallas Semiconductor. |
static uint16_t crc16(uint8_t* input, uint16_t len); |
#endif |
#endif |
}; |
#endif |
/trunk/libraries/SnootlabDeuligne/Deuligne.h |
---|
0,0 → 1,140 |
/* |
* Deuligne.h |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
*/ |
#ifndef SNOOTLCDI2C_h |
#define SNOOTLCDI2C_h |
#if defined(ARDUINO) && ARDUINO >= 100 |
#define SNOOT_RETURN size_t |
#define SNOOT_WIREWRITE Wire.write |
#else |
#define SNOOT_RETURN void |
#define SNOOT_WIREWRITE Wire.send |
#endif |
#include <inttypes.h> |
#include <Print.h> |
// commands |
#define LCD_CLEARDISPLAY 0x01 |
#define LCD_RETURNHOME 0x02 |
#define LCD_ENTRYMODESET 0x04 |
#define LCD_DISPLAYCONTROL 0x08 |
#define LCD_CURSORSHIFT 0x10 |
#define LCD_FUNCTIONSET 0x20 |
#define LCD_SETCGRAMADDR 0x40 |
#define LCD_SETDDRAMADDR 0x80 |
// flags for display entry mode |
#define LCD_ENTRYRIGHT 0x00 |
#define LCD_ENTRYLEFT 0x02 |
#define LCD_ENTRYSHIFTINCREMENT 0x01 |
#define LCD_ENTRYSHIFTDECREMENT 0x00 |
// flags for display on/off control |
#define LCD_DISPLAYON 0x04 |
#define LCD_DISPLAYOFF 0x00 |
#define LCD_CURSORON 0x02 |
#define LCD_CURSOROFF 0x00 |
#define LCD_BLINKON 0x01 |
#define LCD_BLINKOFF 0x00 |
// flags for display/cursor shift |
#define LCD_DISPLAYMOVE 0x08 |
#define LCD_CURSORMOVE 0x00 |
#define LCD_MOVERIGHT 0x04 |
#define LCD_MOVELEFT 0x00 |
// flags for function set |
#define LCD_8BITMODE 0x10 |
#define LCD_4BITMODE 0x00 |
#define LCD_2LINE 0x08 |
#define LCD_1LINE 0x00 |
#define LCD_5x11DOTS 0x04 |
#define LCD_5x8DOTS 0x00 |
// overclcking I2C |
#define CPU_FREQ 16000000L // (...) - a discuter, car fonction vitesse clock cpu |
#define TWI_FREQ_MCP23008 400000L |
// IMPORTANT! Wire. must have a begin() before calling init() |
class Deuligne : public Print { |
public: |
Deuligne(int devI2CAddress=0xA7, int num_lines=2, int lcdwidth=16, int bufferwidth= 40); |
void commandWrite(int command); |
void init(); |
void clear(); |
void begin(uint8_t cols, uint8_t rows, uint8_t charsize = LCD_5x8DOTS); |
virtual SNOOT_RETURN write(uint8_t); |
// virtual void print(uint8_t); |
// virtual void printIn(uint8_t*); |
void backLight( bool turnOn ); |
//non-core--------------- |
//void cursorTo(int line_num, int x); |
void setCursor(uint8_t col, uint8_t row); |
//{cursorTo(n,x);} |
//void leftScroll(int chars, int delay_time); |
//end of non-core-------- |
//4bit only, therefore ideally private but may be needed by user |
//void commandWriteNibble(int nibble); |
// virtual void print(int value){print((uint8_t)value);} |
// virtual void printIn(char value[]){print((uint8_t*)value);} |
/** |
* from LiquidCrystal (official arduino) Library |
***/ |
void createChar(uint8_t, uint8_t[]); |
void command(uint8_t); |
void home(); |
void noDisplay(); |
void display(); |
void noBlink(); |
void blink(); |
void noCursor(); |
void cursor(); |
void scrollDisplayLeft(); |
void scrollDisplayRight(); |
void leftToRight(); |
void rightToLeft(); |
void autoscroll(); |
void noAutoscroll(); |
int get_key(); |
private: |
//void pulseEnablePin(); |
//void pushNibble(int nibble); |
//void pushByte(int value); |
int myNumLines; |
int myWidth; |
int myAddress; |
int myBufferwidth; |
int adc_key_in; |
// int adc_key_val[5]; |
int NUM_KEYS; |
uint8_t _displayfunction; |
uint8_t _displaycontrol; |
uint8_t _displaymode; |
}; |
#endif |
/trunk/libraries/SnootlabDeuligne/keywords.txt |
---|
0,0 → 1,37 |
####################################### |
# Syntax Coloring Map For Deuligne |
####################################### |
####################################### |
# Datatypes (KEYWORD1) |
####################################### |
Deuligne KEYWORD1 |
####################################### |
# Methods and Functions (KEYWORD2) |
####################################### |
# begin KEYWORD2 |
clear KEYWORD2 |
home KEYWORD2 |
print KEYWORD2 |
setCursor KEYWORD2 |
cursor KEYWORD2 |
noCursor KEYWORD2 |
blink KEYWORD2 |
noBlink KEYWORD2 |
display KEYWORD2 |
noDisplay KEYWORD2 |
autoscroll KEYWORD2 |
noAutoscroll KEYWORD2 |
leftToRight KEYWORD2 |
rightToLeft KEYWORD2 |
scrollDisplayLeft KEYWORD2 |
scrollDisplayRight KEYWORD2 |
backLight KEYWORD2 |
createChar KEYWORD2 |
####################################### |
# Constants (LITERAL1) |
####################################### |
/trunk/libraries/SnootlabDeuligne/README.md |
---|
0,0 → 1,33 |
# Requirements |
* Arduino: http://arduino.cc |
# Hardware |
Connect the following pins from MCP23008 to LCD |
* P0 - D4 |
* P1 - D5 |
* P2 - D6 |
* P3 - D7 |
* P4 - RS |
* P5 - RW (not used, set to 0 to ground for write) |
* P6 - Bl (backlight switch) |
* P7 - E |
# Install |
## on Mac |
### Using Finder |
* In Finder, go to "_Documents_", create folder "_Arduino_" inside, and create folder "_libraries_" inside "_Arduino_" folder |
* Download [Deuligne lib](http://github.com/Snootlab/Deuligne/zipball/master), and copy unzipped content - should be a folder named Snootlab-Deuligne-xxxx - to "_libraries_" folder |
### Using Terminal |
Copy Deuligne lib in your sketchbook, with the default path set in Arduino preferences: |
git clone https://github.com/Snootlab/Deuligne.git |
mkdir -p ~/Documents/Arduino/libraries/ |
ln -sf Deuligne ~/Documents/Arduino/libraries/Deuligne |
/trunk/libraries/SnootlabDeuligne/Deuligne.cpp |
---|
0,0 → 1,265 |
/*** |
* |
* |
* Deuligne library |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
**/ |
#include "Deuligne.h" |
#include <Wire.h> |
extern "C" { |
#include <stdio.h> //not needed yet |
#include <string.h> //needed for strlen() |
#include <inttypes.h> |
#if defined(ARDUINO) &&ARDUINO < 100 |
#include "WConstants.h" //all things wiring / arduino |
#endif |
} |
#if defined(ARDUINO) && ARDUINO >= 100 |
#include "Arduino.h" |
#endif |
//command bytes for LCD |
#define CMD_CLR 0x01 |
#define CMD_RIGHT 0x1C |
#define CMD_LEFT 0x18 |
#define CMD_HOME 0x02 |
//stuff the library user might call--------------------------------- |
//constructor. num_lines must be 1 or 2, currently. |
byte dataPlusMask = 0x20; // TODO!!! |
int adc_key_val[5] ={ |
50, 190, 400, 540, 770 }; |
Deuligne::Deuligne( int devI2CAddress, int num_lines, int lcdwidth, int bufferwidth) { |
myNumLines = num_lines; |
myWidth = lcdwidth; |
myAddress = devI2CAddress; |
myBufferwidth= bufferwidth; |
NUM_KEYS = 5; |
} |
void SetMCPReg( byte deviceAddr, byte reg, byte val ) { |
Wire.beginTransmission(deviceAddr); |
SNOOT_WIREWRITE(reg); |
SNOOT_WIREWRITE(val); |
Wire.endTransmission(); |
} |
void SendToLCD( byte deviceAddr, byte data ) { |
data |= dataPlusMask; |
SetMCPReg(deviceAddr,0x0A,data); |
data ^= 0x10; // E |
delayMicroseconds(1); |
SetMCPReg(deviceAddr,0x0A,data); |
data ^= 0x10; // E |
delayMicroseconds(1); |
SetMCPReg(deviceAddr,0x0A,data); |
delay(1); |
} |
void WriteLCDByte( byte deviceAddr, byte bdata ) { |
SendToLCD(deviceAddr,bdata >> 4); |
SendToLCD(deviceAddr,bdata & 0x0F); |
} |
void Deuligne::init( void ) { |
TWBR = ((CPU_FREQ / TWI_FREQ_MCP23008) - 16) / 2; |
dataPlusMask = 0; // initial: 0 |
SetMCPReg(myAddress,0x05,0x0C); // set CONFREG (0x05) to 0 |
SetMCPReg(myAddress,0x00,0x00); // set IOREG (0x00) to 0 |
// |
delay(50); |
SendToLCD(myAddress,0x03); |
delay(5); |
SendToLCD(myAddress,0x03); |
delayMicroseconds(100); |
SendToLCD(myAddress,0x03); |
delay(5); |
SendToLCD(myAddress,0x02); |
WriteLCDByte(myAddress,0x28); |
WriteLCDByte(myAddress,0x08); |
WriteLCDByte(myAddress,0x0C); // turn on, cursor off, no blinking |
delayMicroseconds(60); |
WriteLCDByte(myAddress,LCD_CLEARDISPLAY); // clear display |
delay(3); |
_displaycontrol = LCD_DISPLAYON | LCD_CURSOROFF | LCD_BLINKOFF; |
// Initialize to default text direction (for romance languages) |
_displaymode = LCD_ENTRYLEFT | LCD_ENTRYSHIFTDECREMENT; |
// set the entry mode |
command(LCD_ENTRYMODESET | _displaymode); |
backLight(1); |
display(); |
} |
void Deuligne::backLight( bool turnOn ) { |
dataPlusMask |= 0x80; // Lights mask |
if (!turnOn) dataPlusMask ^= 0x80; |
SetMCPReg(myAddress,0x0A,dataPlusMask); |
} |
SNOOT_RETURN Deuligne::write( uint8_t value ) { |
dataPlusMask |= 0x40; // RS |
WriteLCDByte(myAddress,(byte)value); |
dataPlusMask ^= 0x40; // RS |
} |
/* |
void Deuligne::printIn( char value[] ) { |
for ( char *p = value; *p != 0; p++ ) |
print(*p); |
} |
*/ |
void Deuligne::clear() { |
command(CMD_CLR); |
} |
void Deuligne::begin(uint8_t cols, uint8_t lines, uint8_t dotsize) { |
} |
void Deuligne::setCursor(uint8_t col, uint8_t row) { |
int row_offsets[] = { 0x00, 0x40, 0x14, 0x54 }; |
if ( row > myNumLines ) { |
row = myNumLines-1; // we count rows starting w/0 |
} |
command(LCD_SETDDRAMADDR | (col + row_offsets[row])); |
} |
/* |
void Deuligne::cursorTo(int line_num, int x) { |
command(CMD_HOME); |
int targetPos = x + line_num * myBufferwidth; |
for ( int i = 0; i < targetPos; i++) |
command(0x14); |
}*/ |
void Deuligne::command( uint8_t command ) { |
// RS - leave low |
WriteLCDByte(myAddress,command); |
delay(1); |
} |
/** |
* From LiquidCrystal (official arduino) Library |
**/ |
// Allows us to fill the first 8 CGRAM locations |
// with custom characters |
void Deuligne::createChar(uint8_t location, uint8_t charmap[]) { |
location &= 0x7; // we only have 8 locations 0-7 |
command(LCD_SETCGRAMADDR | (location << 3)); |
for (int i=0; i<8; i++) { |
write(charmap[i]); |
} |
} |
// Turn the display on/off (quickly) |
void Deuligne::noDisplay() { |
_displaycontrol &= ~LCD_DISPLAYON; |
command(LCD_DISPLAYCONTROL | _displaycontrol); |
} |
void Deuligne::display() { |
_displaycontrol |= LCD_DISPLAYON; |
command(LCD_DISPLAYCONTROL | _displaycontrol); |
} |
// Turns the underline cursor on/off |
void Deuligne::noCursor() { |
_displaycontrol &= ~LCD_CURSORON; |
command(LCD_DISPLAYCONTROL | _displaycontrol); |
} |
void Deuligne::cursor() { |
_displaycontrol |= LCD_CURSORON; |
command(LCD_DISPLAYCONTROL | _displaycontrol); |
} |
// Turn on and off the blinking cursor |
void Deuligne::noBlink() { |
_displaycontrol &= ~LCD_BLINKON; |
command(LCD_DISPLAYCONTROL | _displaycontrol); |
} |
void Deuligne::blink() { |
_displaycontrol |= LCD_BLINKON; |
command(LCD_DISPLAYCONTROL | _displaycontrol); |
} |
// These commands scroll the display without changing the RAM |
void Deuligne::scrollDisplayLeft(void) { |
command(LCD_CURSORSHIFT | LCD_DISPLAYMOVE | LCD_MOVELEFT); |
} |
void Deuligne::scrollDisplayRight(void) { |
command(LCD_CURSORSHIFT | LCD_DISPLAYMOVE | LCD_MOVERIGHT); |
} |
// This is for text that flows Left to Right |
void Deuligne::leftToRight(void) { |
_displaymode |= LCD_ENTRYLEFT; |
command(LCD_ENTRYMODESET | _displaymode); |
} |
// This is for text that flows Right to Left |
void Deuligne::rightToLeft(void) { |
_displaymode &= ~LCD_ENTRYLEFT; |
command(LCD_ENTRYMODESET | _displaymode); |
} |
// This will 'right justify' text from the cursor |
void Deuligne::autoscroll(void) { |
_displaymode |= LCD_ENTRYSHIFTINCREMENT; |
command(LCD_ENTRYMODESET | _displaymode); |
} |
// This will 'left justify' text from the cursor |
void Deuligne::noAutoscroll(void) { |
_displaymode &= ~LCD_ENTRYSHIFTINCREMENT; |
command(LCD_ENTRYMODESET | _displaymode); |
} |
void Deuligne::home() |
{ |
command(LCD_RETURNHOME); // set cursor position to zero |
delayMicroseconds(2000); // this command takes a long time! |
} |
// Get Joystick value |
// Convert ADC value to key number : |
// 0: Right Key |
// 1: Up Key |
// 2: Down Key |
// 3: Left Key |
// 4: Select Key |
int Deuligne::get_key(){ |
adc_key_in = analogRead(0); // read the value from the sensor |
int k; |
// determine which key is pressed |
for (k = 0; k < NUM_KEYS; k++) |
{ |
if (adc_key_in < adc_key_val[k]) |
{ |
return k; |
} |
} |
if (k >= NUM_KEYS) |
k = -1; // No valid key pressed |
return k; |
} |
/trunk/libraries/SnootlabDeuligne/examples/Blink/Blink.pde |
---|
0,0 → 1,56 |
/* |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on official arduino LiquidCrystal Library |
- Blink |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch prints "Hello World!" to the LCD and makes the |
cursor block blink. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include "Wire.h" |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
void setup() { |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// Print a message to the LCD. |
lcd.print("hello, world!"); |
} |
void loop() { |
// Turn off the blinking cursor: |
lcd.noBlink(); |
delay(3000); |
// Turn on the blinking cursor: |
lcd.blink(); |
delay(3000); |
} |
/trunk/libraries/SnootlabDeuligne/examples/Smiley/Smiley.pde |
---|
0,0 → 1,44 |
/* |
* Smiley |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
* Demo for custom characters on LCD display |
* Should display a simple :) on top left corner |
*/ |
#include <Wire.h> |
#include <Deuligne.h> |
Deuligne lcd; |
// Custom caracter, 5 significant bits for each byte |
byte smiley [8]={ |
B00000, |
B10001, |
B00000, |
B00000, |
B10001, |
B01110, |
B00000 |
}; |
void setup(){ |
Wire.begin(); |
lcd.init(); |
lcd.createChar(0,smiley); |
lcd.setCursor(0,0); // need to re-position after createChar |
lcd.write(0); |
} |
void loop(){ |
// Switch backlight every second |
lcd.backLight(true); |
delay(1000); |
lcd.backLight(false); |
delay(1000); |
} |
/trunk/libraries/SnootlabDeuligne/examples/Display/Display.pde |
---|
0,0 → 1,66 |
/* |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on official arduino LiquidCrystal Library |
- display() and noDisplay() |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch prints "Hello World!" to the LCD and uses the |
display() and noDisplay() functions to turn on and off |
the display. |
The circuit: |
* LCD RS pin to digital pin 12 |
* LCD Enable pin to digital pin 11 |
* LCD D4 pin to digital pin 5 |
* LCD D5 pin to digital pin 4 |
* LCD D6 pin to digital pin 3 |
* LCD D7 pin to digital pin 2 |
* LCD R/W pin to ground |
* 10K resistor: |
* ends to +5V and ground |
* wiper to LCD VO pin (pin 3) |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include "Wire.h" |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
void setup() { |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// Print a message to the LCD. |
lcd.print("hello, world!"); |
} |
void loop() { |
// Turn off the display: |
lcd.noDisplay(); |
delay(500); |
// Turn on the display: |
lcd.display(); |
delay(500); |
} |
/trunk/libraries/SnootlabDeuligne/examples/SerialDisplay/SerialDisplay.pde |
---|
0,0 → 1,60 |
/* |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on official arduino LiquidCrystal Library |
- Serial Input |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch displays text sent over the serial port |
(e.g. from the Serial Monitor) on an attached LCD. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include "Wire.h" |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
void setup(){ |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// initialize the serial communications: |
Serial.begin(9600); |
} |
void loop() |
{ |
// when characters arrive over the serial port... |
if (Serial.available()) { |
// wait a bit for the entire message to arrive |
delay(100); |
// clear the screen |
lcd.clear(); |
// read all the available characters |
while (Serial.available() > 0) { |
// display each character to the LCD |
lcd.write(Serial.read()); |
} |
} |
} |
/trunk/libraries/SnootlabDeuligne/examples/TextDirection/TextDirection.pde |
---|
0,0 → 1,83 |
/* |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on arduino LiquidCrystal Library - TextDirection |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch demonstrates how to use leftToRight() and rightToLeft() |
to move the cursor. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include <Wire.h> |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
int thisChar = 'a'; |
void setup() { |
Wire.begin(); |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// turn on the cursor: |
lcd.cursor(); |
Serial.begin(9600); |
} |
void loop() { |
// reverse directions at 'm': |
if (thisChar == 'm') { |
// go right for the next letter |
lcd.rightToLeft(); |
} |
// reverse again at 's': |
if (thisChar == 's') { |
// go left for the next letter |
lcd.leftToRight(); |
} |
// reset at 'z': |
if (thisChar > 'z') { |
// go to (0,0): |
lcd.home(); |
// start again at 0 |
thisChar = 'a'; |
} |
// print the character |
lcd.print(thisChar, BYTE); |
// wait a second: |
delay(1000); |
// increment the letter: |
thisChar++; |
} |
/trunk/libraries/SnootlabDeuligne/examples/DemoJoy/DemoJoy.pde |
---|
0,0 → 1,68 |
/* |
* Snootlab Deuligne joystick testing demo |
* Initial code from nuelectronics |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
*/ |
#include <Wire.h> // I2C library include |
#include <Deuligne.h> // LCD library include |
Deuligne lcd; // lcd object declaration |
//Key message |
char msgs[5][15] = { |
"Right Key OK ", |
"Up Key OK ", |
"Down Key OK ", |
"Left Key OK ", |
"Select Key OK" }; |
int key=-1; |
int oldkey=-1; |
void setup() |
{ |
Wire.begin(); // join i2c |
lcd.init(); // LCD init |
lcd.clear(); // Clear Display |
lcd.backLight(true); // Backlight ON |
lcd.setCursor(5,0); // Place cursor row 6, 1st line (counting from 0) |
lcd.print("Setup"); |
lcd.setCursor(7,1); // Place cursor row 8, 2nd line (counting from 0) |
lcd.print("ok"); |
delay(2000); |
lcd.clear(); |
lcd.print("Move Joystick"); |
} |
void loop() { |
key = lcd.get_key(); // read the value from the sensor & convert into key press |
if (key != oldkey) // if keypress is detected |
{ |
delay(50); // wait for debounce time |
key = lcd.get_key(); // read the value from the sensor & convert into key press |
if (key != oldkey) |
{ |
oldkey = key; |
if (key >=0){ |
// set the cursor to column 0, line 1 |
// (note: line 1 is the second row, since counting begins with 0): |
lcd.setCursor(0, 1); |
// print the key pressed: |
lcd.print(msgs[key]); |
} |
} |
} |
//delay(1000); |
} |
/trunk/libraries/SnootlabDeuligne/examples/Autoscroll/Autoscroll.pde |
---|
0,0 → 1,72 |
/* |
* Deuligne.h |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on official arduino LiquidCrystal Library |
- Autoscroll |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch demonstrates the use of the autoscroll() |
and noAutoscroll() functions to make new text scroll or not. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include "Wire.h" |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
void setup() { |
// set up the LCD's number of columns and rows: |
Wire.begin(); // join i2c bus (address optional for master) |
lcd.init(); // initialisation du panneau LCD (obligatoire) |
} |
void loop() { |
// set the cursor to (0,0): |
lcd.setCursor(0, 0); |
// print from 0 to 9: |
for (int thisChar = 0; thisChar < 10; thisChar++) { |
lcd.print(thisChar); |
delay(500); |
} |
// set the cursor to (16,1): |
lcd.setCursor(16,1); |
// set the display to automatically scroll: |
lcd.autoscroll(); |
// print from 0 to 9: |
for (int thisChar = 0; thisChar < 10; thisChar++) { |
lcd.print(thisChar); |
delay(500); |
} |
// turn off automatic scrolling |
lcd.noAutoscroll(); |
// clear screen for the next loop: |
lcd.clear(); |
} |
/trunk/libraries/SnootlabDeuligne/examples/First/First.pde |
---|
0,0 → 1,42 |
/* |
* First.pde |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
* Basic usage example |
* |
*/ |
#include <Wire.h> |
#include <Deuligne.h> |
// Object initialization |
Deuligne lcd; |
void setup() |
{ |
Wire.begin(); // join i2c bus (address optional for master) |
lcd.init(); // LCD panel initializatino |
lcd.clear(); // clear display |
lcd.setCursor(0,0); // top left |
lcd.print("Config"); |
lcd.setCursor(7,0); // middle top line (7 from 0-15) |
lcd.print("ok"); |
delay(1000); |
} |
void loop() |
{ |
lcd.clear(); // clear screen |
lcd.backLight(true); |
lcd.setCursor(0,0); // top left corner |
lcd.print("Deuligne"); |
lcd.setCursor(7,1); // middle bottom line (7 from 0-15) |
lcd.print((long)millis()/1000); |
delay(1000); |
} |
/trunk/libraries/SnootlabDeuligne/examples/HelloWorld/HelloWorld.pde |
---|
0,0 → 1,52 |
/* |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on official arduino LiquidCrystal Library |
- Hello World |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch prints "Hello World!" to the LCD |
and shows the time. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include "Wire.h" |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
void setup() { |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// Print a message to the LCD. |
lcd.print("hello, world!"); |
} |
void loop() { |
// set the cursor to column 0, line 1 |
// (note: line 1 is the second row, since counting begins with 0): |
lcd.setCursor(0, 1); |
// print the number of seconds since reset: |
lcd.print(millis()/1000); |
} |
/trunk/libraries/SnootlabDeuligne/examples/Cursor/Cursor.pde |
---|
0,0 → 1,54 |
/* |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on official arduino LiquidCrystal Library |
- Cursor |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch prints "Hello World!" to the LCD and |
uses the cursor() and noCursor() methods to turn |
on and off the cursor. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include "Wire.h" |
#include <Deuligne.h> |
// initialize the library with the numbers of the interface pins |
Deuligne lcd; |
void setup() { |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// Print a message to the LCD. |
lcd.print("hello, world!"); |
} |
void loop() { |
// Turn off the cursor: |
lcd.noCursor(); |
delay(500); |
// Turn on the cursor: |
lcd.cursor(); |
delay(500); |
} |
/trunk/libraries/SnootlabDeuligne/examples/Scroll/Scroll.pde |
---|
0,0 → 1,82 |
/* |
* Deuligne.h |
* |
* copyleft 2011 snootlab |
* free software, have fun ! |
* |
based on arduino LiquidCrystal Library |
- scrollDisplayLeft() and scrollDisplayRight() |
Demonstrates the use a 16x2 LCD display. The LiquidCrystal |
library works with all LCD displays that are compatible with the |
Hitachi HD44780 driver. There are many of them out there, and you |
can usually tell them by the 16-pin interface. |
This sketch prints "Hello World!" to the LCD and uses the |
scrollDisplayLeft() and scrollDisplayRight() methods to scroll |
the text. |
Library originally added 18 Apr 2008 |
by David A. Mellis |
library modified 5 Jul 2009 |
by Limor Fried (http://www.ladyada.net) |
example added 9 Jul 2009 |
by Tom Igoe |
modified 22 Nov 2010 |
by Tom Igoe |
This example code is in the public domain. |
http://www.arduino.cc/en/Tutorial/LiquidCrystal |
*/ |
// include the library code: |
#include <Wire.h> |
#include <Deuligne.h> |
// object initialization |
Deuligne lcd; |
void setup() { |
Wire.begin(); |
// set up the LCD's number of columns and rows: |
lcd.init(); |
// Print a message to the LCD. |
lcd.print("hello, world!"); |
delay(1000); |
} |
void loop() { |
// scroll 13 positions (string length) to the left |
// to move it offscreen left: |
for (int positionCounter = 0; positionCounter < 13; positionCounter++) { |
// scroll one position left: |
lcd.scrollDisplayLeft(); |
// wait a bit: |
delay(150); |
} |
// scroll 29 positions (string length + display length) to the right |
// to move it offscreen right: |
for (int positionCounter = 0; positionCounter < 29; positionCounter++) { |
// scroll one position right: |
lcd.scrollDisplayRight(); |
// wait a bit: |
delay(150); |
} |
// scroll 16 positions (display length + string length) to the left |
// to move it back to center: |
for (int positionCounter = 0; positionCounter < 16; positionCounter++) { |
// scroll one position left: |
lcd.scrollDisplayLeft(); |
// wait a bit: |
delay(150); |
} |
// delay at the end of the full loop: |
delay(1000); |
} |
/trunk/libraries/Eeprom24C512/Eeprom24C512.cpp |
---|
0,0 → 1,330 |
/**************************************************************************//** |
* \brief EEPROM 24C512 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C512 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file Eeprom24C512.cpp |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
#include <Wire.h> |
#include <Eeprom24C512.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM__PAGE_SIZE |
* \brief Size of a page in EEPROM memory. |
* This size is given by EEPROM memory datasheet. |
******************************************************************************/ |
#define EEPROM__PAGE_SIZE 128 |
/**************************************************************************//** |
* \def EEPROM__RD_BUFFER_SIZE |
* \brief Size of input TWI buffer. |
* This size is equal to BUFFER_LENGTH defined in Wire library (32 bytes). |
******************************************************************************/ |
#define EEPROM__RD_BUFFER_SIZE BUFFER_LENGTH |
/**************************************************************************//** |
* \def EEPROM__WR_BUFFER_SIZE |
* \brief Size of output TWI buffer. |
* This size is equal to BUFFER_LENGTH - 2 bytes reserved for address. |
******************************************************************************/ |
#define EEPROM__WR_BUFFER_SIZE (BUFFER_LENGTH - 2) |
/****************************************************************************** |
* Public method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn Eeprom24C512::Eeprom24C512(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
******************************************************************************/ |
Eeprom24C512::Eeprom24C512 |
( |
byte deviceAddress |
){ |
m_deviceAddress = deviceAddress; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C512::initialize() |
* |
* \brief Initialize library and TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
******************************************************************************/ |
void |
Eeprom24C512::initialize() |
{ |
Wire.begin(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C512::writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
******************************************************************************/ |
void |
Eeprom24C512::writeByte |
( |
word address, |
byte data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.write(data); |
Wire.endTransmission(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C512::writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
******************************************************************************/ |
void |
Eeprom24C512::writeBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
// Write first page if not aligned. |
byte notAlignedLength = 0; |
byte pageOffset = address % EEPROM__PAGE_SIZE; |
if (pageOffset > 0) |
{ |
notAlignedLength = EEPROM__PAGE_SIZE - pageOffset; |
writePage(address, notAlignedLength, p_data); |
length -= notAlignedLength; |
} |
if (length > 0) |
{ |
address += notAlignedLength; |
p_data += notAlignedLength; |
// Write complete and aligned pages. |
word pageCount = length / EEPROM__PAGE_SIZE; |
for (word i = 0; i < pageCount; i++) |
{ |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
address += EEPROM__PAGE_SIZE; |
p_data += EEPROM__PAGE_SIZE; |
length -= EEPROM__PAGE_SIZE; |
} |
if (length > 0) |
{ |
// Write remaining uncomplete page. |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
} |
} |
} |
/**************************************************************************//** |
* \fn byte Eeprom24C512::readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
******************************************************************************/ |
byte |
Eeprom24C512::readByte |
( |
word address |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, (byte)1); |
byte data = 0; |
if (Wire.available()) |
{ |
data = Wire.read(); |
} |
return data; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C512::readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C512::readBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
word bufferCount = length / EEPROM__RD_BUFFER_SIZE; |
for (word i = 0; i < bufferCount; i++) |
{ |
word offset = i * EEPROM__RD_BUFFER_SIZE; |
readBuffer(address + offset, EEPROM__RD_BUFFER_SIZE, p_data + offset); |
} |
byte remainingBytes = length % EEPROM__RD_BUFFER_SIZE; |
word offset = length - remainingBytes; |
readBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/****************************************************************************** |
* Private method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void Eeprom24C512::writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__PAGE_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C512::writePage |
( |
word address, |
byte length, |
byte* p_data |
){ |
// Write complete buffers. |
byte bufferCount = length / EEPROM__WR_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
byte offset = i * EEPROM__WR_BUFFER_SIZE; |
writeBuffer(address + offset, EEPROM__WR_BUFFER_SIZE, p_data + offset); |
} |
// Write remaining bytes. |
byte remainingBytes = length % EEPROM__WR_BUFFER_SIZE; |
byte offset = length - remainingBytes; |
writeBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C512::writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__WR_BUFFER_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C512::writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
for (byte i = 0; i < length; i++) |
{ |
Wire.write(p_data[i]); |
} |
Wire.endTransmission(); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C512::readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__RD_BUFFER_SIZE bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C512::readBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, length); |
for (byte i = 0; i < length; i++) |
{ |
if (Wire.available()) |
{ |
p_data[i] = Wire.read(); |
} |
} |
} |
/trunk/libraries/Eeprom24C512/keywords.txt |
---|
0,0 → 1,30 |
################################################################################ |
# Syntax Coloring Map For Eeprom24C512 |
################################################################################ |
################################################################################ |
# Datatypes (KEYWORD1) |
################################################################################ |
################################################################################ |
# Methods and Functions (KEYWORD2) |
################################################################################ |
initialize KEYWORD2 |
writeByte KEYWORD2 |
writeBytes KEYWORD2 |
readByte KEYWORD2 |
readBytes KEYWORD2 |
writePage KEYWORD2 |
writeBuffer KEYWORD2 |
readBuffer KEYWORD2 |
################################################################################ |
# Instances (KEYWORD2) |
################################################################################ |
Eeprom24C512 KEYWORD2 |
################################################################################ |
# Constants (LITERAL1) |
################################################################################ |
/trunk/libraries/Eeprom24C512/lgpl-3.0.txt |
---|
0,0 → 1,165 |
GNU LESSER GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
This version of the GNU Lesser General Public License incorporates |
the terms and conditions of version 3 of the GNU General Public |
License, supplemented by the additional permissions listed below. |
0. Additional Definitions. |
As used herein, "this License" refers to version 3 of the GNU Lesser |
General Public License, and the "GNU GPL" refers to version 3 of the GNU |
General Public License. |
"The Library" refers to a covered work governed by this License, |
other than an Application or a Combined Work as defined below. |
An "Application" is any work that makes use of an interface provided |
by the Library, but which is not otherwise based on the Library. |
Defining a subclass of a class defined by the Library is deemed a mode |
of using an interface provided by the Library. |
A "Combined Work" is a work produced by combining or linking an |
Application with the Library. The particular version of the Library |
with which the Combined Work was made is also called the "Linked |
Version". |
The "Minimal Corresponding Source" for a Combined Work means the |
Corresponding Source for the Combined Work, excluding any source code |
for portions of the Combined Work that, considered in isolation, are |
based on the Application, and not on the Linked Version. |
The "Corresponding Application Code" for a Combined Work means the |
object code and/or source code for the Application, including any data |
and utility programs needed for reproducing the Combined Work from the |
Application, but excluding the System Libraries of the Combined Work. |
1. Exception to Section 3 of the GNU GPL. |
You may convey a covered work under sections 3 and 4 of this License |
without being bound by section 3 of the GNU GPL. |
2. Conveying Modified Versions. |
If you modify a copy of the Library, and, in your modifications, a |
facility refers to a function or data to be supplied by an Application |
that uses the facility (other than as an argument passed when the |
facility is invoked), then you may convey a copy of the modified |
version: |
a) under this License, provided that you make a good faith effort to |
ensure that, in the event an Application does not supply the |
function or data, the facility still operates, and performs |
whatever part of its purpose remains meaningful, or |
b) under the GNU GPL, with none of the additional permissions of |
this License applicable to that copy. |
3. Object Code Incorporating Material from Library Header Files. |
The object code form of an Application may incorporate material from |
a header file that is part of the Library. You may convey such object |
code under terms of your choice, provided that, if the incorporated |
material is not limited to numerical parameters, data structure |
layouts and accessors, or small macros, inline functions and templates |
(ten or fewer lines in length), you do both of the following: |
a) Give prominent notice with each copy of the object code that the |
Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the object code with a copy of the GNU GPL and this license |
document. |
4. Combined Works. |
You may convey a Combined Work under terms of your choice that, |
taken together, effectively do not restrict modification of the |
portions of the Library contained in the Combined Work and reverse |
engineering for debugging such modifications, if you also do each of |
the following: |
a) Give prominent notice with each copy of the Combined Work that |
the Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the Combined Work with a copy of the GNU GPL and this license |
document. |
c) For a Combined Work that displays copyright notices during |
execution, include the copyright notice for the Library among |
these notices, as well as a reference directing the user to the |
copies of the GNU GPL and this license document. |
d) Do one of the following: |
0) Convey the Minimal Corresponding Source under the terms of this |
License, and the Corresponding Application Code in a form |
suitable for, and under terms that permit, the user to |
recombine or relink the Application with a modified version of |
the Linked Version to produce a modified Combined Work, in the |
manner specified by section 6 of the GNU GPL for conveying |
Corresponding Source. |
1) Use a suitable shared library mechanism for linking with the |
Library. A suitable mechanism is one that (a) uses at run time |
a copy of the Library already present on the user's computer |
system, and (b) will operate properly with a modified version |
of the Library that is interface-compatible with the Linked |
Version. |
e) Provide Installation Information, but only if you would otherwise |
be required to provide such information under section 6 of the |
GNU GPL, and only to the extent that such information is |
necessary to install and execute a modified version of the |
Combined Work produced by recombining or relinking the |
Application with a modified version of the Linked Version. (If |
you use option 4d0, the Installation Information must accompany |
the Minimal Corresponding Source and Corresponding Application |
Code. If you use option 4d1, you must provide the Installation |
Information in the manner specified by section 6 of the GNU GPL |
for conveying Corresponding Source.) |
5. Combined Libraries. |
You may place library facilities that are a work based on the |
Library side by side in a single library together with other library |
facilities that are not Applications and are not covered by this |
License, and convey such a combined library under terms of your |
choice, if you do both of the following: |
a) Accompany the combined library with a copy of the same work based |
on the Library, uncombined with any other library facilities, |
conveyed under the terms of this License. |
b) Give prominent notice with the combined library that part of it |
is a work based on the Library, and explaining where to find the |
accompanying uncombined form of the same work. |
6. Revised Versions of the GNU Lesser General Public License. |
The Free Software Foundation may publish revised and/or new versions |
of the GNU Lesser General Public License from time to time. Such new |
versions will be similar in spirit to the present version, but may |
differ in detail to address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Library as you received it specifies that a certain numbered version |
of the GNU Lesser General Public License "or any later version" |
applies to it, you have the option of following the terms and |
conditions either of that published version or of any later version |
published by the Free Software Foundation. If the Library as you |
received it does not specify a version number of the GNU Lesser |
General Public License, you may choose any version of the GNU Lesser |
General Public License ever published by the Free Software Foundation. |
If the Library as you received it specifies that a proxy can decide |
whether future versions of the GNU Lesser General Public License shall |
apply, that proxy's public statement of acceptance of any version is |
permanent authorization for you to choose that version for the |
Library. |
/trunk/libraries/Eeprom24C512/examples/WriteReadByte/WriteReadByte.ino |
---|
0,0 → 1,93 |
/**************************************************************************//** |
* \brief EEPROM 24C512 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C512 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadByte.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C512.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C512 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initialize EEPROM library. |
eeprom.initialize(); |
// Write a byte at address 0 in EEPROM memory. |
Serial.println("Write byte to EEPROM memory..."); |
eeprom.writeByte(0, 0xAA); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
// Read a byte at address 0 in EEPROM memory. |
Serial.println("Read byte from EEPROM memory..."); |
byte data = eeprom.readByte(0); |
// Print read byte. |
Serial.print("Read byte = 0x"); |
Serial.print(data, HEX); |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C512/examples/WriteReadBytes/WriteReadBytes.ino |
---|
0,0 → 1,105 |
/**************************************************************************//** |
* \brief EEPROM 24C512 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C512 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadBytes.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C512.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C512 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initiliaze EEPROM library. |
eeprom.initialize(); |
// Declare byte arrays. |
byte inputBytes[94] = { 0 }; |
byte outputBytes[94] = { 0 }; |
// Fill input array with printable characters. See ASCII table for more |
// details. |
for (byte i = 0; i < 94; i++) |
{ |
inputBytes[i] = i + 33; |
} |
// Write input array to EEPROM memory. |
Serial.println("Write bytes to EEPROM memory..."); |
eeprom.writeBytes(0, 94, inputBytes); |
// Read array with bytes read from EEPROM memory. |
Serial.println("Read bytes from EEPROM memory..."); |
eeprom.readBytes(0, 94, outputBytes); |
// Print read bytes. |
Serial.println("Read bytes:"); |
for (byte i = 0; i < 94; i++) |
{ |
Serial.write(outputBytes[i]); |
Serial.print(" "); |
} |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C512/Eeprom24C512.h |
---|
0,0 → 1,211 |
/**************************************************************************//** |
* \brief EEPROM 24C512 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120203 |
* |
* This file is part of the EEPROM 24C512 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \headerfile Eeprom24C512.h |
******************************************************************************/ |
#ifndef Eeprom24C512_h |
#define Eeprom24C512_h |
/****************************************************************************** |
* Header file inclusion. |
******************************************************************************/ |
#include <Arduino.h> |
/**************************************************************************//** |
* \class Eeprom24C512 |
* |
* \brief EEPROM 24C512 memory driver. |
* |
* This driver is designed for 24C512 memory. |
******************************************************************************/ |
class Eeprom24C512 |
{ |
public: |
/******************************************************************//** |
* \fn Eeprom24C512(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
**********************************************************************/ |
Eeprom24C512 |
( |
byte deviceAddress |
); |
/******************************************************************//** |
* \fn void initialize() |
* |
* \brief Initialize library abnd TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
**********************************************************************/ |
void |
initialize(); |
/******************************************************************//** |
* \fn void writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
**********************************************************************/ |
void |
writeByte |
( |
word address, |
byte data |
); |
/******************************************************************//** |
* \fn void writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
**********************************************************************/ |
void |
writeBytes |
( |
word address, |
word length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn byte readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
**********************************************************************/ |
byte |
readByte |
( |
word address |
); |
/******************************************************************//** |
* \fn void readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
**********************************************************************/ |
void |
readBytes |
( |
word address, |
word length, |
byte* p_buffer |
); |
private: |
byte m_deviceAddress; |
/******************************************************************//** |
* \fn void writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (64 bytes max). |
* \param[in] p_data Data. |
**********************************************************************/ |
void |
writePage |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (30 bytes max). |
* \param[in] p_date Data. |
**********************************************************************/ |
void |
writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read (32 bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
**********************************************************************/ |
void |
readBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
}; |
#endif // Eeprom24C512_h |
/trunk/libraries/Eeprom24C128_256/Eeprom24C128_256.cpp |
---|
0,0 → 1,329 |
/**************************************************************************//** |
* \brief EEPROM 24C128 / 24C256 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120203 |
* |
* This file is part of the EEPROM 24C128 / 24C256 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file Eeprom24C128_256.cpp |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
#include <Wire.h> |
#include <Eeprom24C128_256.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM__PAGE_SIZE |
* \brief Size of a page in EEPROM memory. |
* This size is given by EEPROM memory datasheet. |
******************************************************************************/ |
#define EEPROM__PAGE_SIZE 64 |
/**************************************************************************//** |
* \def EEPROM__RD_BUFFER_SIZE |
* \brief Size of input TWI buffer. |
* This size is equal to BUFFER_LENGTH defined in Wire library (32 bytes). |
******************************************************************************/ |
#define EEPROM__RD_BUFFER_SIZE BUFFER_LENGTH |
/**************************************************************************//** |
* \def EEPROM__WR_BUFFER_SIZE |
* \brief Size of output TWI buffer. |
* This size is equal to BUFFER_LENGTH - 2 bytes reserved for address. |
******************************************************************************/ |
#define EEPROM__WR_BUFFER_SIZE (BUFFER_LENGTH - 2) |
/****************************************************************************** |
* Public method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn Eeprom24C128_256::Eeprom24C128_256(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
******************************************************************************/ |
Eeprom24C128_256::Eeprom24C128_256 |
( |
byte deviceAddress |
){ |
m_deviceAddress = deviceAddress; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::initialize() |
* |
* \brief Initialize library and TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
******************************************************************************/ |
void |
Eeprom24C128_256::initialize() |
{ |
Wire.begin(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
******************************************************************************/ |
void |
Eeprom24C128_256::writeByte |
( |
word address, |
byte data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.write(data); |
Wire.endTransmission(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
******************************************************************************/ |
void |
Eeprom24C128_256::writeBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
// Write first page if not aligned. |
byte notAlignedLength = 0; |
byte pageOffset = address % EEPROM__PAGE_SIZE; |
if (pageOffset > 0) |
{ |
notAlignedLength = EEPROM__PAGE_SIZE - pageOffset; |
writePage(address, notAlignedLength, p_data); |
length -= notAlignedLength; |
} |
if (length > 0) |
{ |
address += notAlignedLength; |
p_data += notAlignedLength; |
// Write complete and aligned pages. |
word pageCount = length / EEPROM__PAGE_SIZE; |
for (word i = 0; i < pageCount; i++) |
{ |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
address += EEPROM__PAGE_SIZE; |
p_data += EEPROM__PAGE_SIZE; |
length -= EEPROM__PAGE_SIZE; |
} |
if (length > 0) |
{ |
// Write remaining uncomplete page. |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
} |
} |
} |
/**************************************************************************//** |
* \fn byte Eeprom24C128_256::readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
******************************************************************************/ |
byte |
Eeprom24C128_256::readByte |
( |
word address |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, (byte)1); |
byte data = 0; |
if (Wire.available()) |
{ |
data = Wire.read(); |
} |
return data; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C128_256::readBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
byte bufferCount = length / EEPROM__RD_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
word offset = i * EEPROM__RD_BUFFER_SIZE; |
readBuffer(address + offset, EEPROM__RD_BUFFER_SIZE, p_data + offset); |
} |
byte remainingBytes = length % EEPROM__RD_BUFFER_SIZE; |
word offset = length - remainingBytes; |
readBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/****************************************************************************** |
* Private method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__PAGE_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C128_256::writePage |
( |
word address, |
byte length, |
byte* p_data |
){ |
// Write complete buffers. |
byte bufferCount = length / EEPROM__WR_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
byte offset = i * EEPROM__WR_BUFFER_SIZE; |
writeBuffer(address + offset, EEPROM__WR_BUFFER_SIZE, p_data + offset); |
} |
// Write remaining bytes. |
byte remainingBytes = length % EEPROM__WR_BUFFER_SIZE; |
byte offset = length - remainingBytes; |
writeBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__WR_BUFFER_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C128_256::writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
for (byte i = 0; i < length; i++) |
{ |
Wire.write(p_data[i]); |
} |
Wire.endTransmission(); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C128_256::readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__RD_BUFFER_SIZE bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C128_256::readBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, length); |
for (byte i = 0; i < length; i++) |
{ |
if (Wire.available()) |
{ |
p_data[i] = Wire.read(); |
} |
} |
} |
/trunk/libraries/Eeprom24C128_256/examples/WriteReadByte/WriteReadByte.ino |
---|
0,0 → 1,93 |
/**************************************************************************//** |
* \brief EEPROM 24C128 / 24C256 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120203 |
* |
* This file is part of the EEPROM 24C128 / 24C256 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadByte.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C128_256.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C128_256 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initialize EEPROM library. |
eeprom.initialize(); |
// Write a byte at address 0 in EEPROM memory. |
Serial.println("Write byte to EEPROM memory..."); |
eeprom.writeByte(0, 0xAA); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
// Read a byte at address 0 in EEPROM memory. |
Serial.println("Read byte from EEPROM memory..."); |
byte data = eeprom.readByte(0); |
// Print read byte. |
Serial.print("Read byte = 0x"); |
Serial.print(data, HEX); |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C128_256/examples/WriteReadBytes/WriteReadBytes.ino |
---|
0,0 → 1,105 |
/**************************************************************************//** |
* \brief EEPROM 24C128 / 24C256 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120203 |
* |
* This file is part of the EEPROM 24C128 / 24C256 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadBytes.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C128_256.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C128_256 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initiliaze EEPROM library. |
eeprom.initialize(); |
// Declare byte arrays. |
byte inputBytes[94] = { 0 }; |
byte outputBytes[94] = { 0 }; |
// Fill input array with printable characters. See ASCII table for more |
// details. |
for (byte i = 0; i < 94; i++) |
{ |
inputBytes[i] = i + 33; |
} |
// Write input array to EEPROM memory. |
Serial.println("Write bytes to EEPROM memory..."); |
eeprom.writeBytes(0, 94, inputBytes); |
// Read array with bytes read from EEPROM memory. |
Serial.println("Read bytes from EEPROM memory..."); |
eeprom.readBytes(0, 94, outputBytes); |
// Print read bytes. |
Serial.println("Read bytes:"); |
for (byte i = 0; i < 94; i++) |
{ |
Serial.write(outputBytes[i]); |
Serial.print(" "); |
} |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C128_256/keywords.txt |
---|
0,0 → 1,30 |
################################################################################ |
# Syntax Coloring Map For Eeprom24C128_256 |
################################################################################ |
################################################################################ |
# Datatypes (KEYWORD1) |
################################################################################ |
################################################################################ |
# Methods and Functions (KEYWORD2) |
################################################################################ |
initialize KEYWORD2 |
writeByte KEYWORD2 |
writeBytes KEYWORD2 |
readByte KEYWORD2 |
readBytes KEYWORD2 |
writePage KEYWORD2 |
writeBuffer KEYWORD2 |
readBuffer KEYWORD2 |
################################################################################ |
# Instances (KEYWORD2) |
################################################################################ |
Eeprom24C128_256 KEYWORD2 |
################################################################################ |
# Constants (LITERAL1) |
################################################################################ |
/trunk/libraries/Eeprom24C128_256/Eeprom24C128_256.h |
---|
0,0 → 1,212 |
/**************************************************************************//** |
* \brief EEPROM 24C128 / 24C256 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120203 |
* |
* This file is part of the EEPROM 24C128 / 24C256 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \headerfile Eeprom24C128_256.h |
******************************************************************************/ |
#ifndef Eeprom24C128_256_h |
#define Eeprom24C128_256_h |
/****************************************************************************** |
* Header file inclusion. |
******************************************************************************/ |
#include <Arduino.h> |
/**************************************************************************//** |
* \class Eeprom24C128_256 |
* |
* \brief EEPROM 24C128 / 24C256 memory driver. |
* |
* This driver is mainly designed for 24C128 and 24C256 EEPROM memories. It's |
* also suitable for 24C512 memories. |
******************************************************************************/ |
class Eeprom24C128_256 |
{ |
public: |
/******************************************************************//** |
* \fn Eeprom24C128_256(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
**********************************************************************/ |
Eeprom24C128_256 |
( |
byte deviceAddress |
); |
/******************************************************************//** |
* \fn void initialize() |
* |
* \brief Initialize library abnd TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
**********************************************************************/ |
void |
initialize(); |
/******************************************************************//** |
* \fn void writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
**********************************************************************/ |
void |
writeByte |
( |
word address, |
byte data |
); |
/******************************************************************//** |
* \fn void writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
**********************************************************************/ |
void |
writeBytes |
( |
word address, |
word length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn byte readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
**********************************************************************/ |
byte |
readByte |
( |
word address |
); |
/******************************************************************//** |
* \fn void readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
**********************************************************************/ |
void |
readBytes |
( |
word address, |
word length, |
byte* p_buffer |
); |
private: |
byte m_deviceAddress; |
/******************************************************************//** |
* \fn void writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (64 bytes max). |
* \param[in] p_data Data. |
**********************************************************************/ |
void |
writePage |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (30 bytes max). |
* \param[in] p_date Data. |
**********************************************************************/ |
void |
writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read (32 bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
**********************************************************************/ |
void |
readBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
}; |
#endif // Eeprom24C128_256_h |
/trunk/libraries/Eeprom24C128_256/lgpl-3.0.txt |
---|
0,0 → 1,165 |
GNU LESSER GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
This version of the GNU Lesser General Public License incorporates |
the terms and conditions of version 3 of the GNU General Public |
License, supplemented by the additional permissions listed below. |
0. Additional Definitions. |
As used herein, "this License" refers to version 3 of the GNU Lesser |
General Public License, and the "GNU GPL" refers to version 3 of the GNU |
General Public License. |
"The Library" refers to a covered work governed by this License, |
other than an Application or a Combined Work as defined below. |
An "Application" is any work that makes use of an interface provided |
by the Library, but which is not otherwise based on the Library. |
Defining a subclass of a class defined by the Library is deemed a mode |
of using an interface provided by the Library. |
A "Combined Work" is a work produced by combining or linking an |
Application with the Library. The particular version of the Library |
with which the Combined Work was made is also called the "Linked |
Version". |
The "Minimal Corresponding Source" for a Combined Work means the |
Corresponding Source for the Combined Work, excluding any source code |
for portions of the Combined Work that, considered in isolation, are |
based on the Application, and not on the Linked Version. |
The "Corresponding Application Code" for a Combined Work means the |
object code and/or source code for the Application, including any data |
and utility programs needed for reproducing the Combined Work from the |
Application, but excluding the System Libraries of the Combined Work. |
1. Exception to Section 3 of the GNU GPL. |
You may convey a covered work under sections 3 and 4 of this License |
without being bound by section 3 of the GNU GPL. |
2. Conveying Modified Versions. |
If you modify a copy of the Library, and, in your modifications, a |
facility refers to a function or data to be supplied by an Application |
that uses the facility (other than as an argument passed when the |
facility is invoked), then you may convey a copy of the modified |
version: |
a) under this License, provided that you make a good faith effort to |
ensure that, in the event an Application does not supply the |
function or data, the facility still operates, and performs |
whatever part of its purpose remains meaningful, or |
b) under the GNU GPL, with none of the additional permissions of |
this License applicable to that copy. |
3. Object Code Incorporating Material from Library Header Files. |
The object code form of an Application may incorporate material from |
a header file that is part of the Library. You may convey such object |
code under terms of your choice, provided that, if the incorporated |
material is not limited to numerical parameters, data structure |
layouts and accessors, or small macros, inline functions and templates |
(ten or fewer lines in length), you do both of the following: |
a) Give prominent notice with each copy of the object code that the |
Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the object code with a copy of the GNU GPL and this license |
document. |
4. Combined Works. |
You may convey a Combined Work under terms of your choice that, |
taken together, effectively do not restrict modification of the |
portions of the Library contained in the Combined Work and reverse |
engineering for debugging such modifications, if you also do each of |
the following: |
a) Give prominent notice with each copy of the Combined Work that |
the Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the Combined Work with a copy of the GNU GPL and this license |
document. |
c) For a Combined Work that displays copyright notices during |
execution, include the copyright notice for the Library among |
these notices, as well as a reference directing the user to the |
copies of the GNU GPL and this license document. |
d) Do one of the following: |
0) Convey the Minimal Corresponding Source under the terms of this |
License, and the Corresponding Application Code in a form |
suitable for, and under terms that permit, the user to |
recombine or relink the Application with a modified version of |
the Linked Version to produce a modified Combined Work, in the |
manner specified by section 6 of the GNU GPL for conveying |
Corresponding Source. |
1) Use a suitable shared library mechanism for linking with the |
Library. A suitable mechanism is one that (a) uses at run time |
a copy of the Library already present on the user's computer |
system, and (b) will operate properly with a modified version |
of the Library that is interface-compatible with the Linked |
Version. |
e) Provide Installation Information, but only if you would otherwise |
be required to provide such information under section 6 of the |
GNU GPL, and only to the extent that such information is |
necessary to install and execute a modified version of the |
Combined Work produced by recombining or relinking the |
Application with a modified version of the Linked Version. (If |
you use option 4d0, the Installation Information must accompany |
the Minimal Corresponding Source and Corresponding Application |
Code. If you use option 4d1, you must provide the Installation |
Information in the manner specified by section 6 of the GNU GPL |
for conveying Corresponding Source.) |
5. Combined Libraries. |
You may place library facilities that are a work based on the |
Library side by side in a single library together with other library |
facilities that are not Applications and are not covered by this |
License, and convey such a combined library under terms of your |
choice, if you do both of the following: |
a) Accompany the combined library with a copy of the same work based |
on the Library, uncombined with any other library facilities, |
conveyed under the terms of this License. |
b) Give prominent notice with the combined library that part of it |
is a work based on the Library, and explaining where to find the |
accompanying uncombined form of the same work. |
6. Revised Versions of the GNU Lesser General Public License. |
The Free Software Foundation may publish revised and/or new versions |
of the GNU Lesser General Public License from time to time. Such new |
versions will be similar in spirit to the present version, but may |
differ in detail to address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Library as you received it specifies that a certain numbered version |
of the GNU Lesser General Public License "or any later version" |
applies to it, you have the option of following the terms and |
conditions either of that published version or of any later version |
published by the Free Software Foundation. If the Library as you |
received it does not specify a version number of the GNU Lesser |
General Public License, you may choose any version of the GNU Lesser |
General Public License ever published by the Free Software Foundation. |
If the Library as you received it specifies that a proxy can decide |
whether future versions of the GNU Lesser General Public License shall |
apply, that proxy's public statement of acceptance of any version is |
permanent authorization for you to choose that version for the |
Library. |
/trunk/libraries/Eeprom24C32_64/Eeprom24C32_64.cpp |
---|
0,0 → 1,329 |
/**************************************************************************//** |
* \brief EEPROM 24C32 / 24C64 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C32 / 24C64 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file Eeprom24C32_64.cpp |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
#include <Wire.h> |
#include <Eeprom24C32_64.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM__PAGE_SIZE |
* \brief Size of a page in EEPROM memory. |
* This size is given by EEPROM memory datasheet. |
******************************************************************************/ |
#define EEPROM__PAGE_SIZE 32 |
/**************************************************************************//** |
* \def EEPROM__RD_BUFFER_SIZE |
* \brief Size of input TWI buffer. |
* This size is equal to BUFFER_LENGTH defined in Wire library (32 bytes). |
******************************************************************************/ |
#define EEPROM__RD_BUFFER_SIZE BUFFER_LENGTH |
/**************************************************************************//** |
* \def EEPROM__WR_BUFFER_SIZE |
* \brief Size of output TWI buffer. |
* This size is equal to BUFFER_LENGTH - 2 bytes reserved for address. |
******************************************************************************/ |
#define EEPROM__WR_BUFFER_SIZE (BUFFER_LENGTH - 2) |
/****************************************************************************** |
* Public method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn Eeprom24C32_64::Eeprom24C32_64(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
******************************************************************************/ |
Eeprom24C32_64::Eeprom24C32_64 |
( |
byte deviceAddress |
){ |
m_deviceAddress = deviceAddress; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::initialize() |
* |
* \brief Initialize library and TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
******************************************************************************/ |
void |
Eeprom24C32_64::initialize() |
{ |
Wire.begin(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
******************************************************************************/ |
void |
Eeprom24C32_64::writeByte |
( |
word address, |
byte data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.write(data); |
Wire.endTransmission(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
******************************************************************************/ |
void |
Eeprom24C32_64::writeBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
// Write first page if not aligned. |
byte notAlignedLength = 0; |
byte pageOffset = address % EEPROM__PAGE_SIZE; |
if (pageOffset > 0) |
{ |
notAlignedLength = EEPROM__PAGE_SIZE - pageOffset; |
writePage(address, notAlignedLength, p_data); |
length -= notAlignedLength; |
} |
if (length > 0) |
{ |
address += notAlignedLength; |
p_data += notAlignedLength; |
// Write complete and aligned pages. |
byte pageCount = length / EEPROM__PAGE_SIZE; |
for (byte i = 0; i < pageCount; i++) |
{ |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
address += EEPROM__PAGE_SIZE; |
p_data += EEPROM__PAGE_SIZE; |
length -= EEPROM__PAGE_SIZE; |
} |
if (length > 0) |
{ |
// Write remaining uncomplete page. |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
} |
} |
} |
/**************************************************************************//** |
* \fn byte Eeprom24C32_64::readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
******************************************************************************/ |
byte |
Eeprom24C32_64::readByte |
( |
word address |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, (byte)1); |
byte data = 0; |
if (Wire.available()) |
{ |
data = Wire.read(); |
} |
return data; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C32_64::readBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
byte bufferCount = length / EEPROM__RD_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
word offset = i * EEPROM__RD_BUFFER_SIZE; |
readBuffer(address + offset, EEPROM__RD_BUFFER_SIZE, p_data + offset); |
} |
byte remainingBytes = length % EEPROM__RD_BUFFER_SIZE; |
word offset = length - remainingBytes; |
readBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/****************************************************************************** |
* Private method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__PAGE_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C32_64::writePage |
( |
word address, |
byte length, |
byte* p_data |
){ |
// Write complete buffers. |
byte bufferCount = length / EEPROM__WR_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
byte offset = i * EEPROM__WR_BUFFER_SIZE; |
writeBuffer(address + offset, EEPROM__WR_BUFFER_SIZE, p_data + offset); |
} |
// Write remaining bytes. |
byte remainingBytes = length % EEPROM__WR_BUFFER_SIZE; |
byte offset = length - remainingBytes; |
writeBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__WR_BUFFER_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C32_64::writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
for (byte i = 0; i < length; i++) |
{ |
Wire.write(p_data[i]); |
} |
Wire.endTransmission(); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C32_64::readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__RD_BUFFER_SIZE bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C32_64::readBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address >> 8); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, length); |
for (byte i = 0; i < length; i++) |
{ |
if (Wire.available()) |
{ |
p_data[i] = Wire.read(); |
} |
} |
} |
/trunk/libraries/Eeprom24C32_64/Eeprom24C32_64.h |
---|
0,0 → 1,211 |
/**************************************************************************//** |
* \brief EEPROM 24C32 / 24C64 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120203 |
* |
* This file is part of the EEPROM 24C32 / 24C64 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \headerfile Eeprom24C32_64.h |
******************************************************************************/ |
#ifndef Eeprom24C32_64_h |
#define Eeprom24C32_64_h |
/****************************************************************************** |
* Header file inclusion. |
******************************************************************************/ |
#include <Arduino.h> |
/**************************************************************************//** |
* \class Eeprom24C32_64 |
* |
* \brief EEPROM 24C32 / 24C64 memory driver. |
* |
* This driver is designed for 24C32 and 24C64 EEPROM memories. |
******************************************************************************/ |
class Eeprom24C32_64 |
{ |
public: |
/******************************************************************//** |
* \fn Eeprom24C32_64(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
**********************************************************************/ |
Eeprom24C32_64 |
( |
byte deviceAddress |
); |
/******************************************************************//** |
* \fn void initialize() |
* |
* \brief Initialize library abnd TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
**********************************************************************/ |
void |
initialize(); |
/******************************************************************//** |
* \fn void writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
**********************************************************************/ |
void |
writeByte |
( |
word address, |
byte data |
); |
/******************************************************************//** |
* \fn void writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
**********************************************************************/ |
void |
writeBytes |
( |
word address, |
word length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn byte readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
**********************************************************************/ |
byte |
readByte |
( |
word address |
); |
/******************************************************************//** |
* \fn void readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
**********************************************************************/ |
void |
readBytes |
( |
word address, |
word length, |
byte* p_buffer |
); |
private: |
byte m_deviceAddress; |
/******************************************************************//** |
* \fn void writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (64 bytes max). |
* \param[in] p_data Data. |
**********************************************************************/ |
void |
writePage |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (30 bytes max). |
* \param[in] p_date Data. |
**********************************************************************/ |
void |
writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read (32 bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
**********************************************************************/ |
void |
readBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
}; |
#endif // Eeprom24C32_64_h |
/trunk/libraries/Eeprom24C32_64/keywords.txt |
---|
0,0 → 1,30 |
################################################################################ |
# Syntax Coloring Map For Eeprom24C32_64 |
################################################################################ |
################################################################################ |
# Datatypes (KEYWORD1) |
################################################################################ |
################################################################################ |
# Methods and Functions (KEYWORD2) |
################################################################################ |
initialize KEYWORD2 |
writeByte KEYWORD2 |
writeBytes KEYWORD2 |
readByte KEYWORD2 |
readBytes KEYWORD2 |
writePage KEYWORD2 |
writeBuffer KEYWORD2 |
readBuffer KEYWORD2 |
################################################################################ |
# Instances (KEYWORD2) |
################################################################################ |
Eeprom24C32_64 KEYWORD2 |
################################################################################ |
# Constants (LITERAL1) |
################################################################################ |
/trunk/libraries/Eeprom24C32_64/lgpl-3.0.txt |
---|
0,0 → 1,165 |
GNU LESSER GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
This version of the GNU Lesser General Public License incorporates |
the terms and conditions of version 3 of the GNU General Public |
License, supplemented by the additional permissions listed below. |
0. Additional Definitions. |
As used herein, "this License" refers to version 3 of the GNU Lesser |
General Public License, and the "GNU GPL" refers to version 3 of the GNU |
General Public License. |
"The Library" refers to a covered work governed by this License, |
other than an Application or a Combined Work as defined below. |
An "Application" is any work that makes use of an interface provided |
by the Library, but which is not otherwise based on the Library. |
Defining a subclass of a class defined by the Library is deemed a mode |
of using an interface provided by the Library. |
A "Combined Work" is a work produced by combining or linking an |
Application with the Library. The particular version of the Library |
with which the Combined Work was made is also called the "Linked |
Version". |
The "Minimal Corresponding Source" for a Combined Work means the |
Corresponding Source for the Combined Work, excluding any source code |
for portions of the Combined Work that, considered in isolation, are |
based on the Application, and not on the Linked Version. |
The "Corresponding Application Code" for a Combined Work means the |
object code and/or source code for the Application, including any data |
and utility programs needed for reproducing the Combined Work from the |
Application, but excluding the System Libraries of the Combined Work. |
1. Exception to Section 3 of the GNU GPL. |
You may convey a covered work under sections 3 and 4 of this License |
without being bound by section 3 of the GNU GPL. |
2. Conveying Modified Versions. |
If you modify a copy of the Library, and, in your modifications, a |
facility refers to a function or data to be supplied by an Application |
that uses the facility (other than as an argument passed when the |
facility is invoked), then you may convey a copy of the modified |
version: |
a) under this License, provided that you make a good faith effort to |
ensure that, in the event an Application does not supply the |
function or data, the facility still operates, and performs |
whatever part of its purpose remains meaningful, or |
b) under the GNU GPL, with none of the additional permissions of |
this License applicable to that copy. |
3. Object Code Incorporating Material from Library Header Files. |
The object code form of an Application may incorporate material from |
a header file that is part of the Library. You may convey such object |
code under terms of your choice, provided that, if the incorporated |
material is not limited to numerical parameters, data structure |
layouts and accessors, or small macros, inline functions and templates |
(ten or fewer lines in length), you do both of the following: |
a) Give prominent notice with each copy of the object code that the |
Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the object code with a copy of the GNU GPL and this license |
document. |
4. Combined Works. |
You may convey a Combined Work under terms of your choice that, |
taken together, effectively do not restrict modification of the |
portions of the Library contained in the Combined Work and reverse |
engineering for debugging such modifications, if you also do each of |
the following: |
a) Give prominent notice with each copy of the Combined Work that |
the Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the Combined Work with a copy of the GNU GPL and this license |
document. |
c) For a Combined Work that displays copyright notices during |
execution, include the copyright notice for the Library among |
these notices, as well as a reference directing the user to the |
copies of the GNU GPL and this license document. |
d) Do one of the following: |
0) Convey the Minimal Corresponding Source under the terms of this |
License, and the Corresponding Application Code in a form |
suitable for, and under terms that permit, the user to |
recombine or relink the Application with a modified version of |
the Linked Version to produce a modified Combined Work, in the |
manner specified by section 6 of the GNU GPL for conveying |
Corresponding Source. |
1) Use a suitable shared library mechanism for linking with the |
Library. A suitable mechanism is one that (a) uses at run time |
a copy of the Library already present on the user's computer |
system, and (b) will operate properly with a modified version |
of the Library that is interface-compatible with the Linked |
Version. |
e) Provide Installation Information, but only if you would otherwise |
be required to provide such information under section 6 of the |
GNU GPL, and only to the extent that such information is |
necessary to install and execute a modified version of the |
Combined Work produced by recombining or relinking the |
Application with a modified version of the Linked Version. (If |
you use option 4d0, the Installation Information must accompany |
the Minimal Corresponding Source and Corresponding Application |
Code. If you use option 4d1, you must provide the Installation |
Information in the manner specified by section 6 of the GNU GPL |
for conveying Corresponding Source.) |
5. Combined Libraries. |
You may place library facilities that are a work based on the |
Library side by side in a single library together with other library |
facilities that are not Applications and are not covered by this |
License, and convey such a combined library under terms of your |
choice, if you do both of the following: |
a) Accompany the combined library with a copy of the same work based |
on the Library, uncombined with any other library facilities, |
conveyed under the terms of this License. |
b) Give prominent notice with the combined library that part of it |
is a work based on the Library, and explaining where to find the |
accompanying uncombined form of the same work. |
6. Revised Versions of the GNU Lesser General Public License. |
The Free Software Foundation may publish revised and/or new versions |
of the GNU Lesser General Public License from time to time. Such new |
versions will be similar in spirit to the present version, but may |
differ in detail to address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Library as you received it specifies that a certain numbered version |
of the GNU Lesser General Public License "or any later version" |
applies to it, you have the option of following the terms and |
conditions either of that published version or of any later version |
published by the Free Software Foundation. If the Library as you |
received it does not specify a version number of the GNU Lesser |
General Public License, you may choose any version of the GNU Lesser |
General Public License ever published by the Free Software Foundation. |
If the Library as you received it specifies that a proxy can decide |
whether future versions of the GNU Lesser General Public License shall |
apply, that proxy's public statement of acceptance of any version is |
permanent authorization for you to choose that version for the |
Library. |
/trunk/libraries/Eeprom24C32_64/examples/WriteReadByte/WriteReadByte.ino |
---|
0,0 → 1,93 |
/**************************************************************************//** |
* \brief EEPROM 24C32 / 24C64 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C32 / 24C64 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadByte.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C32_64.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C32_64 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initialize EEPROM library. |
eeprom.initialize(); |
// Write a byte at address 0 in EEPROM memory. |
Serial.println("Write byte to EEPROM memory..."); |
eeprom.writeByte(0, 0xAA); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
// Read a byte at address 0 in EEPROM memory. |
Serial.println("Read byte from EEPROM memory..."); |
byte data = eeprom.readByte(0); |
// Print read byte. |
Serial.print("Read byte = 0x"); |
Serial.print(data, HEX); |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C32_64/examples/WriteReadBytes/WriteReadBytes.ino |
---|
0,0 → 1,105 |
/**************************************************************************//** |
* \brief EEPROM 24C32 / 24C64 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C32 / 24C64 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadBytes.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C32_64.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C32_64 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initiliaze EEPROM library. |
eeprom.initialize(); |
// Declare byte arrays. |
byte inputBytes[94] = { 0 }; |
byte outputBytes[94] = { 0 }; |
// Fill input array with printable characters. See ASCII table for more |
// details. |
for (byte i = 0; i < 94; i++) |
{ |
inputBytes[i] = i + 33; |
} |
// Write input array to EEPROM memory. |
Serial.println("Write bytes to EEPROM memory..."); |
eeprom.writeBytes(0, 94, inputBytes); |
// Read array with bytes read from EEPROM memory. |
Serial.println("Read bytes from EEPROM memory..."); |
eeprom.readBytes(0, 94, outputBytes); |
// Print read bytes. |
Serial.println("Read bytes:"); |
for (byte i = 0; i < 94; i++) |
{ |
Serial.write(outputBytes[i]); |
Serial.print(" "); |
} |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C04_16/Eeprom24C04_16.cpp |
---|
0,0 → 1,325 |
/**************************************************************************//** |
* \brief EEPROM 24C04 / 24C16 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C04 / 24C16 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file Eeprom24C04_16.cpp |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
#include <Wire.h> |
#include <Eeprom24C04_16.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM__PAGE_SIZE |
* \brief Size of a page in EEPROM memory. |
* This size is given by EEPROM memory datasheet. |
******************************************************************************/ |
#define EEPROM__PAGE_SIZE 16 |
/**************************************************************************//** |
* \def EEPROM__RD_BUFFER_SIZE |
* \brief Size of input TWI buffer. |
* This size is equal to BUFFER_LENGTH defined in Wire library (32 bytes). |
******************************************************************************/ |
#define EEPROM__RD_BUFFER_SIZE BUFFER_LENGTH |
/**************************************************************************//** |
* \def EEPROM__WR_BUFFER_SIZE |
* \brief Size of output TWI buffer. |
* This size is equal to BUFFER_LENGTH - 1 byte reserved for address. |
******************************************************************************/ |
#define EEPROM__WR_BUFFER_SIZE (BUFFER_LENGTH - 1) |
/****************************************************************************** |
* Public method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn Eeprom24C04_16::Eeprom24C04_16(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
******************************************************************************/ |
Eeprom24C04_16::Eeprom24C04_16 |
( |
byte deviceAddress |
){ |
m_deviceAddress = deviceAddress; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::initialize() |
* |
* \brief Initialize library and TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
******************************************************************************/ |
void |
Eeprom24C04_16::initialize() |
{ |
Wire.begin(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
******************************************************************************/ |
void |
Eeprom24C04_16::writeByte |
( |
word address, |
byte data |
){ |
Wire.beginTransmission((byte)(m_deviceAddress | ((address >> 8) & 0x07))); |
Wire.write(address & 0xFF); |
Wire.write(data); |
Wire.endTransmission(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
******************************************************************************/ |
void |
Eeprom24C04_16::writeBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
// Write first page if not aligned. |
byte notAlignedLength = 0; |
byte pageOffset = address % EEPROM__PAGE_SIZE; |
if (pageOffset > 0) |
{ |
notAlignedLength = EEPROM__PAGE_SIZE - pageOffset; |
writePage(address, notAlignedLength, p_data); |
length -= notAlignedLength; |
} |
if (length > 0) |
{ |
address += notAlignedLength; |
p_data += notAlignedLength; |
// Write complete and aligned pages. |
byte pageCount = length / EEPROM__PAGE_SIZE; |
for (byte i = 0; i < pageCount; i++) |
{ |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
address += EEPROM__PAGE_SIZE; |
p_data += EEPROM__PAGE_SIZE; |
length -= EEPROM__PAGE_SIZE; |
} |
if (length > 0) |
{ |
// Write remaining uncomplete page. |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
} |
} |
} |
/**************************************************************************//** |
* \fn byte Eeprom24C04_16::readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
******************************************************************************/ |
byte |
Eeprom24C04_16::readByte |
( |
word address |
){ |
Wire.beginTransmission((byte)(m_deviceAddress | ((address >> 8) & 0x07))); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom((byte)(m_deviceAddress | ((address >> 8) & 0x07)), (byte)1); |
byte data = 0; |
if (Wire.available()) |
{ |
data = Wire.read(); |
} |
return data; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C04_16::readBytes |
( |
word address, |
word length, |
byte* p_data |
){ |
byte bufferCount = length / EEPROM__RD_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
word offset = i * EEPROM__RD_BUFFER_SIZE; |
readBuffer(address + offset, EEPROM__RD_BUFFER_SIZE, p_data + offset); |
} |
byte remainingBytes = length % EEPROM__RD_BUFFER_SIZE; |
word offset = length - remainingBytes; |
readBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/****************************************************************************** |
* Private method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__PAGE_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C04_16::writePage |
( |
word address, |
byte length, |
byte* p_data |
){ |
// Write complete buffers. |
byte bufferCount = length / EEPROM__WR_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
byte offset = i * EEPROM__WR_BUFFER_SIZE; |
writeBuffer(address + offset, EEPROM__WR_BUFFER_SIZE, p_data + offset); |
} |
// Write remaining bytes. |
byte remainingBytes = length % EEPROM__WR_BUFFER_SIZE; |
byte offset = length - remainingBytes; |
writeBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__WR_BUFFER_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C04_16::writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission((byte)(m_deviceAddress | ((address >> 8) & 0x07))); |
Wire.write(address & 0xFF); |
for (byte i = 0; i < length; i++) |
{ |
Wire.write(p_data[i]); |
} |
Wire.endTransmission(); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C04_16::readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__RD_BUFFER_SIZE bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C04_16::readBuffer |
( |
word address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission((byte)(m_deviceAddress | ((address >> 8) & 0x07))); |
Wire.write(address & 0xFF); |
Wire.endTransmission(); |
Wire.requestFrom((byte)(m_deviceAddress | ((address >> 8) & 0x07)), length); |
for (byte i = 0; i < length; i++) |
{ |
if (Wire.available()) |
{ |
p_data[i] = Wire.read(); |
} |
} |
} |
/trunk/libraries/Eeprom24C04_16/Eeprom24C04_16.h |
---|
0,0 → 1,211 |
/**************************************************************************//** |
* \brief EEPROM 24C04 / 24C16 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C04 / 24C16 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \headerfile Eeprom24C04_16.h |
******************************************************************************/ |
#ifndef Eeprom24C04_16_h |
#define Eeprom24C04_16_h |
/****************************************************************************** |
* Header file inclusion. |
******************************************************************************/ |
#include <Arduino.h> |
/**************************************************************************//** |
* \class Eeprom24C04_16 |
* |
* \brief EEPROM 24C04 / 24C16 memory driver. |
* |
* This driver is mainly designed for 24C04 and 24C16 EEPROM memories. |
******************************************************************************/ |
class Eeprom24C04_16 |
{ |
public: |
/******************************************************************//** |
* \fn Eeprom24C04_16(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
**********************************************************************/ |
Eeprom24C04_16 |
( |
byte deviceAddress |
); |
/******************************************************************//** |
* \fn void initialize() |
* |
* \brief Initialize library abnd TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
**********************************************************************/ |
void |
initialize(); |
/******************************************************************//** |
* \fn void writeByte( |
* word address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
**********************************************************************/ |
void |
writeByte |
( |
word address, |
byte data |
); |
/******************************************************************//** |
* \fn void writeBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
**********************************************************************/ |
void |
writeBytes |
( |
word address, |
word length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn byte readByte(word address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
**********************************************************************/ |
byte |
readByte |
( |
word address |
); |
/******************************************************************//** |
* \fn void readBytes( |
* word address, |
* word length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
**********************************************************************/ |
void |
readBytes |
( |
word address, |
word length, |
byte* p_buffer |
); |
private: |
byte m_deviceAddress; |
/******************************************************************//** |
* \fn void writePage( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (64 bytes max). |
* \param[in] p_data Data. |
**********************************************************************/ |
void |
writePage |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void writeBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (30 bytes max). |
* \param[in] p_date Data. |
**********************************************************************/ |
void |
writeBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void readBuffer( |
* word address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read (32 bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
**********************************************************************/ |
void |
readBuffer |
( |
word address, |
byte length, |
byte* p_data |
); |
}; |
#endif // Eeprom24C04_16_h |
/trunk/libraries/Eeprom24C04_16/keywords.txt |
---|
0,0 → 1,30 |
################################################################################ |
# Syntax Coloring Map For Eeprom24C04_16 |
################################################################################ |
################################################################################ |
# Datatypes (KEYWORD1) |
################################################################################ |
################################################################################ |
# Methods and Functions (KEYWORD2) |
################################################################################ |
initialize KEYWORD2 |
writeByte KEYWORD2 |
writeBytes KEYWORD2 |
readByte KEYWORD2 |
readBytes KEYWORD2 |
writePage KEYWORD2 |
writeBuffer KEYWORD2 |
readBuffer KEYWORD2 |
################################################################################ |
# Instances (KEYWORD2) |
################################################################################ |
Eeprom24C04_16 KEYWORD2 |
################################################################################ |
# Constants (LITERAL1) |
################################################################################ |
/trunk/libraries/Eeprom24C04_16/lgpl-3.0.txt |
---|
0,0 → 1,165 |
GNU LESSER GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
This version of the GNU Lesser General Public License incorporates |
the terms and conditions of version 3 of the GNU General Public |
License, supplemented by the additional permissions listed below. |
0. Additional Definitions. |
As used herein, "this License" refers to version 3 of the GNU Lesser |
General Public License, and the "GNU GPL" refers to version 3 of the GNU |
General Public License. |
"The Library" refers to a covered work governed by this License, |
other than an Application or a Combined Work as defined below. |
An "Application" is any work that makes use of an interface provided |
by the Library, but which is not otherwise based on the Library. |
Defining a subclass of a class defined by the Library is deemed a mode |
of using an interface provided by the Library. |
A "Combined Work" is a work produced by combining or linking an |
Application with the Library. The particular version of the Library |
with which the Combined Work was made is also called the "Linked |
Version". |
The "Minimal Corresponding Source" for a Combined Work means the |
Corresponding Source for the Combined Work, excluding any source code |
for portions of the Combined Work that, considered in isolation, are |
based on the Application, and not on the Linked Version. |
The "Corresponding Application Code" for a Combined Work means the |
object code and/or source code for the Application, including any data |
and utility programs needed for reproducing the Combined Work from the |
Application, but excluding the System Libraries of the Combined Work. |
1. Exception to Section 3 of the GNU GPL. |
You may convey a covered work under sections 3 and 4 of this License |
without being bound by section 3 of the GNU GPL. |
2. Conveying Modified Versions. |
If you modify a copy of the Library, and, in your modifications, a |
facility refers to a function or data to be supplied by an Application |
that uses the facility (other than as an argument passed when the |
facility is invoked), then you may convey a copy of the modified |
version: |
a) under this License, provided that you make a good faith effort to |
ensure that, in the event an Application does not supply the |
function or data, the facility still operates, and performs |
whatever part of its purpose remains meaningful, or |
b) under the GNU GPL, with none of the additional permissions of |
this License applicable to that copy. |
3. Object Code Incorporating Material from Library Header Files. |
The object code form of an Application may incorporate material from |
a header file that is part of the Library. You may convey such object |
code under terms of your choice, provided that, if the incorporated |
material is not limited to numerical parameters, data structure |
layouts and accessors, or small macros, inline functions and templates |
(ten or fewer lines in length), you do both of the following: |
a) Give prominent notice with each copy of the object code that the |
Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the object code with a copy of the GNU GPL and this license |
document. |
4. Combined Works. |
You may convey a Combined Work under terms of your choice that, |
taken together, effectively do not restrict modification of the |
portions of the Library contained in the Combined Work and reverse |
engineering for debugging such modifications, if you also do each of |
the following: |
a) Give prominent notice with each copy of the Combined Work that |
the Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the Combined Work with a copy of the GNU GPL and this license |
document. |
c) For a Combined Work that displays copyright notices during |
execution, include the copyright notice for the Library among |
these notices, as well as a reference directing the user to the |
copies of the GNU GPL and this license document. |
d) Do one of the following: |
0) Convey the Minimal Corresponding Source under the terms of this |
License, and the Corresponding Application Code in a form |
suitable for, and under terms that permit, the user to |
recombine or relink the Application with a modified version of |
the Linked Version to produce a modified Combined Work, in the |
manner specified by section 6 of the GNU GPL for conveying |
Corresponding Source. |
1) Use a suitable shared library mechanism for linking with the |
Library. A suitable mechanism is one that (a) uses at run time |
a copy of the Library already present on the user's computer |
system, and (b) will operate properly with a modified version |
of the Library that is interface-compatible with the Linked |
Version. |
e) Provide Installation Information, but only if you would otherwise |
be required to provide such information under section 6 of the |
GNU GPL, and only to the extent that such information is |
necessary to install and execute a modified version of the |
Combined Work produced by recombining or relinking the |
Application with a modified version of the Linked Version. (If |
you use option 4d0, the Installation Information must accompany |
the Minimal Corresponding Source and Corresponding Application |
Code. If you use option 4d1, you must provide the Installation |
Information in the manner specified by section 6 of the GNU GPL |
for conveying Corresponding Source.) |
5. Combined Libraries. |
You may place library facilities that are a work based on the |
Library side by side in a single library together with other library |
facilities that are not Applications and are not covered by this |
License, and convey such a combined library under terms of your |
choice, if you do both of the following: |
a) Accompany the combined library with a copy of the same work based |
on the Library, uncombined with any other library facilities, |
conveyed under the terms of this License. |
b) Give prominent notice with the combined library that part of it |
is a work based on the Library, and explaining where to find the |
accompanying uncombined form of the same work. |
6. Revised Versions of the GNU Lesser General Public License. |
The Free Software Foundation may publish revised and/or new versions |
of the GNU Lesser General Public License from time to time. Such new |
versions will be similar in spirit to the present version, but may |
differ in detail to address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Library as you received it specifies that a certain numbered version |
of the GNU Lesser General Public License "or any later version" |
applies to it, you have the option of following the terms and |
conditions either of that published version or of any later version |
published by the Free Software Foundation. If the Library as you |
received it does not specify a version number of the GNU Lesser |
General Public License, you may choose any version of the GNU Lesser |
General Public License ever published by the Free Software Foundation. |
If the Library as you received it specifies that a proxy can decide |
whether future versions of the GNU Lesser General Public License shall |
apply, that proxy's public statement of acceptance of any version is |
permanent authorization for you to choose that version for the |
Library. |
/trunk/libraries/Eeprom24C04_16/examples/WriteReadByte/WriteReadByte.ino |
---|
0,0 → 1,93 |
/**************************************************************************//** |
* \brief EEPROM 24C04 / 24C16 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C04 / 24C16 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadByte.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C04_16.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C04_16 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initialize EEPROM library. |
eeprom.initialize(); |
// Write a byte at address 0 in EEPROM memory. |
Serial.println("Write byte to EEPROM memory..."); |
eeprom.writeByte(0, 0xAA); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
// Read a byte at address 0 in EEPROM memory. |
Serial.println("Read byte from EEPROM memory..."); |
byte data = eeprom.readByte(0); |
// Print read byte. |
Serial.print("Read byte = 0x"); |
Serial.print(data, HEX); |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C04_16/examples/WriteReadBytes/WriteReadBytes.ino |
---|
0,0 → 1,105 |
/**************************************************************************//** |
* \brief EEPROM 24C04 / 24C16 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120218 |
* |
* This file is part of the EEPROM 24C04 / 24C16 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadBytes.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C04_16.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C04_16 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initiliaze EEPROM library. |
eeprom.initialize(); |
// Declare byte arrays. |
byte inputBytes[94] = { 0 }; |
byte outputBytes[94] = { 0 }; |
// Fill input array with printable characters. See ASCII table for more |
// details. |
for (byte i = 0; i < 94; i++) |
{ |
inputBytes[i] = i + 33; |
} |
// Write input array to EEPROM memory. |
Serial.println("Write bytes to EEPROM memory..."); |
eeprom.writeBytes(0, 94, inputBytes); |
// Read array with bytes read from EEPROM memory. |
Serial.println("Read bytes from EEPROM memory..."); |
eeprom.readBytes(0, 94, outputBytes); |
// Print read bytes. |
Serial.println("Read bytes:"); |
for (byte i = 0; i < 94; i++) |
{ |
Serial.write(outputBytes[i]); |
Serial.print(" "); |
} |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C01_02/Eeprom24C01_02.cpp |
---|
0,0 → 1,326 |
/**************************************************************************//** |
* \brief EEPROM 24C01 / 24C02 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120217 |
* |
* This file is part of the EEPROM 24C01 / 24C02 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file Eeprom24C01_02.cpp |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
#include <Wire.h> |
#include <Eeprom24C01_02.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM__PAGE_SIZE |
* \brief Size of a page in EEPROM memory. |
* This size is given by EEPROM memory datasheet. |
******************************************************************************/ |
#define EEPROM__PAGE_SIZE 8 |
/**************************************************************************//** |
* \def EEPROM__RD_BUFFER_SIZE |
* \brief Size of input TWI buffer. |
* This size is equal to BUFFER_LENGTH defined in Wire library (32 bytes). |
******************************************************************************/ |
#define EEPROM__RD_BUFFER_SIZE BUFFER_LENGTH |
/**************************************************************************//** |
* \def EEPROM__WR_BUFFER_SIZE |
* \brief Size of output TWI buffer. |
* This size is equal to BUFFER_LENGTH - 1 byte reserved for address. |
******************************************************************************/ |
#define EEPROM__WR_BUFFER_SIZE (BUFFER_LENGTH - 1) |
/****************************************************************************** |
* Public method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn Eeprom24C01_02::Eeprom24C01_02(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
******************************************************************************/ |
Eeprom24C01_02::Eeprom24C01_02 |
( |
byte deviceAddress |
){ |
m_deviceAddress = deviceAddress; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::initialize() |
* |
* \brief Initialize library and TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
******************************************************************************/ |
void |
Eeprom24C01_02::initialize() |
{ |
Wire.begin(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::writeByte( |
* byte address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
******************************************************************************/ |
void |
Eeprom24C01_02::writeByte |
( |
byte address, |
byte data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address); |
Wire.write(data); |
Wire.endTransmission(); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::writeBytes( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
******************************************************************************/ |
void |
Eeprom24C01_02::writeBytes |
( |
byte address, |
byte length, |
byte* p_data |
){ |
// Write first page if not aligned. |
byte notAlignedLength = 0; |
byte pageOffset = address % EEPROM__PAGE_SIZE; |
if (pageOffset > 0) |
{ |
notAlignedLength = EEPROM__PAGE_SIZE - pageOffset; |
writePage(address, notAlignedLength, p_data); |
length -= notAlignedLength; |
} |
if (length > 0) |
{ |
address += notAlignedLength; |
p_data += notAlignedLength; |
// Write complete and aligned pages. |
byte pageCount = length / EEPROM__PAGE_SIZE; |
for (byte i = 0; i < pageCount; i++) |
{ |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
address += EEPROM__PAGE_SIZE; |
p_data += EEPROM__PAGE_SIZE; |
length -= EEPROM__PAGE_SIZE; |
} |
if (length > 0) |
{ |
// Write remaining uncomplete page. |
writePage(address, EEPROM__PAGE_SIZE, p_data); |
} |
} |
} |
/**************************************************************************//** |
* \fn byte Eeprom24C01_02::readByte(byte address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
******************************************************************************/ |
byte |
Eeprom24C01_02::readByte |
( |
byte address |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, (byte)1); |
byte data = 0; |
if (Wire.available()) |
{ |
data = Wire.read(); |
} |
return data; |
} |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::readBytes( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C01_02::readBytes |
( |
byte address, |
byte length, |
byte* p_data |
){ |
byte bufferCount = length / EEPROM__RD_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
byte offset = i * EEPROM__RD_BUFFER_SIZE; |
readBuffer(address + offset, EEPROM__RD_BUFFER_SIZE, p_data + offset); |
} |
byte remainingBytes = length % EEPROM__RD_BUFFER_SIZE; |
byte offset = length - remainingBytes; |
readBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/****************************************************************************** |
* Private method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::writePage( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__PAGE_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C01_02::writePage |
( |
byte address, |
byte length, |
byte* p_data |
){ |
// Write complete buffers. |
byte bufferCount = length / EEPROM__WR_BUFFER_SIZE; |
for (byte i = 0; i < bufferCount; i++) |
{ |
byte offset = i * EEPROM__WR_BUFFER_SIZE; |
writeBuffer(address + offset, EEPROM__WR_BUFFER_SIZE, p_data + offset); |
} |
// Write remaining bytes. |
byte remainingBytes = length % EEPROM__WR_BUFFER_SIZE; |
byte offset = length - remainingBytes; |
writeBuffer(address + offset, remainingBytes, p_data + offset); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::writeBuffer( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__WR_BUFFER_SIZE bytes max). |
* \param[in] p_data Data. |
******************************************************************************/ |
void |
Eeprom24C01_02::writeBuffer |
( |
byte address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address); |
for (byte i = 0; i < length; i++) |
{ |
Wire.write(p_data[i]); |
} |
Wire.endTransmission(); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
} |
/**************************************************************************//** |
* \fn void Eeprom24C01_02::readBuffer( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes (EEPROM__RD_BUFFER_SIZE bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
******************************************************************************/ |
void |
Eeprom24C01_02::readBuffer |
( |
byte address, |
byte length, |
byte* p_data |
){ |
Wire.beginTransmission(m_deviceAddress); |
Wire.write(address); |
Wire.endTransmission(); |
Wire.requestFrom(m_deviceAddress, length); |
for (byte i = 0; i < length; i++) |
{ |
if (Wire.available()) |
{ |
p_data[i] = Wire.read(); |
} |
} |
} |
/trunk/libraries/Eeprom24C01_02/keywords.txt |
---|
0,0 → 1,30 |
################################################################################ |
# Syntax Coloring Map For Eeprom24C01_02 |
################################################################################ |
################################################################################ |
# Datatypes (KEYWORD1) |
################################################################################ |
################################################################################ |
# Methods and Functions (KEYWORD2) |
################################################################################ |
initialize KEYWORD2 |
writeByte KEYWORD2 |
writeBytes KEYWORD2 |
readByte KEYWORD2 |
readBytes KEYWORD2 |
writePage KEYWORD2 |
writeBuffer KEYWORD2 |
readBuffer KEYWORD2 |
################################################################################ |
# Instances (KEYWORD2) |
################################################################################ |
Eeprom24C01_02 KEYWORD2 |
################################################################################ |
# Constants (LITERAL1) |
################################################################################ |
/trunk/libraries/Eeprom24C01_02/Eeprom24C01_02.h |
---|
0,0 → 1,211 |
/**************************************************************************//** |
* \brief EEPROM 24C01 / 24C02 library for Arduino |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120217 |
* |
* This file is part of the EEPROM 24C01 / 24C02 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \headerfile Eeprom24C01_02.h |
******************************************************************************/ |
#ifndef Eeprom24C01_02_h |
#define Eeprom24C01_02_h |
/****************************************************************************** |
* Header file inclusion. |
******************************************************************************/ |
#include <Arduino.h> |
/**************************************************************************//** |
* \class Eeprom24C01_02 |
* |
* \brief EEPROM 24C01 / 24C02 memory driver. |
* |
* This driver is designed for 24C01 and 24C02 EEPROM memories. |
******************************************************************************/ |
class Eeprom24C01_02 |
{ |
public: |
/******************************************************************//** |
* \fn Eeprom24C01_02(byte deviceAddress) |
* |
* \brief Constructor. |
* |
* \param deviceAddress EEPROM address on TWI bus. |
**********************************************************************/ |
Eeprom24C01_02 |
( |
byte deviceAddress |
); |
/******************************************************************//** |
* \fn void initialize() |
* |
* \brief Initialize library abnd TWI bus. |
* |
* If several devices are connected to TWI bus, this method mustn't be |
* called. TWI bus must be initialized out of this library using |
* Wire.begin() method. |
**********************************************************************/ |
void |
initialize(); |
/******************************************************************//** |
* \fn void writeByte( |
* byte address, |
* byte data) |
* |
* \brief Write a byte in EEPROM memory. |
* |
* \remarks A delay of 10 ms is required after write cycle. |
* |
* \param address Address. |
* \param data Byte to write. |
**********************************************************************/ |
void |
writeByte |
( |
byte address, |
byte data |
); |
/******************************************************************//** |
* \fn void writeBytes( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to write. |
* \param[in] p_data Bytes to write. |
**********************************************************************/ |
void |
writeBytes |
( |
byte address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn byte readByte(byte address) |
* |
* \brief Read a byte in EEPROM memory. |
* |
* \param address Address. |
* |
* \return Read byte. |
**********************************************************************/ |
byte |
readByte |
( |
byte address |
); |
/******************************************************************//** |
* \fn void readBytes( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read. |
* \patam[in] p_data Byte array to fill with read bytes. |
**********************************************************************/ |
void |
readBytes |
( |
byte address, |
byte length, |
byte* p_buffer |
); |
private: |
byte m_deviceAddress; |
/******************************************************************//** |
* \fn void writePage( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write page in EEPROM memory. |
* |
* \param address Start address. |
* \param length Number of bytes (64 bytes max). |
* \param[in] p_data Data. |
**********************************************************************/ |
void |
writePage |
( |
byte address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void writeBuffer( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Write bytes into memory. |
* |
* \param address Start address. |
* \param length Number of bytes (30 bytes max). |
* \param[in] p_date Data. |
**********************************************************************/ |
void |
writeBuffer |
( |
byte address, |
byte length, |
byte* p_data |
); |
/******************************************************************//** |
* \fn void readBuffer( |
* byte address, |
* byte length, |
* byte* p_data) |
* |
* \brief Read bytes in memory. |
* |
* \param address Start address. |
* \param length Number of bytes to read (32 bytes max). |
* \param[in] p_data Buffer to fill with read bytes. |
**********************************************************************/ |
void |
readBuffer |
( |
byte address, |
byte length, |
byte* p_data |
); |
}; |
#endif // Eeprom24C01_02_h |
/trunk/libraries/Eeprom24C01_02/lgpl-3.0.txt |
---|
0,0 → 1,165 |
GNU LESSER GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
This version of the GNU Lesser General Public License incorporates |
the terms and conditions of version 3 of the GNU General Public |
License, supplemented by the additional permissions listed below. |
0. Additional Definitions. |
As used herein, "this License" refers to version 3 of the GNU Lesser |
General Public License, and the "GNU GPL" refers to version 3 of the GNU |
General Public License. |
"The Library" refers to a covered work governed by this License, |
other than an Application or a Combined Work as defined below. |
An "Application" is any work that makes use of an interface provided |
by the Library, but which is not otherwise based on the Library. |
Defining a subclass of a class defined by the Library is deemed a mode |
of using an interface provided by the Library. |
A "Combined Work" is a work produced by combining or linking an |
Application with the Library. The particular version of the Library |
with which the Combined Work was made is also called the "Linked |
Version". |
The "Minimal Corresponding Source" for a Combined Work means the |
Corresponding Source for the Combined Work, excluding any source code |
for portions of the Combined Work that, considered in isolation, are |
based on the Application, and not on the Linked Version. |
The "Corresponding Application Code" for a Combined Work means the |
object code and/or source code for the Application, including any data |
and utility programs needed for reproducing the Combined Work from the |
Application, but excluding the System Libraries of the Combined Work. |
1. Exception to Section 3 of the GNU GPL. |
You may convey a covered work under sections 3 and 4 of this License |
without being bound by section 3 of the GNU GPL. |
2. Conveying Modified Versions. |
If you modify a copy of the Library, and, in your modifications, a |
facility refers to a function or data to be supplied by an Application |
that uses the facility (other than as an argument passed when the |
facility is invoked), then you may convey a copy of the modified |
version: |
a) under this License, provided that you make a good faith effort to |
ensure that, in the event an Application does not supply the |
function or data, the facility still operates, and performs |
whatever part of its purpose remains meaningful, or |
b) under the GNU GPL, with none of the additional permissions of |
this License applicable to that copy. |
3. Object Code Incorporating Material from Library Header Files. |
The object code form of an Application may incorporate material from |
a header file that is part of the Library. You may convey such object |
code under terms of your choice, provided that, if the incorporated |
material is not limited to numerical parameters, data structure |
layouts and accessors, or small macros, inline functions and templates |
(ten or fewer lines in length), you do both of the following: |
a) Give prominent notice with each copy of the object code that the |
Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the object code with a copy of the GNU GPL and this license |
document. |
4. Combined Works. |
You may convey a Combined Work under terms of your choice that, |
taken together, effectively do not restrict modification of the |
portions of the Library contained in the Combined Work and reverse |
engineering for debugging such modifications, if you also do each of |
the following: |
a) Give prominent notice with each copy of the Combined Work that |
the Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the Combined Work with a copy of the GNU GPL and this license |
document. |
c) For a Combined Work that displays copyright notices during |
execution, include the copyright notice for the Library among |
these notices, as well as a reference directing the user to the |
copies of the GNU GPL and this license document. |
d) Do one of the following: |
0) Convey the Minimal Corresponding Source under the terms of this |
License, and the Corresponding Application Code in a form |
suitable for, and under terms that permit, the user to |
recombine or relink the Application with a modified version of |
the Linked Version to produce a modified Combined Work, in the |
manner specified by section 6 of the GNU GPL for conveying |
Corresponding Source. |
1) Use a suitable shared library mechanism for linking with the |
Library. A suitable mechanism is one that (a) uses at run time |
a copy of the Library already present on the user's computer |
system, and (b) will operate properly with a modified version |
of the Library that is interface-compatible with the Linked |
Version. |
e) Provide Installation Information, but only if you would otherwise |
be required to provide such information under section 6 of the |
GNU GPL, and only to the extent that such information is |
necessary to install and execute a modified version of the |
Combined Work produced by recombining or relinking the |
Application with a modified version of the Linked Version. (If |
you use option 4d0, the Installation Information must accompany |
the Minimal Corresponding Source and Corresponding Application |
Code. If you use option 4d1, you must provide the Installation |
Information in the manner specified by section 6 of the GNU GPL |
for conveying Corresponding Source.) |
5. Combined Libraries. |
You may place library facilities that are a work based on the |
Library side by side in a single library together with other library |
facilities that are not Applications and are not covered by this |
License, and convey such a combined library under terms of your |
choice, if you do both of the following: |
a) Accompany the combined library with a copy of the same work based |
on the Library, uncombined with any other library facilities, |
conveyed under the terms of this License. |
b) Give prominent notice with the combined library that part of it |
is a work based on the Library, and explaining where to find the |
accompanying uncombined form of the same work. |
6. Revised Versions of the GNU Lesser General Public License. |
The Free Software Foundation may publish revised and/or new versions |
of the GNU Lesser General Public License from time to time. Such new |
versions will be similar in spirit to the present version, but may |
differ in detail to address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Library as you received it specifies that a certain numbered version |
of the GNU Lesser General Public License "or any later version" |
applies to it, you have the option of following the terms and |
conditions either of that published version or of any later version |
published by the Free Software Foundation. If the Library as you |
received it does not specify a version number of the GNU Lesser |
General Public License, you may choose any version of the GNU Lesser |
General Public License ever published by the Free Software Foundation. |
If the Library as you received it specifies that a proxy can decide |
whether future versions of the GNU Lesser General Public License shall |
apply, that proxy's public statement of acceptance of any version is |
permanent authorization for you to choose that version for the |
Library. |
/trunk/libraries/Eeprom24C01_02/examples/WriteReadByte/WriteReadByte.ino |
---|
0,0 → 1,93 |
/**************************************************************************//** |
* \brief EEPROM 24C01 / 24C02 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120217 |
* |
* This file is part of the EEPROM 24C01 / 24C02 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadByte.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C01_02.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C01_02 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initialize EEPROM library. |
eeprom.initialize(); |
// Write a byte at address 0 in EEPROM memory. |
Serial.println("Write byte to EEPROM memory..."); |
eeprom.writeByte(0, 0xAA); |
// Write cycle time (tWR). See EEPROM memory datasheet for more details. |
delay(10); |
// Read a byte at address 0 in EEPROM memory. |
Serial.println("Read byte from EEPROM memory..."); |
byte data = eeprom.readByte(0); |
// Print read byte. |
Serial.print("Read byte = 0x"); |
Serial.print(data, HEX); |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/Eeprom24C01_02/examples/WriteReadBytes/WriteReadBytes.ino |
---|
0,0 → 1,105 |
/**************************************************************************//** |
* \brief EEPROM 24C01 / 24C02 library for Arduino - Demonstration program |
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20120217 |
* |
* This file is part of the EEPROM 24C01 / 24C02 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file WriteReadBytes.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Wire.h> |
#include <Eeprom24C01_02.h> |
/****************************************************************************** |
* Private macro definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \def EEPROM_ADDRESS |
* \brief Address of EEPROM memory on TWI bus. |
******************************************************************************/ |
#define EEPROM_ADDRESS 0x50 |
/****************************************************************************** |
* Private variable definitions. |
******************************************************************************/ |
static Eeprom24C01_02 eeprom(EEPROM_ADDRESS); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
* |
* \brief |
******************************************************************************/ |
void setup() |
{ |
// Initialize serial communication. |
Serial.begin(9600); |
// Initiliaze EEPROM library. |
eeprom.initialize(); |
// Declare byte arrays. |
byte inputBytes[94] = { 0 }; |
byte outputBytes[94] = { 0 }; |
// Fill input array with printable characters. See ASCII table for more |
// details. |
for (byte i = 0; i < 94; i++) |
{ |
inputBytes[i] = i + 33; |
} |
// Write input array to EEPROM memory. |
Serial.println("Write bytes to EEPROM memory..."); |
eeprom.writeBytes(0, 94, inputBytes); |
// Read array with bytes read from EEPROM memory. |
Serial.println("Read bytes from EEPROM memory..."); |
eeprom.readBytes(0, 94, outputBytes); |
// Print read bytes. |
Serial.println("Read bytes:"); |
for (byte i = 0; i < 94; i++) |
{ |
Serial.write(outputBytes[i]); |
Serial.print(" "); |
} |
Serial.println(""); |
} |
/**************************************************************************//** |
* \fn void loop() |
* |
* \brief |
******************************************************************************/ |
void loop() |
{ |
} |
/trunk/libraries/MAX7219/keywords.txt |
---|
0,0 → 1,47 |
####################################### |
# Syntax Coloring Map For MAX7219 |
####################################### |
####################################### |
# Datatypes (KEYWORD1) |
####################################### |
DecodeModes KEYWORD1 |
DecodeMode_t KEYWORD1 |
Intensities KEYWORD1 |
Intensity_t KEYWORD1 |
ScanLimits KEYWORD1 |
ScanLimit_t KEYWORD1 |
ShutdownModes KEYWORD1 |
ShutdownMode_t KEYWORD1 |
DisplayTestModes KEYWORD1 |
DisplayTestMode_t KEYWORD1 |
Digits KEYWORD1 |
Digit_t KEYWORD1 |
Characters KEYWORD1 |
Character_t KEYWORD1 |
Segments KEYWORD1 |
Segment_t KEYWORD1 |
####################################### |
# Methods and Functions (KEYWORD2) |
####################################### |
initialize KEYWORD2 |
setDecodeMode KEYWORD2 |
setIntensity KEYWORD2 |
setScanLimit KEYWORD2 |
setShutdownMode KEYWORD2 |
setDisplayTestMode KEYWORD2 |
writeDigit KEYWORD2 |
####################################### |
# Instances (KEYWORD2) |
####################################### |
MAX7219 KEYWORD2 |
####################################### |
# Constants (LITERAL1) |
####################################### |
/trunk/libraries/MAX7219/examples/MAX7219/MAX7219.ino |
---|
0,0 → 1,89 |
/**************************************************************************//** |
* \brief MAX7219 library for Arduino - Demo program |
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20110801 |
* |
* This file is part of the MAX7219 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file MAX7219.ino |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <SPI.h> |
#include <MAX7219.h> |
/****************************************************************************** |
* Private variable declaration. |
******************************************************************************/ |
static MAX7219 max7219(10); |
/****************************************************************************** |
* Public function definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void setup() |
******************************************************************************/ |
void setup() |
{ |
// Initiliaze MAX7219. |
max7219.initialize(); |
// Set scan limit. |
max7219.setScanLimit(MAX7219::ScanLimit_Digit0To7); |
// Set decode mode. |
max7219.setDecodeMode(MAX7219::DecodeMode_AllDigits); |
// Set intensity. |
max7219.setIntensity(MAX7219::Intensity_Level15); |
// Set shutdown mode. |
max7219.setShutdownMode(MAX7219::ShutdownMode_NormalOperation); |
} |
/**************************************************************************//** |
* \fn void loop() |
******************************************************************************/ |
void loop() |
{ |
// To write digit values, a loop may be more elegant but a bit more |
// complicated for this example. |
// Write digit 0 value. |
max7219.writeDigit(MAX7219::Digit_0, MAX7219::Character_Zero); |
// Write digit 1 value. |
max7219.writeDigit(MAX7219::Digit_1, MAX7219::Character_One); |
// Write digit 2 value. |
max7219.writeDigit(MAX7219::Digit_2, MAX7219::Character_Two); |
// Write digit 3 value. |
max7219.writeDigit(MAX7219::Digit_3, MAX7219::Character_Three); |
// Write digit 4 value. |
max7219.writeDigit(MAX7219::Digit_4, MAX7219::Character_Four); |
// Write digit 5 value. |
max7219.writeDigit(MAX7219::Digit_5, MAX7219::Character_Five); |
// Write digit 6 value. |
max7219.writeDigit(MAX7219::Digit_6, MAX7219::Character_Six); |
// Write digit 7 value. |
max7219.writeDigit(MAX7219::Digit_7, MAX7219::Character_Seven); |
// Wait a little before next loop. |
delay(1000); |
} |
/trunk/libraries/MAX7219/MAX7219.cpp |
---|
0,0 → 1,240 |
/**************************************************************************//** |
* \brief MAX7219 library for Arduino |
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20110801 |
* |
* This file is part of the MAX7219 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \file MAX7219.cpp |
******************************************************************************/ |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
#include <SPI.h> |
#include <MAX7219.h> |
/****************************************************************************** |
* Private macros. |
******************************************************************************/ |
#define REG_NO_OP 0x00 |
#define REG_DIGIT_0 0x01 |
#define REG_DIGIT_1 0x02 |
#define REG_DIGIT_2 0x03 |
#define REG_DIGIT_3 0x04 |
#define REG_DIGIT_4 0x05 |
#define REG_DIGIT_5 0x06 |
#define REG_DIGIT_6 0x07 |
#define REG_DIGIT_7 0x08 |
#define REG_DECODE_MODE 0x09 |
#define REG_INTENSITY 0x0A |
#define REG_SCAN_LIMIT 0x0B |
#define REG_SHUTDOWN 0x0C |
#define REG_DISPLAY_TEST 0x0F |
/****************************************************************************** |
* Public method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn MAX7219::MAX7219(byte csPin) |
* |
* \brief Constructor. |
* |
* \param csPin Chip select pin number. |
******************************************************************************/ |
MAX7219::MAX7219 |
( |
byte csPin |
){ |
m_csPin = csPin; |
} |
/**************************************************************************//** |
* \fn void MAX7219::initialize() |
* |
* \brief Initialize SPI to drive MAX7219. |
******************************************************************************/ |
void |
MAX7219::initialize() |
{ |
// Configure chip select pin as output. |
pinMode(m_csPin, OUTPUT); |
// Wait a little to allow MAX7219 to see a correct logic level on CS pin. |
delay(1); |
// Configure SPI. |
SPI.begin(); |
SPI.setBitOrder(MSBFIRST); |
SPI.setDataMode(SPI_MODE0); |
SPI.setClockDivider(SPI_CLOCK_DIV4); |
} |
/**************************************************************************//** |
* \fn void MAX7219::setDecodeMode(DecodeModes mode) |
* |
* \brief Set MAX7219 decode mode. |
* |
* \param mode Decode mode to set. |
******************************************************************************/ |
void |
MAX7219::setDecodeMode |
( |
DecodeModes mode |
){ |
write(REG_DECODE_MODE, mode); |
} |
/**************************************************************************//** |
* \fn void MAX7219::setIntensity(Intensities intensity) |
* |
* \brief Set MAX7219 intensity. |
* |
* \param itensity Intensity to set. |
******************************************************************************/ |
void |
MAX7219::setIntensity |
( |
Intensities intensity |
){ |
write(REG_INTENSITY, intensity); |
} |
/**************************************************************************//** |
* \fn void MAX7219::setScanLimit(ScanLimits limit) |
* |
* \brief Set MAX7219 scan limit. |
* |
* \param limit Scan limit to set. |
******************************************************************************/ |
void |
MAX7219::setScanLimit |
( |
ScanLimits limit |
){ |
write(REG_SCAN_LIMIT, limit); |
} |
/**************************************************************************//** |
* \fn void MAX7219::setShutdownMode(ShutdownModes mode) |
* |
* \brief Set MAX7219 shutdown mode. |
* |
* \param mode Shutdown mode to set. |
******************************************************************************/ |
void |
MAX7219::setShutdownMode |
( |
ShutdownModes mode |
){ |
write(REG_SHUTDOWN, mode); |
} |
/**************************************************************************//** |
* \fn void MAX7219::setDisplayTestMode(DisplayTestModes mode) |
* |
* \brief Set MAX7219 display test mode. |
* |
* \param mode Display test mode to set. |
******************************************************************************/ |
void |
MAX7219::setDisplayTestMode |
( |
DisplayTestModes mode |
){ |
write(REG_DISPLAY_TEST, mode); |
} |
/**************************************************************************//** |
* \fn void MAX7219::writeDigit( |
* Digits digit, |
* Characters character, |
* bool decimalPoint) |
* |
* \brief Write character on digit. |
* |
* \param digit Digit to write. |
* \param character Character to write. |
* \param decimalPoint Display decimal point if true. |
******************************************************************************/ |
void |
MAX7219::writeDigit |
( |
Digits digit, |
Characters character, |
bool decimalPoint |
){ |
byte value = character; |
if (decimalPoint) |
{ |
// If decimal point must be switched on. |
value |= Segment_DP; |
} |
write(digit, value); |
} |
/**************************************************************************//** |
* \fn void MAX7219::writeDigit(Digits digit, Segments segments) |
* |
* \brief Set segment(s) on digit. |
* |
* \param digit Digit to write. |
* \param segment Segment(s) to set. |
******************************************************************************/ |
void |
MAX7219::writeDigit |
( |
Digits digit, |
Segments segments |
){ |
write(digit, segments); |
} |
/****************************************************************************** |
* Private method definitions. |
******************************************************************************/ |
/**************************************************************************//** |
* \fn void MAX7219::write(byte address, byte value) |
* |
* \brief Write value into MAX7219 register. |
* |
* \param address Register address. |
* \param value Value to write. |
******************************************************************************/ |
void |
MAX7219::write |
( |
byte address, |
byte value |
){ |
// Reset chip select pin to select the device. |
digitalWrite(m_csPin, LOW); |
// Transmit data to the device, register address and value. |
SPI.transfer(address); |
SPI.transfer(value); |
// Set chip select pin to valid data onto the device. |
digitalWrite(m_csPin, HIGH); |
} |
/trunk/libraries/MAX7219/MAX7219.h |
---|
0,0 → 1,319 |
/**************************************************************************//** |
* \brief MAX7219 library for Arduino |
* \author Copyright (C) 2011 Julien Le Sech - www.idreammicro.com |
* \version 1.0 |
* \date 20110801 |
* |
* This file is part of the MAX7219 library for Arduino. |
* |
* This library is free software: you can redistribute it and/or modify it under |
* the terms of the GNU Lesser General Public License as published by the Free |
* Software Foundation, either version 3 of the License, or (at your option) any |
* later version. |
* |
* This library is distributed in the hope that it will be useful, but WITHOUT |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
* details. |
* |
* You should have received a copy of the GNU Lesser General Public License |
* along with this program. If not, see http://www.gnu.org/licenses/ |
******************************************************************************/ |
/**************************************************************************//** |
* \headerfile MAX7219.h |
******************************************************************************/ |
#ifndef MAX7219_h |
#define MAX7219_h |
/****************************************************************************** |
* Header file inclusions. |
******************************************************************************/ |
#include <Arduino.h> |
/**************************************************************************//** |
* \class MAX7219 |
******************************************************************************/ |
class MAX7219 |
{ |
public: |
/******************************************************************//** |
* \enum DecodeModes |
* \typedef DecodeMode_t |
**********************************************************************/ |
typedef enum DecodeModes |
{ |
DecodeMode_NoDecode = 0x00, |
DecodeMode_Digit0 = 0x01, |
DecodeMode_Digit1 = 0x02, |
DecodeMode_Digit2 = 0x04, |
DecodeMode_Digit3 = 0x08, |
DecodeMode_Digit4 = 0x10, |
DecodeMode_Digit5 = 0x20, |
DecodeMode_Digit6 = 0x40, |
DecodeMode_Digit7 = 0x80, |
DecodeMode_AllDigits = 0xFF |
} DecodeMode_t; |
/******************************************************************//** |
* \enum DecodeModes |
* \typedef DecodeMode_t |
**********************************************************************/ |
typedef enum Intensities |
{ |
Intensity_Level0 = 0x00, |
Intensity_Level1 = 0x01, |
Intensity_Level2 = 0x02, |
Intensity_Level3 = 0x03, |
Intensity_Level4 = 0x04, |
Intensity_Level5 = 0x05, |
Intensity_Level6 = 0x06, |
Intensity_Level7 = 0x07, |
Intensity_Level8 = 0x08, |
Intensity_Level9 = 0x09, |
Intensity_Level10 = 0x0A, |
Intensity_Level11 = 0x0B, |
Intensity_Level12 = 0x0C, |
Intensity_Level13 = 0x0D, |
Intensity_Level14 = 0x0E, |
Intensity_Level15 = 0x0F |
} Intensity_t; |
/******************************************************************//** |
* \enum ScanLimits |
* \typedef ScanLimit_t |
**********************************************************************/ |
typedef enum ScanLimits |
{ |
ScanLimit_Digit0 = 0x00, |
ScanLimit_Digit0To1 = 0x01, |
ScanLimit_Digit0To2 = 0x02, |
ScanLimit_Digit0To3 = 0x03, |
ScanLimit_Digit0To4 = 0x04, |
ScanLimit_Digit0To5 = 0x05, |
ScanLimit_Digit0To6 = 0x06, |
ScanLimit_Digit0To7 = 0x07 |
} ScanLimit_t; |
/******************************************************************//** |
* \enum ShutdownModes |
* \typedef ShutdownMode_t |
**********************************************************************/ |
typedef enum ShutdownModes |
{ |
ShutdownMode_Shutdown = 0x00, |
ShutdownMode_NormalOperation = 0x01 |
} ShutdownMode_t; |
/******************************************************************//** |
* \enum DisplayTestModes |
* \typedef DisplayTestMode_t |
**********************************************************************/ |
typedef enum DisplayTestModes |
{ |
NormalOperation = 0x00, |
TestMode = 0x01 |
} DisplayTestMode_t; |
/******************************************************************//** |
* \enum Digits |
* \typedef Digit_t |
**********************************************************************/ |
typedef enum Digits |
{ |
Digit_0 = 0x01, |
Digit_1 = 0x02, |
Digit_2 = 0x03, |
Digit_3 = 0x04, |
Digit_4 = 0x05, |
Digit_5 = 0x06, |
Digit_6 = 0x07, |
Digit_7 = 0x08 |
} Digit_t; |
/******************************************************************//** |
* \enum Characters |
* \typedef Character_t |
**********************************************************************/ |
typedef enum Characters |
{ |
Character_Zero = 0x00, |
Character_One = 0x01, |
Character_Two = 0x02, |
Character_Three = 0x03, |
Character_Four = 0x04, |
Character_Five = 0x05, |
Character_Six = 0x06, |
Character_Seven = 0x07, |
Character_Eight = 0x08, |
Character_Nine = 0x09, |
Character_Dash = 0x0A, |
Character_E = 0x0B, |
Character_H = 0x0C, |
Character_L = 0x0D, |
Character_P = 0x0E, |
Character_Blank = 0x0F |
} Character_t; |
/******************************************************************//** |
* \enum Segments |
* \typedef Segment_t |
**********************************************************************/ |
typedef enum Segments |
{ |
Segment_DP = 0x80, |
Segment_A = 0x40, |
Segment_B = 0x20, |
Segment_C = 0x10, |
Segment_D = 0x08, |
Segment_E = 0x04, |
Segment_F = 0x02, |
Segment_G = 0x01 |
} Segment_t; |
public: |
/******************************************************************//** |
* \fn MAX7219(byte csPin) |
* |
* \brief Constructor. |
* |
* \param csPin Chip select pin number. |
**********************************************************************/ |
MAX7219 |
( |
byte csPin |
); |
/******************************************************************//** |
* \fn void initialize() |
* |
* \brief Initialize SPI to drive MAX7219. |
**********************************************************************/ |
void |
initialize(); |
/******************************************************************//** |
* \fn void setDecodeMode(DecodeModes mode) |
* |
* \brief Set MAX7219 decode mode. |
* |
* \param mode Decode mode to set. |
**********************************************************************/ |
void |
setDecodeMode |
( |
DecodeModes mode |
); |
/******************************************************************//** |
* \fn void setIntensity(Intensities intensity) |
* |
* \brief Set MAX7219 intensity. |
* |
* \param itensity Intensity to set. |
**********************************************************************/ |
void |
setIntensity |
( |
Intensities intensity |
); |
/******************************************************************//** |
* \fn void setScanLimit(ScanLimits limit) |
* |
* \brief Set MAX7219 scan limit. |
* |
* \param limit Scan limit to set. |
**********************************************************************/ |
void |
setScanLimit |
( |
ScanLimits limit |
); |
/******************************************************************//** |
* \fn void setShutdownMode(ShutdownModes mode) |
* |
* \brief Set MAX7219 shutdown mode. |
* |
* \param mode Shutdown mode to set. |
**********************************************************************/ |
void |
setShutdownMode |
( |
ShutdownModes mode |
); |
/******************************************************************//** |
* \fn void setDisplayTestMode(DisplayTestModes mode) |
* |
* \brief Set MAX7219 display test mode. |
* |
* \param mode Display test mode to set. |
**********************************************************************/ |
void |
setDisplayTestMode |
( |
DisplayTestModes mode |
); |
/******************************************************************//** |
* \fn void writeDigit( |
* Digits digit, |
* Characters character, |
* bool decimalPoint = false) |
* |
* \brief Write character on digit. |
* |
* \param digit Digit to write. |
* \param character Character to write. |
* \param decimalPoint Display decimal point. |
**********************************************************************/ |
void |
writeDigit |
( |
Digits digit, |
Characters character, |
bool decimalPoint = false |
); |
/******************************************************************//** |
* \fn void writeDigit(Digits digit, Segments segments) |
* |
* \brief Set segment(s) on digit. |
* |
* \param digit Digit to write. |
* \param segment Segment(s) to set. |
**********************************************************************/ |
void |
writeDigit |
( |
Digits digit, |
Segments segment |
); |
private: |
byte m_csPin; |
/******************************************************************//** |
* \fn void write(byte address, byte value) |
* |
* \brief Write value into MAX7219 register. |
* |
* \param address Register address. |
* \param value Value to write. |
**********************************************************************/ |
void |
write |
( |
byte address, |
byte value |
); |
}; |
#endif // MAX7219_h |
/trunk/libraries/MAX7219/lgpl-3.0.txt |
---|
0,0 → 1,165 |
GNU LESSER GENERAL PUBLIC LICENSE |
Version 3, 29 June 2007 |
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
Everyone is permitted to copy and distribute verbatim copies |
of this license document, but changing it is not allowed. |
This version of the GNU Lesser General Public License incorporates |
the terms and conditions of version 3 of the GNU General Public |
License, supplemented by the additional permissions listed below. |
0. Additional Definitions. |
As used herein, "this License" refers to version 3 of the GNU Lesser |
General Public License, and the "GNU GPL" refers to version 3 of the GNU |
General Public License. |
"The Library" refers to a covered work governed by this License, |
other than an Application or a Combined Work as defined below. |
An "Application" is any work that makes use of an interface provided |
by the Library, but which is not otherwise based on the Library. |
Defining a subclass of a class defined by the Library is deemed a mode |
of using an interface provided by the Library. |
A "Combined Work" is a work produced by combining or linking an |
Application with the Library. The particular version of the Library |
with which the Combined Work was made is also called the "Linked |
Version". |
The "Minimal Corresponding Source" for a Combined Work means the |
Corresponding Source for the Combined Work, excluding any source code |
for portions of the Combined Work that, considered in isolation, are |
based on the Application, and not on the Linked Version. |
The "Corresponding Application Code" for a Combined Work means the |
object code and/or source code for the Application, including any data |
and utility programs needed for reproducing the Combined Work from the |
Application, but excluding the System Libraries of the Combined Work. |
1. Exception to Section 3 of the GNU GPL. |
You may convey a covered work under sections 3 and 4 of this License |
without being bound by section 3 of the GNU GPL. |
2. Conveying Modified Versions. |
If you modify a copy of the Library, and, in your modifications, a |
facility refers to a function or data to be supplied by an Application |
that uses the facility (other than as an argument passed when the |
facility is invoked), then you may convey a copy of the modified |
version: |
a) under this License, provided that you make a good faith effort to |
ensure that, in the event an Application does not supply the |
function or data, the facility still operates, and performs |
whatever part of its purpose remains meaningful, or |
b) under the GNU GPL, with none of the additional permissions of |
this License applicable to that copy. |
3. Object Code Incorporating Material from Library Header Files. |
The object code form of an Application may incorporate material from |
a header file that is part of the Library. You may convey such object |
code under terms of your choice, provided that, if the incorporated |
material is not limited to numerical parameters, data structure |
layouts and accessors, or small macros, inline functions and templates |
(ten or fewer lines in length), you do both of the following: |
a) Give prominent notice with each copy of the object code that the |
Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the object code with a copy of the GNU GPL and this license |
document. |
4. Combined Works. |
You may convey a Combined Work under terms of your choice that, |
taken together, effectively do not restrict modification of the |
portions of the Library contained in the Combined Work and reverse |
engineering for debugging such modifications, if you also do each of |
the following: |
a) Give prominent notice with each copy of the Combined Work that |
the Library is used in it and that the Library and its use are |
covered by this License. |
b) Accompany the Combined Work with a copy of the GNU GPL and this license |
document. |
c) For a Combined Work that displays copyright notices during |
execution, include the copyright notice for the Library among |
these notices, as well as a reference directing the user to the |
copies of the GNU GPL and this license document. |
d) Do one of the following: |
0) Convey the Minimal Corresponding Source under the terms of this |
License, and the Corresponding Application Code in a form |
suitable for, and under terms that permit, the user to |
recombine or relink the Application with a modified version of |
the Linked Version to produce a modified Combined Work, in the |
manner specified by section 6 of the GNU GPL for conveying |
Corresponding Source. |
1) Use a suitable shared library mechanism for linking with the |
Library. A suitable mechanism is one that (a) uses at run time |
a copy of the Library already present on the user's computer |
system, and (b) will operate properly with a modified version |
of the Library that is interface-compatible with the Linked |
Version. |
e) Provide Installation Information, but only if you would otherwise |
be required to provide such information under section 6 of the |
GNU GPL, and only to the extent that such information is |
necessary to install and execute a modified version of the |
Combined Work produced by recombining or relinking the |
Application with a modified version of the Linked Version. (If |
you use option 4d0, the Installation Information must accompany |
the Minimal Corresponding Source and Corresponding Application |
Code. If you use option 4d1, you must provide the Installation |
Information in the manner specified by section 6 of the GNU GPL |
for conveying Corresponding Source.) |
5. Combined Libraries. |
You may place library facilities that are a work based on the |
Library side by side in a single library together with other library |
facilities that are not Applications and are not covered by this |
License, and convey such a combined library under terms of your |
choice, if you do both of the following: |
a) Accompany the combined library with a copy of the same work based |
on the Library, uncombined with any other library facilities, |
conveyed under the terms of this License. |
b) Give prominent notice with the combined library that part of it |
is a work based on the Library, and explaining where to find the |
accompanying uncombined form of the same work. |
6. Revised Versions of the GNU Lesser General Public License. |
The Free Software Foundation may publish revised and/or new versions |
of the GNU Lesser General Public License from time to time. Such new |
versions will be similar in spirit to the present version, but may |
differ in detail to address new problems or concerns. |
Each version is given a distinguishing version number. If the |
Library as you received it specifies that a certain numbered version |
of the GNU Lesser General Public License "or any later version" |
applies to it, you have the option of following the terms and |
conditions either of that published version or of any later version |
published by the Free Software Foundation. If the Library as you |
received it does not specify a version number of the GNU Lesser |
General Public License, you may choose any version of the GNU Lesser |
General Public License ever published by the Free Software Foundation. |
If the Library as you received it specifies that a proxy can decide |
whether future versions of the GNU Lesser General Public License shall |
apply, that proxy's public statement of acceptance of any version is |
permanent authorization for you to choose that version for the |
Library. |