parent
99653ff805
commit
750f6c33e3
@ -0,0 +1,188 @@
|
|||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
|
||||||
|
Version 3, 29 June 2007
|
||||||
|
|
||||||
|
Copyright © 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.
|
||||||
|
|
@ -0,0 +1,133 @@
|
|||||||
|
#ifndef CONFIGURATION_H
|
||||||
|
#define CONFIGURATION_H
|
||||||
|
|
||||||
|
// BASIC SETTINGS: select your board type, thermistor type, axis scaling, and endstop configuration
|
||||||
|
|
||||||
|
//// The following define selects which electronics board you have. Please choose the one that matches your setup
|
||||||
|
// Gen6 = 5,
|
||||||
|
#define MOTHERBOARD 5
|
||||||
|
|
||||||
|
//// Thermistor settings:
|
||||||
|
// 1 is 100k thermistor
|
||||||
|
// 2 is 200k thermistor
|
||||||
|
// 3 is mendel-parts thermistor
|
||||||
|
#define THERMISTORHEATER 3
|
||||||
|
|
||||||
|
// extruder advance constant (s2/mm3)
|
||||||
|
//
|
||||||
|
// advance (steps) = STEPS_PER_CUBIC_MM_E * EXTUDER_ADVANCE_K * cubic mm per second ^ 2
|
||||||
|
//
|
||||||
|
// hooke's law says: force = k * distance
|
||||||
|
// bernoulli's priniciple says: v ^ 2 / 2 + g . h + pressure / density = constant
|
||||||
|
// so: v ^ 2 is proportional to number of steps we advance the extruder
|
||||||
|
//#define ADVANCE
|
||||||
|
|
||||||
|
#ifdef ADVANCE
|
||||||
|
#define EXTRUDER_ADVANCE_K 0.02
|
||||||
|
|
||||||
|
#define D_FILAMENT 1.7
|
||||||
|
#define STEPS_MM_E 65
|
||||||
|
//#define D_FILAMENT 2.85
|
||||||
|
//#define STEPS_MM_E 367.35
|
||||||
|
#define EXTRUTION_AREA (0.25 * D_FILAMENT * D_FILAMENT * 3.14159)
|
||||||
|
#define STEPS_PER_CUBIC_MM_E (axis_steps_per_unit[E_AXIS]/ EXTRUTION_AREA)
|
||||||
|
|
||||||
|
#endif // ADVANCE
|
||||||
|
|
||||||
|
//// Calibration variables
|
||||||
|
// X, Y, Z, E steps per unit - Metric Prusa Mendel with V9 extruder:
|
||||||
|
float axis_steps_per_unit[] = {40, 40, 3333.92,76.2};
|
||||||
|
// Metric Prusa Mendel with Makergear geared stepper extruder:
|
||||||
|
//float axis_steps_per_unit[] = {80,80,3200/1.25,1380};
|
||||||
|
|
||||||
|
//// Endstop Settings
|
||||||
|
#define ENDSTOPPULLUPS // Comment this out (using // at the start of the line) to disable the endstop pullup resistors
|
||||||
|
// The pullups are needed if you directly connect a mechanical endswitch between the signal and ground pins.
|
||||||
|
const bool ENDSTOPS_INVERTING = false; //set to true to invert the logic of the endstops
|
||||||
|
|
||||||
|
// This determines the communication speed of the printer
|
||||||
|
#define BAUDRATE 250000
|
||||||
|
|
||||||
|
// Comment out (using // at the start of the line) to disable SD support:
|
||||||
|
//#define SDSUPPORT
|
||||||
|
|
||||||
|
|
||||||
|
//// ADVANCED SETTINGS - to tweak parameters
|
||||||
|
|
||||||
|
#include "thermistortables.h"
|
||||||
|
|
||||||
|
// For Inverting Stepper Enable Pins (Active Low) use 0, Non Inverting (Active High) use 1
|
||||||
|
#define X_ENABLE_ON 0
|
||||||
|
#define Y_ENABLE_ON 0
|
||||||
|
#define Z_ENABLE_ON 0
|
||||||
|
#define E_ENABLE_ON 0
|
||||||
|
|
||||||
|
// Disables axis when it's not being used.
|
||||||
|
#define DISABLE_X false
|
||||||
|
#define DISABLE_Y false
|
||||||
|
#define DISABLE_Z true
|
||||||
|
#define DISABLE_E false
|
||||||
|
|
||||||
|
// Inverting axis direction
|
||||||
|
#define INVERT_X_DIR false
|
||||||
|
#define INVERT_Y_DIR true
|
||||||
|
#define INVERT_Z_DIR false
|
||||||
|
#define INVERT_E_DIR true
|
||||||
|
|
||||||
|
//// ENDSTOP SETTINGS:
|
||||||
|
// Sets direction of endstops when homing; 1=MAX, -1=MIN
|
||||||
|
#define X_HOME_DIR -1
|
||||||
|
#define Y_HOME_DIR -1
|
||||||
|
#define Z_HOME_DIR -1
|
||||||
|
|
||||||
|
#define min_software_endstops false //If true, axis won't move to coordinates less than zero.
|
||||||
|
#define max_software_endstops true //If true, axis won't move to coordinates greater than the defined lengths below.
|
||||||
|
#define X_MAX_LENGTH 200
|
||||||
|
#define Y_MAX_LENGTH 200
|
||||||
|
#define Z_MAX_LENGTH 100
|
||||||
|
|
||||||
|
//// MOVEMENT SETTINGS
|
||||||
|
#define NUM_AXIS 4 // The axis order in all axis related arrays is X, Y, Z, E
|
||||||
|
float max_feedrate[] = {60000, 60000, 170, 500000};
|
||||||
|
float homing_feedrate[] = {1500,1500,120,0};
|
||||||
|
bool axis_relative_modes[] = {false, false, false, false};
|
||||||
|
|
||||||
|
//// Acceleration settings
|
||||||
|
// X, Y, Z, E maximum start speed for accelerated moves. E default values are good for skeinforge 40+, for older versions raise them a lot.
|
||||||
|
float acceleration = 3000; // Normal acceleration mm/s^2
|
||||||
|
float retract_acceleration = 7000; // Normal acceleration mm/s^2
|
||||||
|
float max_jerk = 20*60;
|
||||||
|
long max_acceleration_units_per_sq_second[] = {7000,7000,20,10000}; // X, Y, Z and E max acceleration in mm/s^2 for printing moves or retracts
|
||||||
|
// Not used long max_travel_acceleration_units_per_sq_second[] = {500,500,50,500}; // X, Y, Z max acceleration in mm/s^2 for travel moves
|
||||||
|
|
||||||
|
|
||||||
|
// The watchdog waits for the watchperiod in milliseconds whenever an M104 or M109 increases the target temperature
|
||||||
|
// If the temperature has not increased at the end of that period, the target temperature is set to zero. It can be reset with another M104/M109
|
||||||
|
//#define WATCHPERIOD 5000 //5 seconds
|
||||||
|
|
||||||
|
//// The minimal temperature defines the temperature below which the heater will not be enabled
|
||||||
|
#define MINTEMP 5
|
||||||
|
|
||||||
|
|
||||||
|
// When temperature exceeds max temp, your heater will be switched off.
|
||||||
|
// This feature exists to protect your hotend from overheating accidentally, but *NOT* from thermistor short/failure!
|
||||||
|
// You should use MINTEMP for thermistor short/failure protection.
|
||||||
|
#define MAXTEMP 275
|
||||||
|
|
||||||
|
|
||||||
|
/// PID settings:
|
||||||
|
// Uncomment the following line to enable PID support.
|
||||||
|
//#define PIDTEMP
|
||||||
|
#ifdef PIDTEMP
|
||||||
|
//#define PID_DEBUG 1 // Sends debug data to the serial port.
|
||||||
|
//#define PID_OPENLOOP 1 // Puts PID in open loop. M104 sets the output power in %
|
||||||
|
#define PID_MAX 156 // limits current to nozzle
|
||||||
|
#define PID_INTEGRAL_DRIVE_MAX 156.0
|
||||||
|
#define PID_dT 0.16
|
||||||
|
double Kp = 20.0;
|
||||||
|
double Ki = 1.5*PID_dT;
|
||||||
|
double Kd = 80/PID_dT;
|
||||||
|
#endif // PIDTEMP
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
@ -0,0 +1,418 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#ifndef FatStructs_h
|
||||||
|
#define FatStructs_h
|
||||||
|
/**
|
||||||
|
* \file
|
||||||
|
* FAT file structures
|
||||||
|
*/
|
||||||
|
/*
|
||||||
|
* mostly from Microsoft document fatgen103.doc
|
||||||
|
* http://www.microsoft.com/whdc/system/platform/firmware/fatgen.mspx
|
||||||
|
*/
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Value for byte 510 of boot block or MBR */
|
||||||
|
uint8_t const BOOTSIG0 = 0X55;
|
||||||
|
/** Value for byte 511 of boot block or MBR */
|
||||||
|
uint8_t const BOOTSIG1 = 0XAA;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \struct partitionTable
|
||||||
|
* \brief MBR partition table entry
|
||||||
|
*
|
||||||
|
* A partition table entry for a MBR formatted storage device.
|
||||||
|
* The MBR partition table has four entries.
|
||||||
|
*/
|
||||||
|
struct partitionTable {
|
||||||
|
/**
|
||||||
|
* Boot Indicator . Indicates whether the volume is the active
|
||||||
|
* partition. Legal values include: 0X00. Do not use for booting.
|
||||||
|
* 0X80 Active partition.
|
||||||
|
*/
|
||||||
|
uint8_t boot;
|
||||||
|
/**
|
||||||
|
* Head part of Cylinder-head-sector address of the first block in
|
||||||
|
* the partition. Legal values are 0-255. Only used in old PC BIOS.
|
||||||
|
*/
|
||||||
|
uint8_t beginHead;
|
||||||
|
/**
|
||||||
|
* Sector part of Cylinder-head-sector address of the first block in
|
||||||
|
* the partition. Legal values are 1-63. Only used in old PC BIOS.
|
||||||
|
*/
|
||||||
|
unsigned beginSector : 6;
|
||||||
|
/** High bits cylinder for first block in partition. */
|
||||||
|
unsigned beginCylinderHigh : 2;
|
||||||
|
/**
|
||||||
|
* Combine beginCylinderLow with beginCylinderHigh. Legal values
|
||||||
|
* are 0-1023. Only used in old PC BIOS.
|
||||||
|
*/
|
||||||
|
uint8_t beginCylinderLow;
|
||||||
|
/**
|
||||||
|
* Partition type. See defines that begin with PART_TYPE_ for
|
||||||
|
* some Microsoft partition types.
|
||||||
|
*/
|
||||||
|
uint8_t type;
|
||||||
|
/**
|
||||||
|
* head part of cylinder-head-sector address of the last sector in the
|
||||||
|
* partition. Legal values are 0-255. Only used in old PC BIOS.
|
||||||
|
*/
|
||||||
|
uint8_t endHead;
|
||||||
|
/**
|
||||||
|
* Sector part of cylinder-head-sector address of the last sector in
|
||||||
|
* the partition. Legal values are 1-63. Only used in old PC BIOS.
|
||||||
|
*/
|
||||||
|
unsigned endSector : 6;
|
||||||
|
/** High bits of end cylinder */
|
||||||
|
unsigned endCylinderHigh : 2;
|
||||||
|
/**
|
||||||
|
* Combine endCylinderLow with endCylinderHigh. Legal values
|
||||||
|
* are 0-1023. Only used in old PC BIOS.
|
||||||
|
*/
|
||||||
|
uint8_t endCylinderLow;
|
||||||
|
/** Logical block address of the first block in the partition. */
|
||||||
|
uint32_t firstSector;
|
||||||
|
/** Length of the partition, in blocks. */
|
||||||
|
uint32_t totalSectors;
|
||||||
|
};
|
||||||
|
/** Type name for partitionTable */
|
||||||
|
typedef struct partitionTable part_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \struct masterBootRecord
|
||||||
|
*
|
||||||
|
* \brief Master Boot Record
|
||||||
|
*
|
||||||
|
* The first block of a storage device that is formatted with a MBR.
|
||||||
|
*/
|
||||||
|
struct masterBootRecord {
|
||||||
|
/** Code Area for master boot program. */
|
||||||
|
uint8_t codeArea[440];
|
||||||
|
/** Optional WindowsNT disk signature. May contain more boot code. */
|
||||||
|
uint32_t diskSignature;
|
||||||
|
/** Usually zero but may be more boot code. */
|
||||||
|
uint16_t usuallyZero;
|
||||||
|
/** Partition tables. */
|
||||||
|
part_t part[4];
|
||||||
|
/** First MBR signature byte. Must be 0X55 */
|
||||||
|
uint8_t mbrSig0;
|
||||||
|
/** Second MBR signature byte. Must be 0XAA */
|
||||||
|
uint8_t mbrSig1;
|
||||||
|
};
|
||||||
|
/** Type name for masterBootRecord */
|
||||||
|
typedef struct masterBootRecord mbr_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \struct biosParmBlock
|
||||||
|
*
|
||||||
|
* \brief BIOS parameter block
|
||||||
|
*
|
||||||
|
* The BIOS parameter block describes the physical layout of a FAT volume.
|
||||||
|
*/
|
||||||
|
struct biosParmBlock {
|
||||||
|
/**
|
||||||
|
* Count of bytes per sector. This value may take on only the
|
||||||
|
* following values: 512, 1024, 2048 or 4096
|
||||||
|
*/
|
||||||
|
uint16_t bytesPerSector;
|
||||||
|
/**
|
||||||
|
* Number of sectors per allocation unit. This value must be a
|
||||||
|
* power of 2 that is greater than 0. The legal values are
|
||||||
|
* 1, 2, 4, 8, 16, 32, 64, and 128.
|
||||||
|
*/
|
||||||
|
uint8_t sectorsPerCluster;
|
||||||
|
/**
|
||||||
|
* Number of sectors before the first FAT.
|
||||||
|
* This value must not be zero.
|
||||||
|
*/
|
||||||
|
uint16_t reservedSectorCount;
|
||||||
|
/** The count of FAT data structures on the volume. This field should
|
||||||
|
* always contain the value 2 for any FAT volume of any type.
|
||||||
|
*/
|
||||||
|
uint8_t fatCount;
|
||||||
|
/**
|
||||||
|
* For FAT12 and FAT16 volumes, this field contains the count of
|
||||||
|
* 32-byte directory entries in the root directory. For FAT32 volumes,
|
||||||
|
* this field must be set to 0. For FAT12 and FAT16 volumes, this
|
||||||
|
* value should always specify a count that when multiplied by 32
|
||||||
|
* results in a multiple of bytesPerSector. FAT16 volumes should
|
||||||
|
* use the value 512.
|
||||||
|
*/
|
||||||
|
uint16_t rootDirEntryCount;
|
||||||
|
/**
|
||||||
|
* This field is the old 16-bit total count of sectors on the volume.
|
||||||
|
* This count includes the count of all sectors in all four regions
|
||||||
|
* of the volume. This field can be 0; if it is 0, then totalSectors32
|
||||||
|
* must be non-zero. For FAT32 volumes, this field must be 0. For
|
||||||
|
* FAT12 and FAT16 volumes, this field contains the sector count, and
|
||||||
|
* totalSectors32 is 0 if the total sector count fits
|
||||||
|
* (is less than 0x10000).
|
||||||
|
*/
|
||||||
|
uint16_t totalSectors16;
|
||||||
|
/**
|
||||||
|
* This dates back to the old MS-DOS 1.x media determination and is
|
||||||
|
* no longer usually used for anything. 0xF8 is the standard value
|
||||||
|
* for fixed (non-removable) media. For removable media, 0xF0 is
|
||||||
|
* frequently used. Legal values are 0xF0 or 0xF8-0xFF.
|
||||||
|
*/
|
||||||
|
uint8_t mediaType;
|
||||||
|
/**
|
||||||
|
* Count of sectors occupied by one FAT on FAT12/FAT16 volumes.
|
||||||
|
* On FAT32 volumes this field must be 0, and sectorsPerFat32
|
||||||
|
* contains the FAT size count.
|
||||||
|
*/
|
||||||
|
uint16_t sectorsPerFat16;
|
||||||
|
/** Sectors per track for interrupt 0x13. Not used otherwise. */
|
||||||
|
uint16_t sectorsPerTrtack;
|
||||||
|
/** Number of heads for interrupt 0x13. Not used otherwise. */
|
||||||
|
uint16_t headCount;
|
||||||
|
/**
|
||||||
|
* Count of hidden sectors preceding the partition that contains this
|
||||||
|
* FAT volume. This field is generally only relevant for media
|
||||||
|
* visible on interrupt 0x13.
|
||||||
|
*/
|
||||||
|
uint32_t hidddenSectors;
|
||||||
|
/**
|
||||||
|
* This field is the new 32-bit total count of sectors on the volume.
|
||||||
|
* This count includes the count of all sectors in all four regions
|
||||||
|
* of the volume. This field can be 0; if it is 0, then
|
||||||
|
* totalSectors16 must be non-zero.
|
||||||
|
*/
|
||||||
|
uint32_t totalSectors32;
|
||||||
|
/**
|
||||||
|
* Count of sectors occupied by one FAT on FAT32 volumes.
|
||||||
|
*/
|
||||||
|
uint32_t sectorsPerFat32;
|
||||||
|
/**
|
||||||
|
* This field is only defined for FAT32 media and does not exist on
|
||||||
|
* FAT12 and FAT16 media.
|
||||||
|
* Bits 0-3 -- Zero-based number of active FAT.
|
||||||
|
* Only valid if mirroring is disabled.
|
||||||
|
* Bits 4-6 -- Reserved.
|
||||||
|
* Bit 7 -- 0 means the FAT is mirrored at runtime into all FATs.
|
||||||
|
* -- 1 means only one FAT is active; it is the one referenced in bits 0-3.
|
||||||
|
* Bits 8-15 -- Reserved.
|
||||||
|
*/
|
||||||
|
uint16_t fat32Flags;
|
||||||
|
/**
|
||||||
|
* FAT32 version. High byte is major revision number.
|
||||||
|
* Low byte is minor revision number. Only 0.0 define.
|
||||||
|
*/
|
||||||
|
uint16_t fat32Version;
|
||||||
|
/**
|
||||||
|
* Cluster number of the first cluster of the root directory for FAT32.
|
||||||
|
* This usually 2 but not required to be 2.
|
||||||
|
*/
|
||||||
|
uint32_t fat32RootCluster;
|
||||||
|
/**
|
||||||
|
* Sector number of FSINFO structure in the reserved area of the
|
||||||
|
* FAT32 volume. Usually 1.
|
||||||
|
*/
|
||||||
|
uint16_t fat32FSInfo;
|
||||||
|
/**
|
||||||
|
* If non-zero, indicates the sector number in the reserved area
|
||||||
|
* of the volume of a copy of the boot record. Usually 6.
|
||||||
|
* No value other than 6 is recommended.
|
||||||
|
*/
|
||||||
|
uint16_t fat32BackBootBlock;
|
||||||
|
/**
|
||||||
|
* Reserved for future expansion. Code that formats FAT32 volumes
|
||||||
|
* should always set all of the bytes of this field to 0.
|
||||||
|
*/
|
||||||
|
uint8_t fat32Reserved[12];
|
||||||
|
};
|
||||||
|
/** Type name for biosParmBlock */
|
||||||
|
typedef struct biosParmBlock bpb_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \struct fat32BootSector
|
||||||
|
*
|
||||||
|
* \brief Boot sector for a FAT16 or FAT32 volume.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
struct fat32BootSector {
|
||||||
|
/** X86 jmp to boot program */
|
||||||
|
uint8_t jmpToBootCode[3];
|
||||||
|
/** informational only - don't depend on it */
|
||||||
|
char oemName[8];
|
||||||
|
/** BIOS Parameter Block */
|
||||||
|
bpb_t bpb;
|
||||||
|
/** for int0x13 use value 0X80 for hard drive */
|
||||||
|
uint8_t driveNumber;
|
||||||
|
/** used by Windows NT - should be zero for FAT */
|
||||||
|
uint8_t reserved1;
|
||||||
|
/** 0X29 if next three fields are valid */
|
||||||
|
uint8_t bootSignature;
|
||||||
|
/** usually generated by combining date and time */
|
||||||
|
uint32_t volumeSerialNumber;
|
||||||
|
/** should match volume label in root dir */
|
||||||
|
char volumeLabel[11];
|
||||||
|
/** informational only - don't depend on it */
|
||||||
|
char fileSystemType[8];
|
||||||
|
/** X86 boot code */
|
||||||
|
uint8_t bootCode[420];
|
||||||
|
/** must be 0X55 */
|
||||||
|
uint8_t bootSectorSig0;
|
||||||
|
/** must be 0XAA */
|
||||||
|
uint8_t bootSectorSig1;
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// End Of Chain values for FAT entries
|
||||||
|
/** FAT16 end of chain value used by Microsoft. */
|
||||||
|
uint16_t const FAT16EOC = 0XFFFF;
|
||||||
|
/** Minimum value for FAT16 EOC. Use to test for EOC. */
|
||||||
|
uint16_t const FAT16EOC_MIN = 0XFFF8;
|
||||||
|
/** FAT32 end of chain value used by Microsoft. */
|
||||||
|
uint32_t const FAT32EOC = 0X0FFFFFFF;
|
||||||
|
/** Minimum value for FAT32 EOC. Use to test for EOC. */
|
||||||
|
uint32_t const FAT32EOC_MIN = 0X0FFFFFF8;
|
||||||
|
/** Mask a for FAT32 entry. Entries are 28 bits. */
|
||||||
|
uint32_t const FAT32MASK = 0X0FFFFFFF;
|
||||||
|
|
||||||
|
/** Type name for fat32BootSector */
|
||||||
|
typedef struct fat32BootSector fbs_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \struct directoryEntry
|
||||||
|
* \brief FAT short directory entry
|
||||||
|
*
|
||||||
|
* Short means short 8.3 name, not the entry size.
|
||||||
|
*
|
||||||
|
* Date Format. A FAT directory entry date stamp is a 16-bit field that is
|
||||||
|
* basically a date relative to the MS-DOS epoch of 01/01/1980. Here is the
|
||||||
|
* format (bit 0 is the LSB of the 16-bit word, bit 15 is the MSB of the
|
||||||
|
* 16-bit word):
|
||||||
|
*
|
||||||
|
* Bits 9-15: Count of years from 1980, valid value range 0-127
|
||||||
|
* inclusive (1980-2107).
|
||||||
|
*
|
||||||
|
* Bits 5-8: Month of year, 1 = January, valid value range 1-12 inclusive.
|
||||||
|
*
|
||||||
|
* Bits 0-4: Day of month, valid value range 1-31 inclusive.
|
||||||
|
*
|
||||||
|
* Time Format. A FAT directory entry time stamp is a 16-bit field that has
|
||||||
|
* a granularity of 2 seconds. Here is the format (bit 0 is the LSB of the
|
||||||
|
* 16-bit word, bit 15 is the MSB of the 16-bit word).
|
||||||
|
*
|
||||||
|
* Bits 11-15: Hours, valid value range 0-23 inclusive.
|
||||||
|
*
|
||||||
|
* Bits 5-10: Minutes, valid value range 0-59 inclusive.
|
||||||
|
*
|
||||||
|
* Bits 0-4: 2-second count, valid value range 0-29 inclusive (0 - 58 seconds).
|
||||||
|
*
|
||||||
|
* The valid time range is from Midnight 00:00:00 to 23:59:58.
|
||||||
|
*/
|
||||||
|
struct directoryEntry {
|
||||||
|
/**
|
||||||
|
* Short 8.3 name.
|
||||||
|
* The first eight bytes contain the file name with blank fill.
|
||||||
|
* The last three bytes contain the file extension with blank fill.
|
||||||
|
*/
|
||||||
|
uint8_t name[11];
|
||||||
|
/** Entry attributes.
|
||||||
|
*
|
||||||
|
* The upper two bits of the attribute byte are reserved and should
|
||||||
|
* always be set to 0 when a file is created and never modified or
|
||||||
|
* looked at after that. See defines that begin with DIR_ATT_.
|
||||||
|
*/
|
||||||
|
uint8_t attributes;
|
||||||
|
/**
|
||||||
|
* Reserved for use by Windows NT. Set value to 0 when a file is
|
||||||
|
* created and never modify or look at it after that.
|
||||||
|
*/
|
||||||
|
uint8_t reservedNT;
|
||||||
|
/**
|
||||||
|
* The granularity of the seconds part of creationTime is 2 seconds
|
||||||
|
* so this field is a count of tenths of a second and its valid
|
||||||
|
* value range is 0-199 inclusive. (WHG note - seems to be hundredths)
|
||||||
|
*/
|
||||||
|
uint8_t creationTimeTenths;
|
||||||
|
/** Time file was created. */
|
||||||
|
uint16_t creationTime;
|
||||||
|
/** Date file was created. */
|
||||||
|
uint16_t creationDate;
|
||||||
|
/**
|
||||||
|
* Last access date. Note that there is no last access time, only
|
||||||
|
* a date. This is the date of last read or write. In the case of
|
||||||
|
* a write, this should be set to the same date as lastWriteDate.
|
||||||
|
*/
|
||||||
|
uint16_t lastAccessDate;
|
||||||
|
/**
|
||||||
|
* High word of this entry's first cluster number (always 0 for a
|
||||||
|
* FAT12 or FAT16 volume).
|
||||||
|
*/
|
||||||
|
uint16_t firstClusterHigh;
|
||||||
|
/** Time of last write. File creation is considered a write. */
|
||||||
|
uint16_t lastWriteTime;
|
||||||
|
/** Date of last write. File creation is considered a write. */
|
||||||
|
uint16_t lastWriteDate;
|
||||||
|
/** Low word of this entry's first cluster number. */
|
||||||
|
uint16_t firstClusterLow;
|
||||||
|
/** 32-bit unsigned holding this file's size in bytes. */
|
||||||
|
uint32_t fileSize;
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Definitions for directory entries
|
||||||
|
//
|
||||||
|
/** Type name for directoryEntry */
|
||||||
|
typedef struct directoryEntry dir_t;
|
||||||
|
/** escape for name[0] = 0XE5 */
|
||||||
|
uint8_t const DIR_NAME_0XE5 = 0X05;
|
||||||
|
/** name[0] value for entry that is free after being "deleted" */
|
||||||
|
uint8_t const DIR_NAME_DELETED = 0XE5;
|
||||||
|
/** name[0] value for entry that is free and no allocated entries follow */
|
||||||
|
uint8_t const DIR_NAME_FREE = 0X00;
|
||||||
|
/** file is read-only */
|
||||||
|
uint8_t const DIR_ATT_READ_ONLY = 0X01;
|
||||||
|
/** File should hidden in directory listings */
|
||||||
|
uint8_t const DIR_ATT_HIDDEN = 0X02;
|
||||||
|
/** Entry is for a system file */
|
||||||
|
uint8_t const DIR_ATT_SYSTEM = 0X04;
|
||||||
|
/** Directory entry contains the volume label */
|
||||||
|
uint8_t const DIR_ATT_VOLUME_ID = 0X08;
|
||||||
|
/** Entry is for a directory */
|
||||||
|
uint8_t const DIR_ATT_DIRECTORY = 0X10;
|
||||||
|
/** Old DOS archive bit for backup support */
|
||||||
|
uint8_t const DIR_ATT_ARCHIVE = 0X20;
|
||||||
|
/** Test value for long name entry. Test is
|
||||||
|
(d->attributes & DIR_ATT_LONG_NAME_MASK) == DIR_ATT_LONG_NAME. */
|
||||||
|
uint8_t const DIR_ATT_LONG_NAME = 0X0F;
|
||||||
|
/** Test mask for long name entry */
|
||||||
|
uint8_t const DIR_ATT_LONG_NAME_MASK = 0X3F;
|
||||||
|
/** defined attribute bits */
|
||||||
|
uint8_t const DIR_ATT_DEFINED_BITS = 0X3F;
|
||||||
|
/** Directory entry is part of a long name */
|
||||||
|
static inline uint8_t DIR_IS_LONG_NAME(const dir_t* dir) {
|
||||||
|
return (dir->attributes & DIR_ATT_LONG_NAME_MASK) == DIR_ATT_LONG_NAME;
|
||||||
|
}
|
||||||
|
/** Mask for file/subdirectory tests */
|
||||||
|
uint8_t const DIR_ATT_FILE_TYPE_MASK = (DIR_ATT_VOLUME_ID | DIR_ATT_DIRECTORY);
|
||||||
|
/** Directory entry is for a file */
|
||||||
|
static inline uint8_t DIR_IS_FILE(const dir_t* dir) {
|
||||||
|
return (dir->attributes & DIR_ATT_FILE_TYPE_MASK) == 0;
|
||||||
|
}
|
||||||
|
/** Directory entry is for a subdirectory */
|
||||||
|
static inline uint8_t DIR_IS_SUBDIR(const dir_t* dir) {
|
||||||
|
return (dir->attributes & DIR_ATT_FILE_TYPE_MASK) == DIR_ATT_DIRECTORY;
|
||||||
|
}
|
||||||
|
/** Directory entry is for a file or subdirectory */
|
||||||
|
static inline uint8_t DIR_IS_FILE_OR_SUBDIR(const dir_t* dir) {
|
||||||
|
return (dir->attributes & DIR_ATT_VOLUME_ID) == 0;
|
||||||
|
}
|
||||||
|
#endif // FatStructs_h
|
@ -0,0 +1,247 @@
|
|||||||
|
# Marlin Arduino Project Makefile
|
||||||
|
#
|
||||||
|
# Makefile Based on:
|
||||||
|
# Arduino 0011 Makefile
|
||||||
|
# Arduino adaptation by mellis, eighthave, oli.keller
|
||||||
|
#
|
||||||
|
# This has been tested with Arduino 0022.
|
||||||
|
#
|
||||||
|
# This makefile allows you to build sketches from the command line
|
||||||
|
# without the Arduino environment (or Java).
|
||||||
|
#
|
||||||
|
# Detailed instructions for using the makefile:
|
||||||
|
#
|
||||||
|
# 1. Modify the line containg "INSTALL_DIR" to point to the directory that
|
||||||
|
# contains the Arduino installation (for example, under Mac OS X, this
|
||||||
|
# might be /Applications/arduino-0012).
|
||||||
|
#
|
||||||
|
# 2. Modify the line containing "PORT" to refer to the filename
|
||||||
|
# representing the USB or serial connection to your Arduino board
|
||||||
|
# (e.g. PORT = /dev/tty.USB0). If the exact name of this file
|
||||||
|
# changes, you can use * as a wildcard (e.g. PORT = /dev/tty.usb*).
|
||||||
|
#
|
||||||
|
# 3. Set the line containing "MCU" to match your board's processor.
|
||||||
|
# Older one's are atmega8 based, newer ones like Arduino Mini, Bluetooth
|
||||||
|
# or Diecimila have the atmega168. If you're using a LilyPad Arduino,
|
||||||
|
# change F_CPU to 8000000.
|
||||||
|
#
|
||||||
|
# 4. Type "make" and press enter to compile/verify your program.
|
||||||
|
#
|
||||||
|
# 5. Type "make upload", reset your Arduino board, and press enter to
|
||||||
|
# upload your program to the Arduino board.
|
||||||
|
#
|
||||||
|
# $Id$
|
||||||
|
|
||||||
|
TARGET = Marlin
|
||||||
|
INSTALL_DIR = ../../Desktop/arduino-0018/
|
||||||
|
UPLOAD_RATE = 38400
|
||||||
|
AVRDUDE_PROGRAMMER = stk500v1
|
||||||
|
PORT = /dev/ttyUSB0
|
||||||
|
#MCU = atmega2560
|
||||||
|
#For "old" Arduino Mega
|
||||||
|
#MCU = atmega1280
|
||||||
|
#For Sanguinololu
|
||||||
|
MCU = atmega644p
|
||||||
|
F_CPU = 16000000
|
||||||
|
|
||||||
|
|
||||||
|
############################################################################
|
||||||
|
# Below here nothing should be changed...
|
||||||
|
|
||||||
|
ARDUINO = $(INSTALL_DIR)/hardware/Sanguino/cores/arduino
|
||||||
|
AVR_TOOLS_PATH = $(INSTALL_DIR)/hardware/tools/avr/bin
|
||||||
|
SRC = $(ARDUINO)/pins_arduino.c wiring.c wiring_serial.c \
|
||||||
|
$(ARDUINO)/wiring_analog.c $(ARDUINO)/wiring_digital.c \
|
||||||
|
$(ARDUINO)/wiring_pulse.c \
|
||||||
|
$(ARDUINO)/wiring_shift.c $(ARDUINO)/WInterrupts.c
|
||||||
|
CXXSRC = $(ARDUINO)/HardwareSerial.cpp $(ARDUINO)/WMath.cpp \
|
||||||
|
$(ARDUINO)/Print.cpp ./SdFile.cpp ./SdVolume.cpp ./Sd2Card.cpp
|
||||||
|
FORMAT = ihex
|
||||||
|
|
||||||
|
|
||||||
|
# Name of this Makefile (used for "make depend").
|
||||||
|
MAKEFILE = Makefile
|
||||||
|
|
||||||
|
# Debugging format.
|
||||||
|
# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
|
||||||
|
# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
|
||||||
|
DEBUG = stabs
|
||||||
|
|
||||||
|
OPT = s
|
||||||
|
|
||||||
|
# Place -D or -U options here
|
||||||
|
CDEFS = -DF_CPU=$(F_CPU)
|
||||||
|
CXXDEFS = -DF_CPU=$(F_CPU)
|
||||||
|
|
||||||
|
# Place -I options here
|
||||||
|
CINCS = -I$(ARDUINO)
|
||||||
|
CXXINCS = -I$(ARDUINO)
|
||||||
|
|
||||||
|
# Compiler flag to set the C Standard level.
|
||||||
|
# c89 - "ANSI" C
|
||||||
|
# gnu89 - c89 plus GCC extensions
|
||||||
|
# c99 - ISO C99 standard (not yet fully implemented)
|
||||||
|
# gnu99 - c99 plus GCC extensions
|
||||||
|
#CSTANDARD = -std=gnu99
|
||||||
|
CDEBUG = -g$(DEBUG)
|
||||||
|
CWARN = -Wall -Wunused-variable
|
||||||
|
CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums -w -ffunction-sections -fdata-sections -DARDUINO=22
|
||||||
|
#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
|
||||||
|
|
||||||
|
CFLAGS = $(CDEBUG) $(CDEFS) $(CINCS) -O$(OPT) $(CWARN) $(CEXTRA) $(CTUNING)
|
||||||
|
CXXFLAGS = $(CDEFS) $(CINCS) -O$(OPT) -Wall $(CEXTRA) $(CTUNING)
|
||||||
|
#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs
|
||||||
|
LDFLAGS = -lm
|
||||||
|
|
||||||
|
|
||||||
|
# Programming support using avrdude. Settings and variables.
|
||||||
|
AVRDUDE_PORT = $(PORT)
|
||||||
|
AVRDUDE_WRITE_FLASH = -U flash:w:applet/$(TARGET).hex:i
|
||||||
|
AVRDUDE_FLAGS = -D -C $(INSTALL_DIR)/hardware/tools/avrdude.conf \
|
||||||
|
-p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) \
|
||||||
|
-b $(UPLOAD_RATE)
|
||||||
|
|
||||||
|
# Program settings
|
||||||
|
CC = $(AVR_TOOLS_PATH)/avr-gcc
|
||||||
|
CXX = $(AVR_TOOLS_PATH)/avr-g++
|
||||||
|
OBJCOPY = $(AVR_TOOLS_PATH)/avr-objcopy
|
||||||
|
OBJDUMP = $(AVR_TOOLS_PATH)/avr-objdump
|
||||||
|
AR = $(AVR_TOOLS_PATH)/avr-ar
|
||||||
|
SIZE = $(AVR_TOOLS_PATH)/avr-size
|
||||||
|
NM = $(AVR_TOOLS_PATH)/avr-nm
|
||||||
|
AVRDUDE = $(INSTALL_DIR)/hardware/tools/avrdude
|
||||||
|
REMOVE = rm -f
|
||||||
|
MV = mv -f
|
||||||
|
|
||||||
|
# Define all object files.
|
||||||
|
OBJ = $(SRC:.c=.o) $(CXXSRC:.cpp=.o) $(ASRC:.S=.o)
|
||||||
|
|
||||||
|
# Define all listing files.
|
||||||
|
LST = $(ASRC:.S=.lst) $(CXXSRC:.cpp=.lst) $(SRC:.c=.lst)
|
||||||
|
|
||||||
|
# Combine all necessary flags and optional flags.
|
||||||
|
# Add target processor to flags.
|
||||||
|
ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
|
||||||
|
ALL_CXXFLAGS = -mmcu=$(MCU) -I. $(CXXFLAGS)
|
||||||
|
ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
|
||||||
|
|
||||||
|
|
||||||
|
# Default target.
|
||||||
|
all: applet_files_ez build sizeafter
|
||||||
|
|
||||||
|
build: elf hex
|
||||||
|
|
||||||
|
applet_files_ez: $(TARGET).pde
|
||||||
|
# Here is the "preprocessing".
|
||||||
|
# It creates a .cpp file based with the same name as the .pde file.
|
||||||
|
# On top of the new .cpp file comes the WProgram.h header.
|
||||||
|
# At the end there is a generic main() function attached.
|
||||||
|
# Then the .cpp file will be compiled. Errors during compile will
|
||||||
|
# refer to this new, automatically generated, file.
|
||||||
|
# Not the original .pde file you actually edit...
|
||||||
|
test -d applet || mkdir applet
|
||||||
|
echo '#include "WProgram.h"' > applet/$(TARGET).cpp
|
||||||
|
cat $(TARGET).pde >> applet/$(TARGET).cpp
|
||||||
|
cat $(ARDUINO)/main.cpp >> applet/$(TARGET).cpp
|
||||||
|
|
||||||
|
elf: applet/$(TARGET).elf
|
||||||
|
hex: applet/$(TARGET).hex
|
||||||
|
eep: applet/$(TARGET).eep
|
||||||
|
lss: applet/$(TARGET).lss
|
||||||
|
sym: applet/$(TARGET).sym
|
||||||
|
|
||||||
|
# Program the device.
|
||||||
|
upload: applet/$(TARGET).hex
|
||||||
|
$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH)
|
||||||
|
|
||||||
|
|
||||||
|
# Display size of file.
|
||||||
|
HEXSIZE = $(SIZE) --target=$(FORMAT) applet/$(TARGET).hex
|
||||||
|
ELFSIZE = $(SIZE) applet/$(TARGET).elf
|
||||||
|
sizebefore:
|
||||||
|
@if [ -f applet/$(TARGET).elf ]; then echo; echo $(MSG_SIZE_BEFORE); $(HEXSIZE); echo; fi
|
||||||
|
|
||||||
|
sizeafter:
|
||||||
|
@if [ -f applet/$(TARGET).elf ]; then echo; echo $(MSG_SIZE_AFTER); $(HEXSIZE); echo; fi
|
||||||
|
|
||||||
|
|
||||||
|
# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
|
||||||
|
COFFCONVERT=$(OBJCOPY) --debugging \
|
||||||
|
--change-section-address .data-0x800000 \
|
||||||
|
--change-section-address .bss-0x800000 \
|
||||||
|
--change-section-address .noinit-0x800000 \
|
||||||
|
--change-section-address .eeprom-0x810000
|
||||||
|
|
||||||
|
|
||||||
|
coff: applet/$(TARGET).elf
|
||||||
|
$(COFFCONVERT) -O coff-avr applet/$(TARGET).elf $(TARGET).cof
|
||||||
|
|
||||||
|
|
||||||
|
extcoff: $(TARGET).elf
|
||||||
|
$(COFFCONVERT) -O coff-ext-avr applet/$(TARGET).elf $(TARGET).cof
|
||||||
|
|
||||||
|
|
||||||
|
.SUFFIXES: .elf .hex .eep .lss .sym
|
||||||
|
|
||||||
|
.elf.hex:
|
||||||
|
$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
|
||||||
|
|
||||||
|
.elf.eep:
|
||||||
|
-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
|
||||||
|
--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
|
||||||
|
|
||||||
|
# Create extended listing file from ELF output file.
|
||||||
|
.elf.lss:
|
||||||
|
$(OBJDUMP) -h -S $< > $@
|
||||||
|
|
||||||
|
# Create a symbol table from ELF output file.
|
||||||
|
.elf.sym:
|
||||||
|
$(NM) -n $< > $@
|
||||||
|
|
||||||
|
# Link: create ELF output file from library.
|
||||||
|
applet/$(TARGET).elf: $(TARGET).pde applet/core.a
|
||||||
|
$(CC) $(ALL_CFLAGS) -Wl,--gc-sections -o $@ applet/$(TARGET).cpp -L. applet/core.a $(LDFLAGS)
|
||||||
|
|
||||||
|
applet/core.a: $(OBJ)
|
||||||
|
@for i in $(OBJ); do echo $(AR) rcs applet/core.a $$i; $(AR) rcs applet/core.a $$i; done
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# Compile: create object files from C++ source files.
|
||||||
|
.cpp.o:
|
||||||
|
$(CXX) -c $(ALL_CXXFLAGS) $< -o $@
|
||||||
|
|
||||||
|
# Compile: create object files from C source files.
|
||||||
|
.c.o:
|
||||||
|
$(CC) -c $(ALL_CFLAGS) $< -o $@
|
||||||
|
|
||||||
|
|
||||||
|
# Compile: create assembler files from C source files.
|
||||||
|
.c.s:
|
||||||
|
$(CC) -S $(ALL_CFLAGS) $< -o $@
|
||||||
|
|
||||||
|
|
||||||
|
# Assemble: create object files from assembler source files.
|
||||||
|
.S.o:
|
||||||
|
$(CC) -c $(ALL_ASFLAGS) $< -o $@
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# Target: clean project.
|
||||||
|
clean:
|
||||||
|
$(REMOVE) applet/$(TARGET).hex applet/$(TARGET).eep applet/$(TARGET).cof applet/$(TARGET).elf \
|
||||||
|
applet/$(TARGET).map applet/$(TARGET).sym applet/$(TARGET).lss applet/core.a \
|
||||||
|
$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(CXXSRC:.cpp=.s) $(CXXSRC:.cpp=.d)
|
||||||
|
|
||||||
|
depend:
|
||||||
|
if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
|
||||||
|
then \
|
||||||
|
sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
|
||||||
|
$(MAKEFILE).$$$$ && \
|
||||||
|
$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
|
||||||
|
fi
|
||||||
|
echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
|
||||||
|
>> $(MAKEFILE); \
|
||||||
|
$(CC) -M -mmcu=$(MCU) $(CDEFS) $(CINCS) $(SRC) $(ASRC) >> $(MAKEFILE)
|
||||||
|
|
||||||
|
.PHONY: all build elf hex eep lss sym program coff extcoff clean depend applet_files sizebefore sizeafter
|
@ -0,0 +1,107 @@
|
|||||||
|
// Tonokip RepRap firmware rewrite based off of Hydra-mmm firmware.
|
||||||
|
// Licence: GPL
|
||||||
|
#include <WProgram.h>
|
||||||
|
#include "fastio.h"
|
||||||
|
extern "C" void __cxa_pure_virtual();
|
||||||
|
void __cxa_pure_virtual(){};
|
||||||
|
void get_command();
|
||||||
|
void process_commands();
|
||||||
|
|
||||||
|
void manage_inactivity(byte debug);
|
||||||
|
|
||||||
|
void manage_heater();
|
||||||
|
int temp2analogu(int celsius, const short table[][2], int numtemps);
|
||||||
|
float analog2tempu(int raw, const short table[][2], int numtemps);
|
||||||
|
#ifdef HEATER_USES_THERMISTOR
|
||||||
|
#define HEATERSOURCE 1
|
||||||
|
#endif
|
||||||
|
#ifdef BED_USES_THERMISTOR
|
||||||
|
#define BEDSOURCE 1
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define temp2analogh( c ) temp2analogu((c),temptable,NUMTEMPS)
|
||||||
|
#define analog2temp( c ) analog2tempu((c),temptable,NUMTEMPS)
|
||||||
|
|
||||||
|
#if X_ENABLE_PIN > -1
|
||||||
|
#define enable_x() WRITE(X_ENABLE_PIN, X_ENABLE_ON)
|
||||||
|
#define disable_x() WRITE(X_ENABLE_PIN,!X_ENABLE_ON)
|
||||||
|
#else
|
||||||
|
#define enable_x() ;
|
||||||
|
#define disable_x() ;
|
||||||
|
#endif
|
||||||
|
#if Y_ENABLE_PIN > -1
|
||||||
|
#define enable_y() WRITE(Y_ENABLE_PIN, Y_ENABLE_ON)
|
||||||
|
#define disable_y() WRITE(Y_ENABLE_PIN,!Y_ENABLE_ON)
|
||||||
|
#else
|
||||||
|
#define enable_y() ;
|
||||||
|
#define disable_y() ;
|
||||||
|
#endif
|
||||||
|
#if Z_ENABLE_PIN > -1
|
||||||
|
#define enable_z() WRITE(Z_ENABLE_PIN, Z_ENABLE_ON)
|
||||||
|
#define disable_z() WRITE(Z_ENABLE_PIN,!Z_ENABLE_ON)
|
||||||
|
#else
|
||||||
|
#define enable_z() ;
|
||||||
|
#define disable_z() ;
|
||||||
|
#endif
|
||||||
|
#if E_ENABLE_PIN > -1
|
||||||
|
#define enable_e() WRITE(E_ENABLE_PIN, E_ENABLE_ON)
|
||||||
|
#define disable_e() WRITE(E_ENABLE_PIN,!E_ENABLE_ON)
|
||||||
|
#else
|
||||||
|
#define enable_e() ;
|
||||||
|
#define disable_e() ;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define X_AXIS 0
|
||||||
|
#define Y_AXIS 1
|
||||||
|
#define Z_AXIS 2
|
||||||
|
#define E_AXIS 3
|
||||||
|
|
||||||
|
void FlushSerialRequestResend();
|
||||||
|
void ClearToSend();
|
||||||
|
|
||||||
|
void get_coordinates();
|
||||||
|
void prepare_move();
|
||||||
|
void linear_move(unsigned long steps_remaining[]);
|
||||||
|
void do_step(int axis);
|
||||||
|
void kill(byte debug);
|
||||||
|
|
||||||
|
// This struct is used when buffering the setup for each linear movement "nominal" values are as specified in
|
||||||
|
// the source g-code and may never actually be reached if acceleration management is active.
|
||||||
|
typedef struct {
|
||||||
|
// Fields used by the bresenham algorithm for tracing the line
|
||||||
|
long steps_x, steps_y, steps_z, steps_e; // Step count along each axis
|
||||||
|
long step_event_count; // The number of step events required to complete this block
|
||||||
|
volatile long accelerate_until; // The index of the step event on which to stop acceleration
|
||||||
|
volatile long decelerate_after; // The index of the step event on which to start decelerating
|
||||||
|
volatile long acceleration_rate; // The acceleration rate used for acceleration calculation
|
||||||
|
unsigned char direction_bits; // The direction bit set for this block (refers to *_DIRECTION_BIT in config.h)
|
||||||
|
|
||||||
|
long advance_rate;
|
||||||
|
volatile long initial_advance;
|
||||||
|
volatile long final_advance;
|
||||||
|
float advance;
|
||||||
|
|
||||||
|
// Fields used by the motion planner to manage acceleration
|
||||||
|
float speed_x, speed_y, speed_z, speed_e; // Nominal mm/minute for each axis
|
||||||
|
float nominal_speed; // The nominal speed for this block in mm/min
|
||||||
|
float millimeters; // The total travel of this block in mm
|
||||||
|
float entry_speed;
|
||||||
|
|
||||||
|
// Settings for the trapezoid generator
|
||||||
|
long nominal_rate; // The nominal step rate for this block in step_events/sec
|
||||||
|
volatile long initial_rate; // The jerk-adjusted step rate at start of block
|
||||||
|
volatile long final_rate; // The minimal rate at exit
|
||||||
|
long acceleration; // acceleration mm/sec^2
|
||||||
|
volatile char busy;
|
||||||
|
} block_t;
|
||||||
|
|
||||||
|
void check_axes_activity();
|
||||||
|
void plan_init();
|
||||||
|
void st_init();
|
||||||
|
void tp_init();
|
||||||
|
void plan_buffer_line(float x, float y, float z, float e, float feed_rate);
|
||||||
|
void plan_set_position(float x, float y, float z, float e);
|
||||||
|
void st_wake_up();
|
||||||
|
void st_synchronize();
|
||||||
|
|
||||||
|
|
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,643 @@
|
|||||||
|
/* Arduino Sd2Card Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino Sd2Card Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino Sd2Card Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#include <WProgram.h>
|
||||||
|
#include "Sd2Card.h"
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#ifndef SOFTWARE_SPI
|
||||||
|
// functions for hardware SPI
|
||||||
|
/** Send a byte to the card */
|
||||||
|
static void spiSend(uint8_t b) {
|
||||||
|
SPDR = b;
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
}
|
||||||
|
/** Receive a byte from the card */
|
||||||
|
static uint8_t spiRec(void) {
|
||||||
|
spiSend(0XFF);
|
||||||
|
return SPDR;
|
||||||
|
}
|
||||||
|
#else // SOFTWARE_SPI
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** nop to tune soft SPI timing */
|
||||||
|
#define nop asm volatile ("nop\n\t")
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Soft SPI receive */
|
||||||
|
uint8_t spiRec(void) {
|
||||||
|
uint8_t data = 0;
|
||||||
|
// no interrupts during byte receive - about 8 us
|
||||||
|
cli();
|
||||||
|
// output pin high - like sending 0XFF
|
||||||
|
fastDigitalWrite(SPI_MOSI_PIN, HIGH);
|
||||||
|
|
||||||
|
for (uint8_t i = 0; i < 8; i++) {
|
||||||
|
fastDigitalWrite(SPI_SCK_PIN, HIGH);
|
||||||
|
|
||||||
|
// adjust so SCK is nice
|
||||||
|
nop;
|
||||||
|
nop;
|
||||||
|
|
||||||
|
data <<= 1;
|
||||||
|
|
||||||
|
if (fastDigitalRead(SPI_MISO_PIN)) data |= 1;
|
||||||
|
|
||||||
|
fastDigitalWrite(SPI_SCK_PIN, LOW);
|
||||||
|
}
|
||||||
|
// enable interrupts
|
||||||
|
sei();
|
||||||
|
return data;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Soft SPI send */
|
||||||
|
void spiSend(uint8_t data) {
|
||||||
|
// no interrupts during byte send - about 8 us
|
||||||
|
cli();
|
||||||
|
for (uint8_t i = 0; i < 8; i++) {
|
||||||
|
fastDigitalWrite(SPI_SCK_PIN, LOW);
|
||||||
|
|
||||||
|
fastDigitalWrite(SPI_MOSI_PIN, data & 0X80);
|
||||||
|
|
||||||
|
data <<= 1;
|
||||||
|
|
||||||
|
fastDigitalWrite(SPI_SCK_PIN, HIGH);
|
||||||
|
}
|
||||||
|
// hold SCK high for a few ns
|
||||||
|
nop;
|
||||||
|
nop;
|
||||||
|
nop;
|
||||||
|
nop;
|
||||||
|
|
||||||
|
fastDigitalWrite(SPI_SCK_PIN, LOW);
|
||||||
|
// enable interrupts
|
||||||
|
sei();
|
||||||
|
}
|
||||||
|
#endif // SOFTWARE_SPI
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// send command and return error code. Return zero for OK
|
||||||
|
uint8_t Sd2Card::cardCommand(uint8_t cmd, uint32_t arg) {
|
||||||
|
// end read if in partialBlockRead mode
|
||||||
|
readEnd();
|
||||||
|
|
||||||
|
// select card
|
||||||
|
chipSelectLow();
|
||||||
|
|
||||||
|
// wait up to 300 ms if busy
|
||||||
|
waitNotBusy(300);
|
||||||
|
|
||||||
|
// send command
|
||||||
|
spiSend(cmd | 0x40);
|
||||||
|
|
||||||
|
// send argument
|
||||||
|
for (int8_t s = 24; s >= 0; s -= 8) spiSend(arg >> s);
|
||||||
|
|
||||||
|
// send CRC
|
||||||
|
uint8_t crc = 0XFF;
|
||||||
|
if (cmd == CMD0) crc = 0X95; // correct crc for CMD0 with arg 0
|
||||||
|
if (cmd == CMD8) crc = 0X87; // correct crc for CMD8 with arg 0X1AA
|
||||||
|
spiSend(crc);
|
||||||
|
|
||||||
|
// wait for response
|
||||||
|
for (uint8_t i = 0; ((status_ = spiRec()) & 0X80) && i != 0XFF; i++);
|
||||||
|
return status_;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Determine the size of an SD flash memory card.
|
||||||
|
*
|
||||||
|
* \return The number of 512 byte data blocks in the card
|
||||||
|
* or zero if an error occurs.
|
||||||
|
*/
|
||||||
|
uint32_t Sd2Card::cardSize(void) {
|
||||||
|
csd_t csd;
|
||||||
|
if (!readCSD(&csd)) return 0;
|
||||||
|
if (csd.v1.csd_ver == 0) {
|
||||||
|
uint8_t read_bl_len = csd.v1.read_bl_len;
|
||||||
|
uint16_t c_size = (csd.v1.c_size_high << 10)
|
||||||
|
| (csd.v1.c_size_mid << 2) | csd.v1.c_size_low;
|
||||||
|
uint8_t c_size_mult = (csd.v1.c_size_mult_high << 1)
|
||||||
|
| csd.v1.c_size_mult_low;
|
||||||
|
return (uint32_t)(c_size + 1) << (c_size_mult + read_bl_len - 7);
|
||||||
|
} else if (csd.v2.csd_ver == 1) {
|
||||||
|
uint32_t c_size = ((uint32_t)csd.v2.c_size_high << 16)
|
||||||
|
| (csd.v2.c_size_mid << 8) | csd.v2.c_size_low;
|
||||||
|
return (c_size + 1) << 10;
|
||||||
|
} else {
|
||||||
|
error(SD_CARD_ERROR_BAD_CSD);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
void Sd2Card::chipSelectHigh(void) {
|
||||||
|
digitalWrite(chipSelectPin_, HIGH);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
void Sd2Card::chipSelectLow(void) {
|
||||||
|
digitalWrite(chipSelectPin_, LOW);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Erase a range of blocks.
|
||||||
|
*
|
||||||
|
* \param[in] firstBlock The address of the first block in the range.
|
||||||
|
* \param[in] lastBlock The address of the last block in the range.
|
||||||
|
*
|
||||||
|
* \note This function requests the SD card to do a flash erase for a
|
||||||
|
* range of blocks. The data on the card after an erase operation is
|
||||||
|
* either 0 or 1, depends on the card vendor. The card must support
|
||||||
|
* single block erase.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::erase(uint32_t firstBlock, uint32_t lastBlock) {
|
||||||
|
if (!eraseSingleBlockEnable()) {
|
||||||
|
error(SD_CARD_ERROR_ERASE_SINGLE_BLOCK);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if (type_ != SD_CARD_TYPE_SDHC) {
|
||||||
|
firstBlock <<= 9;
|
||||||
|
lastBlock <<= 9;
|
||||||
|
}
|
||||||
|
if (cardCommand(CMD32, firstBlock)
|
||||||
|
|| cardCommand(CMD33, lastBlock)
|
||||||
|
|| cardCommand(CMD38, 0)) {
|
||||||
|
error(SD_CARD_ERROR_ERASE);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if (!waitNotBusy(SD_ERASE_TIMEOUT)) {
|
||||||
|
error(SD_CARD_ERROR_ERASE_TIMEOUT);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
chipSelectHigh();
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Determine if card supports single block erase.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned if single block erase is supported.
|
||||||
|
* The value zero, false, is returned if single block erase is not supported.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::eraseSingleBlockEnable(void) {
|
||||||
|
csd_t csd;
|
||||||
|
return readCSD(&csd) ? csd.v1.erase_blk_en : 0;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Initialize an SD flash memory card.
|
||||||
|
*
|
||||||
|
* \param[in] sckRateID SPI clock rate selector. See setSckRate().
|
||||||
|
* \param[in] chipSelectPin SD chip select pin number.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure. The reason for failure
|
||||||
|
* can be determined by calling errorCode() and errorData().
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin) {
|
||||||
|
errorCode_ = inBlock_ = partialBlockRead_ = type_ = 0;
|
||||||
|
chipSelectPin_ = chipSelectPin;
|
||||||
|
// 16-bit init start time allows over a minute
|
||||||
|
uint16_t t0 = (uint16_t)millis();
|
||||||
|
uint32_t arg;
|
||||||
|
|
||||||
|
// set pin modes
|
||||||
|
pinMode(chipSelectPin_, OUTPUT);
|
||||||
|
chipSelectHigh();
|
||||||
|
pinMode(SPI_MISO_PIN, INPUT);
|
||||||
|
pinMode(SPI_MOSI_PIN, OUTPUT);
|
||||||
|
pinMode(SPI_SCK_PIN, OUTPUT);
|
||||||
|
|
||||||
|
#ifndef SOFTWARE_SPI
|
||||||
|
// SS must be in output mode even it is not chip select
|
||||||
|
pinMode(SS_PIN, OUTPUT);
|
||||||
|
// Enable SPI, Master, clock rate f_osc/128
|
||||||
|
SPCR = (1 << SPE) | (1 << MSTR) | (1 << SPR1) | (1 << SPR0);
|
||||||
|
// clear double speed
|
||||||
|
SPSR &= ~(1 << SPI2X);
|
||||||
|
#endif // SOFTWARE_SPI
|
||||||
|
|
||||||
|
// must supply min of 74 clock cycles with CS high.
|
||||||
|
for (uint8_t i = 0; i < 10; i++) spiSend(0XFF);
|
||||||
|
|
||||||
|
chipSelectLow();
|
||||||
|
|
||||||
|
// command to go idle in SPI mode
|
||||||
|
while ((status_ = cardCommand(CMD0, 0)) != R1_IDLE_STATE) {
|
||||||
|
if (((uint16_t)millis() - t0) > SD_INIT_TIMEOUT) {
|
||||||
|
error(SD_CARD_ERROR_CMD0);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// check SD version
|
||||||
|
if ((cardCommand(CMD8, 0x1AA) & R1_ILLEGAL_COMMAND)) {
|
||||||
|
type(SD_CARD_TYPE_SD1);
|
||||||
|
} else {
|
||||||
|
// only need last byte of r7 response
|
||||||
|
for (uint8_t i = 0; i < 4; i++) status_ = spiRec();
|
||||||
|
if (status_ != 0XAA) {
|
||||||
|
error(SD_CARD_ERROR_CMD8);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
type(SD_CARD_TYPE_SD2);
|
||||||
|
}
|
||||||
|
// initialize card and send host supports SDHC if SD2
|
||||||
|
arg = type() == SD_CARD_TYPE_SD2 ? 0X40000000 : 0;
|
||||||
|
|
||||||
|
while ((status_ = cardAcmd(ACMD41, arg)) != R1_READY_STATE) {
|
||||||
|
// check for timeout
|
||||||
|
if (((uint16_t)millis() - t0) > SD_INIT_TIMEOUT) {
|
||||||
|
error(SD_CARD_ERROR_ACMD41);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// if SD2 read OCR register to check for SDHC card
|
||||||
|
if (type() == SD_CARD_TYPE_SD2) {
|
||||||
|
if (cardCommand(CMD58, 0)) {
|
||||||
|
error(SD_CARD_ERROR_CMD58);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if ((spiRec() & 0XC0) == 0XC0) type(SD_CARD_TYPE_SDHC);
|
||||||
|
// discard rest of ocr - contains allowed voltage range
|
||||||
|
for (uint8_t i = 0; i < 3; i++) spiRec();
|
||||||
|
}
|
||||||
|
chipSelectHigh();
|
||||||
|
|
||||||
|
#ifndef SOFTWARE_SPI
|
||||||
|
return setSckRate(sckRateID);
|
||||||
|
#else // SOFTWARE_SPI
|
||||||
|
return true;
|
||||||
|
#endif // SOFTWARE_SPI
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Enable or disable partial block reads.
|
||||||
|
*
|
||||||
|
* Enabling partial block reads improves performance by allowing a block
|
||||||
|
* to be read over the SPI bus as several sub-blocks. Errors may occur
|
||||||
|
* if the time between reads is too long since the SD card may timeout.
|
||||||
|
* The SPI SS line will be held low until the entire block is read or
|
||||||
|
* readEnd() is called.
|
||||||
|
*
|
||||||
|
* Use this for applications like the Adafruit Wave Shield.
|
||||||
|
*
|
||||||
|
* \param[in] value The value TRUE (non-zero) or FALSE (zero).)
|
||||||
|
*/
|
||||||
|
void Sd2Card::partialBlockRead(uint8_t value) {
|
||||||
|
readEnd();
|
||||||
|
partialBlockRead_ = value;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Read a 512 byte block from an SD card device.
|
||||||
|
*
|
||||||
|
* \param[in] block Logical block to be read.
|
||||||
|
* \param[out] dst Pointer to the location that will receive the data.
|
||||||
|
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::readBlock(uint32_t block, uint8_t* dst) {
|
||||||
|
return readData(block, 0, 512, dst);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Read part of a 512 byte block from an SD card.
|
||||||
|
*
|
||||||
|
* \param[in] block Logical block to be read.
|
||||||
|
* \param[in] offset Number of bytes to skip at start of block
|
||||||
|
* \param[out] dst Pointer to the location that will receive the data.
|
||||||
|
* \param[in] count Number of bytes to read
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::readData(uint32_t block,
|
||||||
|
uint16_t offset, uint16_t count, uint8_t* dst) {
|
||||||
|
uint16_t n;
|
||||||
|
if (count == 0) return true;
|
||||||
|
if ((count + offset) > 512) {
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if (!inBlock_ || block != block_ || offset < offset_) {
|
||||||
|
block_ = block;
|
||||||
|
// use address if not SDHC card
|
||||||
|
if (type()!= SD_CARD_TYPE_SDHC) block <<= 9;
|
||||||
|
if (cardCommand(CMD17, block)) {
|
||||||
|
error(SD_CARD_ERROR_CMD17);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if (!waitStartBlock()) {
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
offset_ = 0;
|
||||||
|
inBlock_ = 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
#ifdef OPTIMIZE_HARDWARE_SPI
|
||||||
|
// start first spi transfer
|
||||||
|
SPDR = 0XFF;
|
||||||
|
|
||||||
|
// skip data before offset
|
||||||
|
for (;offset_ < offset; offset_++) {
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
SPDR = 0XFF;
|
||||||
|
}
|
||||||
|
// transfer data
|
||||||
|
n = count - 1;
|
||||||
|
for (uint16_t i = 0; i < n; i++) {
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
dst[i] = SPDR;
|
||||||
|
SPDR = 0XFF;
|
||||||
|
}
|
||||||
|
// wait for last byte
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
dst[n] = SPDR;
|
||||||
|
|
||||||
|
#else // OPTIMIZE_HARDWARE_SPI
|
||||||
|
|
||||||
|
// skip data before offset
|
||||||
|
for (;offset_ < offset; offset_++) {
|
||||||
|
spiRec();
|
||||||
|
}
|
||||||
|
// transfer data
|
||||||
|
for (uint16_t i = 0; i < count; i++) {
|
||||||
|
dst[i] = spiRec();
|
||||||
|
}
|
||||||
|
#endif // OPTIMIZE_HARDWARE_SPI
|
||||||
|
|
||||||
|
offset_ += count;
|
||||||
|
if (!partialBlockRead_ || offset_ >= 512) {
|
||||||
|
// read rest of data, checksum and set chip select high
|
||||||
|
readEnd();
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Skip remaining data in a block when in partial block read mode. */
|
||||||
|
void Sd2Card::readEnd(void) {
|
||||||
|
if (inBlock_) {
|
||||||
|
// skip data and crc
|
||||||
|
#ifdef OPTIMIZE_HARDWARE_SPI
|
||||||
|
// optimize skip for hardware
|
||||||
|
SPDR = 0XFF;
|
||||||
|
while (offset_++ < 513) {
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
SPDR = 0XFF;
|
||||||
|
}
|
||||||
|
// wait for last crc byte
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
#else // OPTIMIZE_HARDWARE_SPI
|
||||||
|
while (offset_++ < 514) spiRec();
|
||||||
|
#endif // OPTIMIZE_HARDWARE_SPI
|
||||||
|
chipSelectHigh();
|
||||||
|
inBlock_ = 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** read CID or CSR register */
|
||||||
|
uint8_t Sd2Card::readRegister(uint8_t cmd, void* buf) {
|
||||||
|
uint8_t* dst = reinterpret_cast<uint8_t*>(buf);
|
||||||
|
if (cardCommand(cmd, 0)) {
|
||||||
|
error(SD_CARD_ERROR_READ_REG);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if (!waitStartBlock()) goto fail;
|
||||||
|
// transfer data
|
||||||
|
for (uint16_t i = 0; i < 16; i++) dst[i] = spiRec();
|
||||||
|
spiRec(); // get first crc byte
|
||||||
|
spiRec(); // get second crc byte
|
||||||
|
chipSelectHigh();
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Set the SPI clock rate.
|
||||||
|
*
|
||||||
|
* \param[in] sckRateID A value in the range [0, 6].
|
||||||
|
*
|
||||||
|
* The SPI clock will be set to F_CPU/pow(2, 1 + sckRateID). The maximum
|
||||||
|
* SPI rate is F_CPU/2 for \a sckRateID = 0 and the minimum rate is F_CPU/128
|
||||||
|
* for \a scsRateID = 6.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and the value zero,
|
||||||
|
* false, is returned for an invalid value of \a sckRateID.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::setSckRate(uint8_t sckRateID) {
|
||||||
|
if (sckRateID > 6) {
|
||||||
|
error(SD_CARD_ERROR_SCK_RATE);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
// see avr processor datasheet for SPI register bit definitions
|
||||||
|
if ((sckRateID & 1) || sckRateID == 6) {
|
||||||
|
SPSR &= ~(1 << SPI2X);
|
||||||
|
} else {
|
||||||
|
SPSR |= (1 << SPI2X);
|
||||||
|
}
|
||||||
|
SPCR &= ~((1 <<SPR1) | (1 << SPR0));
|
||||||
|
SPCR |= (sckRateID & 4 ? (1 << SPR1) : 0)
|
||||||
|
| (sckRateID & 2 ? (1 << SPR0) : 0);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// wait for card to go not busy
|
||||||
|
uint8_t Sd2Card::waitNotBusy(uint16_t timeoutMillis) {
|
||||||
|
uint16_t t0 = millis();
|
||||||
|
do {
|
||||||
|
if (spiRec() == 0XFF) return true;
|
||||||
|
}
|
||||||
|
while (((uint16_t)millis() - t0) < timeoutMillis);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Wait for start block token */
|
||||||
|
uint8_t Sd2Card::waitStartBlock(void) {
|
||||||
|
uint16_t t0 = millis();
|
||||||
|
while ((status_ = spiRec()) == 0XFF) {
|
||||||
|
if (((uint16_t)millis() - t0) > SD_READ_TIMEOUT) {
|
||||||
|
error(SD_CARD_ERROR_READ_TIMEOUT);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (status_ != DATA_START_BLOCK) {
|
||||||
|
error(SD_CARD_ERROR_READ);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Writes a 512 byte block to an SD card.
|
||||||
|
*
|
||||||
|
* \param[in] blockNumber Logical block to be written.
|
||||||
|
* \param[in] src Pointer to the location of the data to be written.
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::writeBlock(uint32_t blockNumber, const uint8_t* src) {
|
||||||
|
#if SD_PROTECT_BLOCK_ZERO
|
||||||
|
// don't allow write to first block
|
||||||
|
if (blockNumber == 0) {
|
||||||
|
error(SD_CARD_ERROR_WRITE_BLOCK_ZERO);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
#endif // SD_PROTECT_BLOCK_ZERO
|
||||||
|
|
||||||
|
// use address if not SDHC card
|
||||||
|
if (type() != SD_CARD_TYPE_SDHC) blockNumber <<= 9;
|
||||||
|
if (cardCommand(CMD24, blockNumber)) {
|
||||||
|
error(SD_CARD_ERROR_CMD24);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
if (!writeData(DATA_START_BLOCK, src)) goto fail;
|
||||||
|
|
||||||
|
// wait for flash programming to complete
|
||||||
|
if (!waitNotBusy(SD_WRITE_TIMEOUT)) {
|
||||||
|
error(SD_CARD_ERROR_WRITE_TIMEOUT);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
// response is r2 so get and check two bytes for nonzero
|
||||||
|
if (cardCommand(CMD13, 0) || spiRec()) {
|
||||||
|
error(SD_CARD_ERROR_WRITE_PROGRAMMING);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
chipSelectHigh();
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Write one data block in a multiple block write sequence */
|
||||||
|
uint8_t Sd2Card::writeData(const uint8_t* src) {
|
||||||
|
// wait for previous write to finish
|
||||||
|
if (!waitNotBusy(SD_WRITE_TIMEOUT)) {
|
||||||
|
error(SD_CARD_ERROR_WRITE_MULTIPLE);
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
return writeData(WRITE_MULTIPLE_TOKEN, src);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// send one block of data for write block or write multiple blocks
|
||||||
|
uint8_t Sd2Card::writeData(uint8_t token, const uint8_t* src) {
|
||||||
|
#ifdef OPTIMIZE_HARDWARE_SPI
|
||||||
|
|
||||||
|
// send data - optimized loop
|
||||||
|
SPDR = token;
|
||||||
|
|
||||||
|
// send two byte per iteration
|
||||||
|
for (uint16_t i = 0; i < 512; i += 2) {
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
SPDR = src[i];
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
SPDR = src[i+1];
|
||||||
|
}
|
||||||
|
|
||||||
|
// wait for last data byte
|
||||||
|
while (!(SPSR & (1 << SPIF)));
|
||||||
|
|
||||||
|
#else // OPTIMIZE_HARDWARE_SPI
|
||||||
|
spiSend(token);
|
||||||
|
for (uint16_t i = 0; i < 512; i++) {
|
||||||
|
spiSend(src[i]);
|
||||||
|
}
|
||||||
|
#endif // OPTIMIZE_HARDWARE_SPI
|
||||||
|
spiSend(0xff); // dummy crc
|
||||||
|
spiSend(0xff); // dummy crc
|
||||||
|
|
||||||
|
status_ = spiRec();
|
||||||
|
if ((status_ & DATA_RES_MASK) != DATA_RES_ACCEPTED) {
|
||||||
|
error(SD_CARD_ERROR_WRITE);
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Start a write multiple blocks sequence.
|
||||||
|
*
|
||||||
|
* \param[in] blockNumber Address of first block in sequence.
|
||||||
|
* \param[in] eraseCount The number of blocks to be pre-erased.
|
||||||
|
*
|
||||||
|
* \note This function is used with writeData() and writeStop()
|
||||||
|
* for optimized multiple block writes.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::writeStart(uint32_t blockNumber, uint32_t eraseCount) {
|
||||||
|
#if SD_PROTECT_BLOCK_ZERO
|
||||||
|
// don't allow write to first block
|
||||||
|
if (blockNumber == 0) {
|
||||||
|
error(SD_CARD_ERROR_WRITE_BLOCK_ZERO);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
#endif // SD_PROTECT_BLOCK_ZERO
|
||||||
|
// send pre-erase count
|
||||||
|
if (cardAcmd(ACMD23, eraseCount)) {
|
||||||
|
error(SD_CARD_ERROR_ACMD23);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
// use address if not SDHC card
|
||||||
|
if (type() != SD_CARD_TYPE_SDHC) blockNumber <<= 9;
|
||||||
|
if (cardCommand(CMD25, blockNumber)) {
|
||||||
|
error(SD_CARD_ERROR_CMD25);
|
||||||
|
goto fail;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** End a write multiple blocks sequence.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t Sd2Card::writeStop(void) {
|
||||||
|
if (!waitNotBusy(SD_WRITE_TIMEOUT)) goto fail;
|
||||||
|
spiSend(STOP_TRAN_TOKEN);
|
||||||
|
if (!waitNotBusy(SD_WRITE_TIMEOUT)) goto fail;
|
||||||
|
chipSelectHigh();
|
||||||
|
return true;
|
||||||
|
|
||||||
|
fail:
|
||||||
|
error(SD_CARD_ERROR_STOP_TRAN);
|
||||||
|
chipSelectHigh();
|
||||||
|
return false;
|
||||||
|
}
|
@ -0,0 +1,233 @@
|
|||||||
|
/* Arduino Sd2Card Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino Sd2Card Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino Sd2Card Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#ifndef Sd2Card_h
|
||||||
|
#define Sd2Card_h
|
||||||
|
/**
|
||||||
|
* \file
|
||||||
|
* Sd2Card class
|
||||||
|
*/
|
||||||
|
#include "Sd2PinMap.h"
|
||||||
|
#include "SdInfo.h"
|
||||||
|
/** Set SCK to max rate of F_CPU/2. See Sd2Card::setSckRate(). */
|
||||||
|
uint8_t const SPI_FULL_SPEED = 0;
|
||||||
|
/** Set SCK rate to F_CPU/4. See Sd2Card::setSckRate(). */
|
||||||
|
uint8_t const SPI_HALF_SPEED = 1;
|
||||||
|
/** Set SCK rate to F_CPU/8. Sd2Card::setSckRate(). */
|
||||||
|
uint8_t const SPI_QUARTER_SPEED = 2;
|
||||||
|
/**
|
||||||
|
* Define MEGA_SOFT_SPI non-zero to use software SPI on Mega Arduinos.
|
||||||
|
* Pins used are SS 10, MOSI 11, MISO 12, and SCK 13.
|
||||||
|
*
|
||||||
|
* MEGA_SOFT_SPI allows an unmodified Adafruit GPS Shield to be used
|
||||||
|
* on Mega Arduinos. Software SPI works well with GPS Shield V1.1
|
||||||
|
* but many SD cards will fail with GPS Shield V1.0.
|
||||||
|
*/
|
||||||
|
#define MEGA_SOFT_SPI 0
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#if MEGA_SOFT_SPI && (defined(__AVR_ATmega1280__)||defined(__AVR_ATmega2560__))
|
||||||
|
#define SOFTWARE_SPI
|
||||||
|
#endif // MEGA_SOFT_SPI
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// SPI pin definitions
|
||||||
|
//
|
||||||
|
#ifndef SOFTWARE_SPI
|
||||||
|
// hardware pin defs
|
||||||
|
/**
|
||||||
|
* SD Chip Select pin
|
||||||
|
*
|
||||||
|
* Warning if this pin is redefined the hardware SS will pin will be enabled
|
||||||
|
* as an output by init(). An avr processor will not function as an SPI
|
||||||
|
* master unless SS is set to output mode.
|
||||||
|
*/
|
||||||
|
/** The default chip select pin for the SD card is SS. */
|
||||||
|
uint8_t const SD_CHIP_SELECT_PIN = SS_PIN;
|
||||||
|
// The following three pins must not be redefined for hardware SPI.
|
||||||
|
/** SPI Master Out Slave In pin */
|
||||||
|
uint8_t const SPI_MOSI_PIN = MOSI_PIN;
|
||||||
|
/** SPI Master In Slave Out pin */
|
||||||
|
uint8_t const SPI_MISO_PIN = MISO_PIN;
|
||||||
|
/** SPI Clock pin */
|
||||||
|
uint8_t const SPI_SCK_PIN = SCK_PIN;
|
||||||
|
/** optimize loops for hardware SPI */
|
||||||
|
#define OPTIMIZE_HARDWARE_SPI
|
||||||
|
|
||||||
|
#else // SOFTWARE_SPI
|
||||||
|
// define software SPI pins so Mega can use unmodified GPS Shield
|
||||||
|
/** SPI chip select pin */
|
||||||
|
uint8_t const SD_CHIP_SELECT_PIN = 10;
|
||||||
|
/** SPI Master Out Slave In pin */
|
||||||
|
uint8_t const SPI_MOSI_PIN = 11;
|
||||||
|
/** SPI Master In Slave Out pin */
|
||||||
|
uint8_t const SPI_MISO_PIN = 12;
|
||||||
|
/** SPI Clock pin */
|
||||||
|
uint8_t const SPI_SCK_PIN = 13;
|
||||||
|
#endif // SOFTWARE_SPI
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Protect block zero from write if nonzero */
|
||||||
|
#define SD_PROTECT_BLOCK_ZERO 1
|
||||||
|
/** init timeout ms */
|
||||||
|
uint16_t const SD_INIT_TIMEOUT = 2000;
|
||||||
|
/** erase timeout ms */
|
||||||
|
uint16_t const SD_ERASE_TIMEOUT = 10000;
|
||||||
|
/** read timeout ms */
|
||||||
|
uint16_t const SD_READ_TIMEOUT = 300;
|
||||||
|
/** write time out ms */
|
||||||
|
uint16_t const SD_WRITE_TIMEOUT = 600;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// SD card errors
|
||||||
|
/** timeout error for command CMD0 */
|
||||||
|
uint8_t const SD_CARD_ERROR_CMD0 = 0X1;
|
||||||
|
/** CMD8 was not accepted - not a valid SD card*/
|
||||||
|
uint8_t const SD_CARD_ERROR_CMD8 = 0X2;
|
||||||
|
/** card returned an error response for CMD17 (read block) */
|
||||||
|
uint8_t const SD_CARD_ERROR_CMD17 = 0X3;
|
||||||
|
/** card returned an error response for CMD24 (write block) */
|
||||||
|
uint8_t const SD_CARD_ERROR_CMD24 = 0X4;
|
||||||
|
/** WRITE_MULTIPLE_BLOCKS command failed */
|
||||||
|
uint8_t const SD_CARD_ERROR_CMD25 = 0X05;
|
||||||
|
/** card returned an error response for CMD58 (read OCR) */
|
||||||
|
uint8_t const SD_CARD_ERROR_CMD58 = 0X06;
|
||||||
|
/** SET_WR_BLK_ERASE_COUNT failed */
|
||||||
|
uint8_t const SD_CARD_ERROR_ACMD23 = 0X07;
|
||||||
|
/** card's ACMD41 initialization process timeout */
|
||||||
|
uint8_t const SD_CARD_ERROR_ACMD41 = 0X08;
|
||||||
|
/** card returned a bad CSR version field */
|
||||||
|
uint8_t const SD_CARD_ERROR_BAD_CSD = 0X09;
|
||||||
|
/** erase block group command failed */
|
||||||
|
uint8_t const SD_CARD_ERROR_ERASE = 0X0A;
|
||||||
|
/** card not capable of single block erase */
|
||||||
|
uint8_t const SD_CARD_ERROR_ERASE_SINGLE_BLOCK = 0X0B;
|
||||||
|
/** Erase sequence timed out */
|
||||||
|
uint8_t const SD_CARD_ERROR_ERASE_TIMEOUT = 0X0C;
|
||||||
|
/** card returned an error token instead of read data */
|
||||||
|
uint8_t const SD_CARD_ERROR_READ = 0X0D;
|
||||||
|
/** read CID or CSD failed */
|
||||||
|
uint8_t const SD_CARD_ERROR_READ_REG = 0X0E;
|
||||||
|
/** timeout while waiting for start of read data */
|
||||||
|
uint8_t const SD_CARD_ERROR_READ_TIMEOUT = 0X0F;
|
||||||
|
/** card did not accept STOP_TRAN_TOKEN */
|
||||||
|
uint8_t const SD_CARD_ERROR_STOP_TRAN = 0X10;
|
||||||
|
/** card returned an error token as a response to a write operation */
|
||||||
|
uint8_t const SD_CARD_ERROR_WRITE = 0X11;
|
||||||
|
/** attempt to write protected block zero */
|
||||||
|
uint8_t const SD_CARD_ERROR_WRITE_BLOCK_ZERO = 0X12;
|
||||||
|
/** card did not go ready for a multiple block write */
|
||||||
|
uint8_t const SD_CARD_ERROR_WRITE_MULTIPLE = 0X13;
|
||||||
|
/** card returned an error to a CMD13 status check after a write */
|
||||||
|
uint8_t const SD_CARD_ERROR_WRITE_PROGRAMMING = 0X14;
|
||||||
|
/** timeout occurred during write programming */
|
||||||
|
uint8_t const SD_CARD_ERROR_WRITE_TIMEOUT = 0X15;
|
||||||
|
/** incorrect rate selected */
|
||||||
|
uint8_t const SD_CARD_ERROR_SCK_RATE = 0X16;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// card types
|
||||||
|
/** Standard capacity V1 SD card */
|
||||||
|
uint8_t const SD_CARD_TYPE_SD1 = 1;
|
||||||
|
/** Standard capacity V2 SD card */
|
||||||
|
uint8_t const SD_CARD_TYPE_SD2 = 2;
|
||||||
|
/** High Capacity SD card */
|
||||||
|
uint8_t const SD_CARD_TYPE_SDHC = 3;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \class Sd2Card
|
||||||
|
* \brief Raw access to SD and SDHC flash memory cards.
|
||||||
|
*/
|
||||||
|
class Sd2Card {
|
||||||
|
public:
|
||||||
|
/** Construct an instance of Sd2Card. */
|
||||||
|
Sd2Card(void) : errorCode_(0), inBlock_(0), partialBlockRead_(0), type_(0) {}
|
||||||
|
uint32_t cardSize(void);
|
||||||
|
uint8_t erase(uint32_t firstBlock, uint32_t lastBlock);
|
||||||
|
uint8_t eraseSingleBlockEnable(void);
|
||||||
|
/**
|
||||||
|
* \return error code for last error. See Sd2Card.h for a list of error codes.
|
||||||
|
*/
|
||||||
|
uint8_t errorCode(void) const {return errorCode_;}
|
||||||
|
/** \return error data for last error. */
|
||||||
|
uint8_t errorData(void) const {return status_;}
|
||||||
|
/**
|
||||||
|
* Initialize an SD flash memory card with default clock rate and chip
|
||||||
|
* select pin. See sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin).
|
||||||
|
*/
|
||||||
|
uint8_t init(void) {
|
||||||
|
return init(SPI_FULL_SPEED, SD_CHIP_SELECT_PIN);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Initialize an SD flash memory card with the selected SPI clock rate
|
||||||
|
* and the default SD chip select pin.
|
||||||
|
* See sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin).
|
||||||
|
*/
|
||||||
|
uint8_t init(uint8_t sckRateID) {
|
||||||
|
return init(sckRateID, SD_CHIP_SELECT_PIN);
|
||||||
|
}
|
||||||
|
uint8_t init(uint8_t sckRateID, uint8_t chipSelectPin);
|
||||||
|
void partialBlockRead(uint8_t value);
|
||||||
|
/** Returns the current value, true or false, for partial block read. */
|
||||||
|
uint8_t partialBlockRead(void) const {return partialBlockRead_;}
|
||||||
|
uint8_t readBlock(uint32_t block, uint8_t* dst);
|
||||||
|
uint8_t readData(uint32_t block,
|
||||||
|
uint16_t offset, uint16_t count, uint8_t* dst);
|
||||||
|
/**
|
||||||
|
* Read a cards CID register. The CID contains card identification
|
||||||
|
* information such as Manufacturer ID, Product name, Product serial
|
||||||
|
* number and Manufacturing date. */
|
||||||
|
uint8_t readCID(cid_t* cid) {
|
||||||
|
return readRegister(CMD10, cid);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Read a cards CSD register. The CSD contains Card-Specific Data that
|
||||||
|
* provides information regarding access to the card's contents. */
|
||||||
|
uint8_t readCSD(csd_t* csd) {
|
||||||
|
return readRegister(CMD9, csd);
|
||||||
|
}
|
||||||
|
void readEnd(void);
|
||||||
|
uint8_t setSckRate(uint8_t sckRateID);
|
||||||
|
/** Return the card type: SD V1, SD V2 or SDHC */
|
||||||
|
uint8_t type(void) const {return type_;}
|
||||||
|
uint8_t writeBlock(uint32_t blockNumber, const uint8_t* src);
|
||||||
|
uint8_t writeData(const uint8_t* src);
|
||||||
|
uint8_t writeStart(uint32_t blockNumber, uint32_t eraseCount);
|
||||||
|
uint8_t writeStop(void);
|
||||||
|
private:
|
||||||
|
uint32_t block_;
|
||||||
|
uint8_t chipSelectPin_;
|
||||||
|
uint8_t errorCode_;
|
||||||
|
uint8_t inBlock_;
|
||||||
|
uint16_t offset_;
|
||||||
|
uint8_t partialBlockRead_;
|
||||||
|
uint8_t status_;
|
||||||
|
uint8_t type_;
|
||||||
|
// private functions
|
||||||
|
uint8_t cardAcmd(uint8_t cmd, uint32_t arg) {
|
||||||
|
cardCommand(CMD55, 0);
|
||||||
|
return cardCommand(cmd, arg);
|
||||||
|
}
|
||||||
|
uint8_t cardCommand(uint8_t cmd, uint32_t arg);
|
||||||
|
void error(uint8_t code) {errorCode_ = code;}
|
||||||
|
uint8_t readRegister(uint8_t cmd, void* buf);
|
||||||
|
uint8_t sendWriteCommand(uint32_t blockNumber, uint32_t eraseCount);
|
||||||
|
void chipSelectHigh(void);
|
||||||
|
void chipSelectLow(void);
|
||||||
|
void type(uint8_t value) {type_ = value;}
|
||||||
|
uint8_t waitNotBusy(uint16_t timeoutMillis);
|
||||||
|
uint8_t writeData(uint8_t token, const uint8_t* src);
|
||||||
|
uint8_t waitStartBlock(void);
|
||||||
|
};
|
||||||
|
#endif // Sd2Card_h
|
@ -0,0 +1,353 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2010 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
// Warning this file was generated by a program.
|
||||||
|
#ifndef Sd2PinMap_h
|
||||||
|
#define Sd2PinMap_h
|
||||||
|
#include <avr/io.h>
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** struct for mapping digital pins */
|
||||||
|
struct pin_map_t {
|
||||||
|
volatile uint8_t* ddr;
|
||||||
|
volatile uint8_t* pin;
|
||||||
|
volatile uint8_t* port;
|
||||||
|
uint8_t bit;
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
|
||||||
|
// Mega
|
||||||
|
|
||||||
|
// Two Wire (aka I2C) ports
|
||||||
|
uint8_t const SDA_PIN = 20;
|
||||||
|
uint8_t const SCL_PIN = 21;
|
||||||
|
|
||||||
|
// SPI port
|
||||||
|
uint8_t const SS_PIN = 53;
|
||||||
|
uint8_t const MOSI_PIN = 51;
|
||||||
|
uint8_t const MISO_PIN = 50;
|
||||||
|
uint8_t const SCK_PIN = 52;
|
||||||
|
|
||||||
|
static const pin_map_t digitalPinMap[] = {
|
||||||
|
{&DDRE, &PINE, &PORTE, 0}, // E0 0
|
||||||
|
{&DDRE, &PINE, &PORTE, 1}, // E1 1
|
||||||
|
{&DDRE, &PINE, &PORTE, 4}, // E4 2
|
||||||
|
{&DDRE, &PINE, &PORTE, 5}, // E5 3
|
||||||
|
{&DDRG, &PING, &PORTG, 5}, // G5 4
|
||||||
|
{&DDRE, &PINE, &PORTE, 3}, // E3 5
|
||||||
|
{&DDRH, &PINH, &PORTH, 3}, // H3 6
|
||||||
|
{&DDRH, &PINH, &PORTH, 4}, // H4 7
|
||||||
|
{&DDRH, &PINH, &PORTH, 5}, // H5 8
|
||||||
|
{&DDRH, &PINH, &PORTH, 6}, // H6 9
|
||||||
|
{&DDRB, &PINB, &PORTB, 4}, // B4 10
|
||||||
|
{&DDRB, &PINB, &PORTB, 5}, // B5 11
|
||||||
|
{&DDRB, &PINB, &PORTB, 6}, // B6 12
|
||||||
|
{&DDRB, &PINB, &PORTB, 7}, // B7 13
|
||||||
|
{&DDRJ, &PINJ, &PORTJ, 1}, // J1 14
|
||||||
|
{&DDRJ, &PINJ, &PORTJ, 0}, // J0 15
|
||||||
|
{&DDRH, &PINH, &PORTH, 1}, // H1 16
|
||||||
|
{&DDRH, &PINH, &PORTH, 0}, // H0 17
|
||||||
|
{&DDRD, &PIND, &PORTD, 3}, // D3 18
|
||||||
|
{&DDRD, &PIND, &PORTD, 2}, // D2 19
|
||||||
|
{&DDRD, &PIND, &PORTD, 1}, // D1 20
|
||||||
|
{&DDRD, &PIND, &PORTD, 0}, // D0 21
|
||||||
|
{&DDRA, &PINA, &PORTA, 0}, // A0 22
|
||||||
|
{&DDRA, &PINA, &PORTA, 1}, // A1 23
|
||||||
|
{&DDRA, &PINA, &PORTA, 2}, // A2 24
|
||||||
|
{&DDRA, &PINA, &PORTA, 3}, // A3 25
|
||||||
|
{&DDRA, &PINA, &PORTA, 4}, // A4 26
|
||||||
|
{&DDRA, &PINA, &PORTA, 5}, // A5 27
|
||||||
|
{&DDRA, &PINA, &PORTA, 6}, // A6 28
|
||||||
|
{&DDRA, &PINA, &PORTA, 7}, // A7 29
|
||||||
|
{&DDRC, &PINC, &PORTC, 7}, // C7 30
|
||||||
|
{&DDRC, &PINC, &PORTC, 6}, // C6 31
|
||||||
|
{&DDRC, &PINC, &PORTC, 5}, // C5 32
|
||||||
|
{&DDRC, &PINC, &PORTC, 4}, // C4 33
|
||||||
|
{&DDRC, &PINC, &PORTC, 3}, // C3 34
|
||||||
|
{&DDRC, &PINC, &PORTC, 2}, // C2 35
|
||||||
|
{&DDRC, &PINC, &PORTC, 1}, // C1 36
|
||||||
|
{&DDRC, &PINC, &PORTC, 0}, // C0 37
|
||||||
|
{&DDRD, &PIND, &PORTD, 7}, // D7 38
|
||||||
|
{&DDRG, &PING, &PORTG, 2}, // G2 39
|
||||||
|
{&DDRG, &PING, &PORTG, 1}, // G1 40
|
||||||
|
{&DDRG, &PING, &PORTG, 0}, // G0 41
|
||||||
|
{&DDRL, &PINL, &PORTL, 7}, // L7 42
|
||||||
|
{&DDRL, &PINL, &PORTL, 6}, // L6 43
|
||||||
|
{&DDRL, &PINL, &PORTL, 5}, // L5 44
|
||||||
|
{&DDRL, &PINL, &PORTL, 4}, // L4 45
|
||||||
|
{&DDRL, &PINL, &PORTL, 3}, // L3 46
|
||||||
|
{&DDRL, &PINL, &PORTL, 2}, // L2 47
|
||||||
|
{&DDRL, &PINL, &PORTL, 1}, // L1 48
|
||||||
|
{&DDRL, &PINL, &PORTL, 0}, // L0 49
|
||||||
|
{&DDRB, &PINB, &PORTB, 3}, // B3 50
|
||||||
|
{&DDRB, &PINB, &PORTB, 2}, // B2 51
|
||||||
|
{&DDRB, &PINB, &PORTB, 1}, // B1 52
|
||||||
|
{&DDRB, &PINB, &PORTB, 0}, // B0 53
|
||||||
|
{&DDRF, &PINF, &PORTF, 0}, // F0 54
|
||||||
|
{&DDRF, &PINF, &PORTF, 1}, // F1 55
|
||||||
|
{&DDRF, &PINF, &PORTF, 2}, // F2 56
|
||||||
|
{&DDRF, &PINF, &PORTF, 3}, // F3 57
|
||||||
|
{&DDRF, &PINF, &PORTF, 4}, // F4 58
|
||||||
|
{&DDRF, &PINF, &PORTF, 5}, // F5 59
|
||||||
|
{&DDRF, &PINF, &PORTF, 6}, // F6 60
|
||||||
|
{&DDRF, &PINF, &PORTF, 7}, // F7 61
|
||||||
|
{&DDRK, &PINK, &PORTK, 0}, // K0 62
|
||||||
|
{&DDRK, &PINK, &PORTK, 1}, // K1 63
|
||||||
|
{&DDRK, &PINK, &PORTK, 2}, // K2 64
|
||||||
|
{&DDRK, &PINK, &PORTK, 3}, // K3 65
|
||||||
|
{&DDRK, &PINK, &PORTK, 4}, // K4 66
|
||||||
|
{&DDRK, &PINK, &PORTK, 5}, // K5 67
|
||||||
|
{&DDRK, &PINK, &PORTK, 6}, // K6 68
|
||||||
|
{&DDRK, &PINK, &PORTK, 7} // K7 69
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#elif defined(__AVR_ATmega644P__) || defined(__AVR_ATmega644__)
|
||||||
|
// Sanguino
|
||||||
|
|
||||||
|
// Two Wire (aka I2C) ports
|
||||||
|
uint8_t const SDA_PIN = 17;
|
||||||
|
uint8_t const SCL_PIN = 18;
|
||||||
|
|
||||||
|
// SPI port
|
||||||
|
uint8_t const SS_PIN = 4;
|
||||||
|
uint8_t const MOSI_PIN = 5;
|
||||||
|
uint8_t const MISO_PIN = 6;
|
||||||
|
uint8_t const SCK_PIN = 7;
|
||||||
|
|
||||||
|
static const pin_map_t digitalPinMap[] = {
|
||||||
|
{&DDRB, &PINB, &PORTB, 0}, // B0 0
|
||||||
|
{&DDRB, &PINB, &PORTB, 1}, // B1 1
|
||||||
|
{&DDRB, &PINB, &PORTB, 2}, // B2 2
|
||||||
|
{&DDRB, &PINB, &PORTB, 3}, // B3 3
|
||||||
|
{&DDRB, &PINB, &PORTB, 4}, // B4 4
|
||||||
|
{&DDRB, &PINB, &PORTB, 5}, // B5 5
|
||||||
|
{&DDRB, &PINB, &PORTB, 6}, // B6 6
|
||||||
|
{&DDRB, &PINB, &PORTB, 7}, // B7 7
|
||||||
|
{&DDRD, &PIND, &PORTD, 0}, // D0 8
|
||||||
|
{&DDRD, &PIND, &PORTD, 1}, // D1 9
|
||||||
|
{&DDRD, &PIND, &PORTD, 2}, // D2 10
|
||||||
|
{&DDRD, &PIND, &PORTD, 3}, // D3 11
|
||||||
|
{&DDRD, &PIND, &PORTD, 4}, // D4 12
|
||||||
|
{&DDRD, &PIND, &PORTD, 5}, // D5 13
|
||||||
|
{&DDRD, &PIND, &PORTD, 6}, // D6 14
|
||||||
|
{&DDRD, &PIND, &PORTD, 7}, // D7 15
|
||||||
|
{&DDRC, &PINC, &PORTC, 0}, // C0 16
|
||||||
|
{&DDRC, &PINC, &PORTC, 1}, // C1 17
|
||||||
|
{&DDRC, &PINC, &PORTC, 2}, // C2 18
|
||||||
|
{&DDRC, &PINC, &PORTC, 3}, // C3 19
|
||||||
|
{&DDRC, &PINC, &PORTC, 4}, // C4 20
|
||||||
|
{&DDRC, &PINC, &PORTC, 5}, // C5 21
|
||||||
|
{&DDRC, &PINC, &PORTC, 6}, // C6 22
|
||||||
|
{&DDRC, &PINC, &PORTC, 7}, // C7 23
|
||||||
|
{&DDRA, &PINA, &PORTA, 7}, // A7 24
|
||||||
|
{&DDRA, &PINA, &PORTA, 6}, // A6 25
|
||||||
|
{&DDRA, &PINA, &PORTA, 5}, // A5 26
|
||||||
|
{&DDRA, &PINA, &PORTA, 4}, // A4 27
|
||||||
|
{&DDRA, &PINA, &PORTA, 3}, // A3 28
|
||||||
|
{&DDRA, &PINA, &PORTA, 2}, // A2 29
|
||||||
|
{&DDRA, &PINA, &PORTA, 1}, // A1 30
|
||||||
|
{&DDRA, &PINA, &PORTA, 0} // A0 31
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#elif defined(__AVR_ATmega32U4__)
|
||||||
|
// Teensy 2.0
|
||||||
|
|
||||||
|
// Two Wire (aka I2C) ports
|
||||||
|
uint8_t const SDA_PIN = 6;
|
||||||
|
uint8_t const SCL_PIN = 5;
|
||||||
|
|
||||||
|
// SPI port
|
||||||
|
uint8_t const SS_PIN = 0;
|
||||||
|
uint8_t const MOSI_PIN = 2;
|
||||||
|
uint8_t const MISO_PIN = 3;
|
||||||
|
uint8_t const SCK_PIN = 1;
|
||||||
|
|
||||||
|
static const pin_map_t digitalPinMap[] = {
|
||||||
|
{&DDRB, &PINB, &PORTB, 0}, // B0 0
|
||||||
|
{&DDRB, &PINB, &PORTB, 1}, // B1 1
|
||||||
|
{&DDRB, &PINB, &PORTB, 2}, // B2 2
|
||||||
|
{&DDRB, &PINB, &PORTB, 3}, // B3 3
|
||||||
|
{&DDRB, &PINB, &PORTB, 7}, // B7 4
|
||||||
|
{&DDRD, &PIND, &PORTD, 0}, // D0 5
|
||||||
|
{&DDRD, &PIND, &PORTD, 1}, // D1 6
|
||||||
|
{&DDRD, &PIND, &PORTD, 2}, // D2 7
|
||||||
|
{&DDRD, &PIND, &PORTD, 3}, // D3 8
|
||||||
|
{&DDRC, &PINC, &PORTC, 6}, // C6 9
|
||||||
|
{&DDRC, &PINC, &PORTC, 7}, // C7 10
|
||||||
|
{&DDRD, &PIND, &PORTD, 6}, // D6 11
|
||||||
|
{&DDRD, &PIND, &PORTD, 7}, // D7 12
|
||||||
|
{&DDRB, &PINB, &PORTB, 4}, // B4 13
|
||||||
|
{&DDRB, &PINB, &PORTB, 5}, // B5 14
|
||||||
|
{&DDRB, &PINB, &PORTB, 6}, // B6 15
|
||||||
|
{&DDRF, &PINF, &PORTF, 7}, // F7 16
|
||||||
|
{&DDRF, &PINF, &PORTF, 6}, // F6 17
|
||||||
|
{&DDRF, &PINF, &PORTF, 5}, // F5 18
|
||||||
|
{&DDRF, &PINF, &PORTF, 4}, // F4 19
|
||||||
|
{&DDRF, &PINF, &PORTF, 1}, // F1 20
|
||||||
|
{&DDRF, &PINF, &PORTF, 0}, // F0 21
|
||||||
|
{&DDRD, &PIND, &PORTD, 4}, // D4 22
|
||||||
|
{&DDRD, &PIND, &PORTD, 5}, // D5 23
|
||||||
|
{&DDRE, &PINE, &PORTE, 6} // E6 24
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#elif defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB1286__)
|
||||||
|
// Teensy++ 1.0 & 2.0
|
||||||
|
|
||||||
|
// Two Wire (aka I2C) ports
|
||||||
|
uint8_t const SDA_PIN = 1;
|
||||||
|
uint8_t const SCL_PIN = 0;
|
||||||
|
|
||||||
|
// SPI port
|
||||||
|
uint8_t const SS_PIN = 20;
|
||||||
|
uint8_t const MOSI_PIN = 22;
|
||||||
|
uint8_t const MISO_PIN = 23;
|
||||||
|
uint8_t const SCK_PIN = 21;
|
||||||
|
|
||||||
|
static const pin_map_t digitalPinMap[] = {
|
||||||
|
{&DDRD, &PIND, &PORTD, 0}, // D0 0
|
||||||
|
{&DDRD, &PIND, &PORTD, 1}, // D1 1
|
||||||
|
{&DDRD, &PIND, &PORTD, 2}, // D2 2
|
||||||
|
{&DDRD, &PIND, &PORTD, 3}, // D3 3
|
||||||
|
{&DDRD, &PIND, &PORTD, 4}, // D4 4
|
||||||
|
{&DDRD, &PIND, &PORTD, 5}, // D5 5
|
||||||
|
{&DDRD, &PIND, &PORTD, 6}, // D6 6
|
||||||
|
{&DDRD, &PIND, &PORTD, 7}, // D7 7
|
||||||
|
{&DDRE, &PINE, &PORTE, 0}, // E0 8
|
||||||
|
{&DDRE, &PINE, &PORTE, 1}, // E1 9
|
||||||
|
{&DDRC, &PINC, &PORTC, 0}, // C0 10
|
||||||
|
{&DDRC, &PINC, &PORTC, 1}, // C1 11
|
||||||
|
{&DDRC, &PINC, &PORTC, 2}, // C2 12
|
||||||
|
{&DDRC, &PINC, &PORTC, 3}, // C3 13
|
||||||
|
{&DDRC, &PINC, &PORTC, 4}, // C4 14
|
||||||
|
{&DDRC, &PINC, &PORTC, 5}, // C5 15
|
||||||
|
{&DDRC, &PINC, &PORTC, 6}, // C6 16
|
||||||
|
{&DDRC, &PINC, &PORTC, 7}, // C7 17
|
||||||
|
{&DDRE, &PINE, &PORTE, 6}, // E6 18
|
||||||
|
{&DDRE, &PINE, &PORTE, 7}, // E7 19
|
||||||
|
{&DDRB, &PINB, &PORTB, 0}, // B0 20
|
||||||
|
{&DDRB, &PINB, &PORTB, 1}, // B1 21
|
||||||
|
{&DDRB, &PINB, &PORTB, 2}, // B2 22
|
||||||
|
{&DDRB, &PINB, &PORTB, 3}, // B3 23
|
||||||
|
{&DDRB, &PINB, &PORTB, 4}, // B4 24
|
||||||
|
{&DDRB, &PINB, &PORTB, 5}, // B5 25
|
||||||
|
{&DDRB, &PINB, &PORTB, 6}, // B6 26
|
||||||
|
{&DDRB, &PINB, &PORTB, 7}, // B7 27
|
||||||
|
{&DDRA, &PINA, &PORTA, 0}, // A0 28
|
||||||
|
{&DDRA, &PINA, &PORTA, 1}, // A1 29
|
||||||
|
{&DDRA, &PINA, &PORTA, 2}, // A2 30
|
||||||
|
{&DDRA, &PINA, &PORTA, 3}, // A3 31
|
||||||
|
{&DDRA, &PINA, &PORTA, 4}, // A4 32
|
||||||
|
{&DDRA, &PINA, &PORTA, 5}, // A5 33
|
||||||
|
{&DDRA, &PINA, &PORTA, 6}, // A6 34
|
||||||
|
{&DDRA, &PINA, &PORTA, 7}, // A7 35
|
||||||
|
{&DDRE, &PINE, &PORTE, 4}, // E4 36
|
||||||
|
{&DDRE, &PINE, &PORTE, 5}, // E5 37
|
||||||
|
{&DDRF, &PINF, &PORTF, 0}, // F0 38
|
||||||
|
{&DDRF, &PINF, &PORTF, 1}, // F1 39
|
||||||
|
{&DDRF, &PINF, &PORTF, 2}, // F2 40
|
||||||
|
{&DDRF, &PINF, &PORTF, 3}, // F3 41
|
||||||
|
{&DDRF, &PINF, &PORTF, 4}, // F4 42
|
||||||
|
{&DDRF, &PINF, &PORTF, 5}, // F5 43
|
||||||
|
{&DDRF, &PINF, &PORTF, 6}, // F6 44
|
||||||
|
{&DDRF, &PINF, &PORTF, 7} // F7 45
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#else // defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
|
||||||
|
// 168 and 328 Arduinos
|
||||||
|
|
||||||
|
// Two Wire (aka I2C) ports
|
||||||
|
uint8_t const SDA_PIN = 18;
|
||||||
|
uint8_t const SCL_PIN = 19;
|
||||||
|
|
||||||
|
// SPI port
|
||||||
|
uint8_t const SS_PIN = 10;
|
||||||
|
uint8_t const MOSI_PIN = 11;
|
||||||
|
uint8_t const MISO_PIN = 12;
|
||||||
|
uint8_t const SCK_PIN = 13;
|
||||||
|
|
||||||
|
static const pin_map_t digitalPinMap[] = {
|
||||||
|
{&DDRD, &PIND, &PORTD, 0}, // D0 0
|
||||||
|
{&DDRD, &PIND, &PORTD, 1}, // D1 1
|
||||||
|
{&DDRD, &PIND, &PORTD, 2}, // D2 2
|
||||||
|
{&DDRD, &PIND, &PORTD, 3}, // D3 3
|
||||||
|
{&DDRD, &PIND, &PORTD, 4}, // D4 4
|
||||||
|
{&DDRD, &PIND, &PORTD, 5}, // D5 5
|
||||||
|
{&DDRD, &PIND, &PORTD, 6}, // D6 6
|
||||||
|
{&DDRD, &PIND, &PORTD, 7}, // D7 7
|
||||||
|
{&DDRB, &PINB, &PORTB, 0}, // B0 8
|
||||||
|
{&DDRB, &PINB, &PORTB, 1}, // B1 9
|
||||||
|
{&DDRB, &PINB, &PORTB, 2}, // B2 10
|
||||||
|
{&DDRB, &PINB, &PORTB, 3}, // B3 11
|
||||||
|
{&DDRB, &PINB, &PORTB, 4}, // B4 12
|
||||||
|
{&DDRB, &PINB, &PORTB, 5}, // B5 13
|
||||||
|
{&DDRC, &PINC, &PORTC, 0}, // C0 14
|
||||||
|
{&DDRC, &PINC, &PORTC, 1}, // C1 15
|
||||||
|
{&DDRC, &PINC, &PORTC, 2}, // C2 16
|
||||||
|
{&DDRC, &PINC, &PORTC, 3}, // C3 17
|
||||||
|
{&DDRC, &PINC, &PORTC, 4}, // C4 18
|
||||||
|
{&DDRC, &PINC, &PORTC, 5} // C5 19
|
||||||
|
};
|
||||||
|
#endif // defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
static const uint8_t digitalPinCount = sizeof(digitalPinMap)/sizeof(pin_map_t);
|
||||||
|
|
||||||
|
uint8_t badPinNumber(void)
|
||||||
|
__attribute__((error("Pin number is too large or not a constant")));
|
||||||
|
|
||||||
|
static inline __attribute__((always_inline))
|
||||||
|
uint8_t getPinMode(uint8_t pin) {
|
||||||
|
if (__builtin_constant_p(pin) && pin < digitalPinCount) {
|
||||||
|
return (*digitalPinMap[pin].ddr >> digitalPinMap[pin].bit) & 1;
|
||||||
|
} else {
|
||||||
|
return badPinNumber();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static inline __attribute__((always_inline))
|
||||||
|
void setPinMode(uint8_t pin, uint8_t mode) {
|
||||||
|
if (__builtin_constant_p(pin) && pin < digitalPinCount) {
|
||||||
|
if (mode) {
|
||||||
|
*digitalPinMap[pin].ddr |= 1 << digitalPinMap[pin].bit;
|
||||||
|
} else {
|
||||||
|
*digitalPinMap[pin].ddr &= ~(1 << digitalPinMap[pin].bit);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
badPinNumber();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static inline __attribute__((always_inline))
|
||||||
|
uint8_t fastDigitalRead(uint8_t pin) {
|
||||||
|
if (__builtin_constant_p(pin) && pin < digitalPinCount) {
|
||||||
|
return (*digitalPinMap[pin].pin >> digitalPinMap[pin].bit) & 1;
|
||||||
|
} else {
|
||||||
|
return badPinNumber();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
static inline __attribute__((always_inline))
|
||||||
|
void fastDigitalWrite(uint8_t pin, uint8_t value) {
|
||||||
|
if (__builtin_constant_p(pin) && pin < digitalPinCount) {
|
||||||
|
if (value) {
|
||||||
|
*digitalPinMap[pin].port |= 1 << digitalPinMap[pin].bit;
|
||||||
|
} else {
|
||||||
|
*digitalPinMap[pin].port &= ~(1 << digitalPinMap[pin].bit);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
badPinNumber();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif // Sd2PinMap_h
|
@ -0,0 +1,547 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#ifndef SdFat_h
|
||||||
|
#define SdFat_h
|
||||||
|
/**
|
||||||
|
* \file
|
||||||
|
* SdFile and SdVolume classes
|
||||||
|
*/
|
||||||
|
#include <avr/pgmspace.h>
|
||||||
|
#include "Sd2Card.h"
|
||||||
|
#include "FatStructs.h"
|
||||||
|
#include "Print.h"
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Allow use of deprecated functions if non-zero
|
||||||
|
*/
|
||||||
|
#define ALLOW_DEPRECATED_FUNCTIONS 1
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// forward declaration since SdVolume is used in SdFile
|
||||||
|
class SdVolume;
|
||||||
|
//==============================================================================
|
||||||
|
// SdFile class
|
||||||
|
|
||||||
|
// flags for ls()
|
||||||
|
/** ls() flag to print modify date */
|
||||||
|
uint8_t const LS_DATE = 1;
|
||||||
|
/** ls() flag to print file size */
|
||||||
|
uint8_t const LS_SIZE = 2;
|
||||||
|
/** ls() flag for recursive list of subdirectories */
|
||||||
|
uint8_t const LS_R = 4;
|
||||||
|
|
||||||
|
// use the gnu style oflag in open()
|
||||||
|
/** open() oflag for reading */
|
||||||
|
uint8_t const O_READ = 0X01;
|
||||||
|
/** open() oflag - same as O_READ */
|
||||||
|
uint8_t const O_RDONLY = O_READ;
|
||||||
|
/** open() oflag for write */
|
||||||
|
uint8_t const O_WRITE = 0X02;
|
||||||
|
/** open() oflag - same as O_WRITE */
|
||||||
|
uint8_t const O_WRONLY = O_WRITE;
|
||||||
|
/** open() oflag for reading and writing */
|
||||||
|
uint8_t const O_RDWR = (O_READ | O_WRITE);
|
||||||
|
/** open() oflag mask for access modes */
|
||||||
|
uint8_t const O_ACCMODE = (O_READ | O_WRITE);
|
||||||
|
/** The file offset shall be set to the end of the file prior to each write. */
|
||||||
|
uint8_t const O_APPEND = 0X04;
|
||||||
|
/** synchronous writes - call sync() after each write */
|
||||||
|
uint8_t const O_SYNC = 0X08;
|
||||||
|
/** create the file if nonexistent */
|
||||||
|
uint8_t const O_CREAT = 0X10;
|
||||||
|
/** If O_CREAT and O_EXCL are set, open() shall fail if the file exists */
|
||||||
|
uint8_t const O_EXCL = 0X20;
|
||||||
|
/** truncate the file to zero length */
|
||||||
|
uint8_t const O_TRUNC = 0X40;
|
||||||
|
|
||||||
|
// flags for timestamp
|
||||||
|
/** set the file's last access date */
|
||||||
|
uint8_t const T_ACCESS = 1;
|
||||||
|
/** set the file's creation date and time */
|
||||||
|
uint8_t const T_CREATE = 2;
|
||||||
|
/** Set the file's write date and time */
|
||||||
|
uint8_t const T_WRITE = 4;
|
||||||
|
// values for type_
|
||||||
|
/** This SdFile has not been opened. */
|
||||||
|
uint8_t const FAT_FILE_TYPE_CLOSED = 0;
|
||||||
|
/** SdFile for a file */
|
||||||
|
uint8_t const FAT_FILE_TYPE_NORMAL = 1;
|
||||||
|
/** SdFile for a FAT16 root directory */
|
||||||
|
uint8_t const FAT_FILE_TYPE_ROOT16 = 2;
|
||||||
|
/** SdFile for a FAT32 root directory */
|
||||||
|
uint8_t const FAT_FILE_TYPE_ROOT32 = 3;
|
||||||
|
/** SdFile for a subdirectory */
|
||||||
|
uint8_t const FAT_FILE_TYPE_SUBDIR = 4;
|
||||||
|
/** Test value for directory type */
|
||||||
|
uint8_t const FAT_FILE_TYPE_MIN_DIR = FAT_FILE_TYPE_ROOT16;
|
||||||
|
|
||||||
|
/** date field for FAT directory entry */
|
||||||
|
static inline uint16_t FAT_DATE(uint16_t year, uint8_t month, uint8_t day) {
|
||||||
|
return (year - 1980) << 9 | month << 5 | day;
|
||||||
|
}
|
||||||
|
/** year part of FAT directory date field */
|
||||||
|
static inline uint16_t FAT_YEAR(uint16_t fatDate) {
|
||||||
|
return 1980 + (fatDate >> 9);
|
||||||
|
}
|
||||||
|
/** month part of FAT directory date field */
|
||||||
|
static inline uint8_t FAT_MONTH(uint16_t fatDate) {
|
||||||
|
return (fatDate >> 5) & 0XF;
|
||||||
|
}
|
||||||
|
/** day part of FAT directory date field */
|
||||||
|
static inline uint8_t FAT_DAY(uint16_t fatDate) {
|
||||||
|
return fatDate & 0X1F;
|
||||||
|
}
|
||||||
|
/** time field for FAT directory entry */
|
||||||
|
static inline uint16_t FAT_TIME(uint8_t hour, uint8_t minute, uint8_t second) {
|
||||||
|
return hour << 11 | minute << 5 | second >> 1;
|
||||||
|
}
|
||||||
|
/** hour part of FAT directory time field */
|
||||||
|
static inline uint8_t FAT_HOUR(uint16_t fatTime) {
|
||||||
|
return fatTime >> 11;
|
||||||
|
}
|
||||||
|
/** minute part of FAT directory time field */
|
||||||
|
static inline uint8_t FAT_MINUTE(uint16_t fatTime) {
|
||||||
|
return(fatTime >> 5) & 0X3F;
|
||||||
|
}
|
||||||
|
/** second part of FAT directory time field */
|
||||||
|
static inline uint8_t FAT_SECOND(uint16_t fatTime) {
|
||||||
|
return 2*(fatTime & 0X1F);
|
||||||
|
}
|
||||||
|
/** Default date for file timestamps is 1 Jan 2000 */
|
||||||
|
uint16_t const FAT_DEFAULT_DATE = ((2000 - 1980) << 9) | (1 << 5) | 1;
|
||||||
|
/** Default time for file timestamp is 1 am */
|
||||||
|
uint16_t const FAT_DEFAULT_TIME = (1 << 11);
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \class SdFile
|
||||||
|
* \brief Access FAT16 and FAT32 files on SD and SDHC cards.
|
||||||
|
*/
|
||||||
|
class SdFile : public Print {
|
||||||
|
public:
|
||||||
|
/** Create an instance of SdFile. */
|
||||||
|
SdFile(void) : type_(FAT_FILE_TYPE_CLOSED) {}
|
||||||
|
/**
|
||||||
|
* writeError is set to true if an error occurs during a write().
|
||||||
|
* Set writeError to false before calling print() and/or write() and check
|
||||||
|
* for true after calls to print() and/or write().
|
||||||
|
*/
|
||||||
|
bool writeError;
|
||||||
|
/**
|
||||||
|
* Cancel unbuffered reads for this file.
|
||||||
|
* See setUnbufferedRead()
|
||||||
|
*/
|
||||||
|
void clearUnbufferedRead(void) {
|
||||||
|
flags_ &= ~F_FILE_UNBUFFERED_READ;
|
||||||
|
}
|
||||||
|
uint8_t close(void);
|
||||||
|
uint8_t contiguousRange(uint32_t* bgnBlock, uint32_t* endBlock);
|
||||||
|
uint8_t createContiguous(SdFile* dirFile,
|
||||||
|
const char* fileName, uint32_t size);
|
||||||
|
/** \return The current cluster number for a file or directory. */
|
||||||
|
uint32_t curCluster(void) const {return curCluster_;}
|
||||||
|
/** \return The current position for a file or directory. */
|
||||||
|
uint32_t curPosition(void) const {return curPosition_;}
|
||||||
|
/**
|
||||||
|
* Set the date/time callback function
|
||||||
|
*
|
||||||
|
* \param[in] dateTime The user's call back function. The callback
|
||||||
|
* function is of the form:
|
||||||
|
*
|
||||||
|
* \code
|
||||||
|
* void dateTime(uint16_t* date, uint16_t* time) {
|
||||||
|
* uint16_t year;
|
||||||
|
* uint8_t month, day, hour, minute, second;
|
||||||
|
*
|
||||||
|
* // User gets date and time from GPS or real-time clock here
|
||||||
|
*
|
||||||
|
* // return date using FAT_DATE macro to format fields
|
||||||
|
* *date = FAT_DATE(year, month, day);
|
||||||
|
*
|
||||||
|
* // return time using FAT_TIME macro to format fields
|
||||||
|
* *time = FAT_TIME(hour, minute, second);
|
||||||
|
* }
|
||||||
|
* \endcode
|
||||||
|
*
|
||||||
|
* Sets the function that is called when a file is created or when
|
||||||
|
* a file's directory entry is modified by sync(). All timestamps,
|
||||||
|
* access, creation, and modify, are set when a file is created.
|
||||||
|
* sync() maintains the last access date and last modify date/time.
|
||||||
|
*
|
||||||
|
* See the timestamp() function.
|
||||||
|
*/
|
||||||
|
static void dateTimeCallback(
|
||||||
|
void (*dateTime)(uint16_t* date, uint16_t* time)) {
|
||||||
|
dateTime_ = dateTime;
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Cancel the date/time callback function.
|
||||||
|
*/
|
||||||
|
static void dateTimeCallbackCancel(void) {
|
||||||
|
// use explicit zero since NULL is not defined for Sanguino
|
||||||
|
dateTime_ = 0;
|
||||||
|
}
|
||||||
|
/** \return Address of the block that contains this file's directory. */
|
||||||
|
uint32_t dirBlock(void) const {return dirBlock_;}
|
||||||
|
uint8_t dirEntry(dir_t* dir);
|
||||||
|
/** \return Index of this file's directory in the block dirBlock. */
|
||||||
|
uint8_t dirIndex(void) const {return dirIndex_;}
|
||||||
|
static void dirName(const dir_t& dir, char* name);
|
||||||
|
/** \return The total number of bytes in a file or directory. */
|
||||||
|
uint32_t fileSize(void) const {return fileSize_;}
|
||||||
|
/** \return The first cluster number for a file or directory. */
|
||||||
|
uint32_t firstCluster(void) const {return firstCluster_;}
|
||||||
|
/** \return True if this is a SdFile for a directory else false. */
|
||||||
|
uint8_t isDir(void) const {return type_ >= FAT_FILE_TYPE_MIN_DIR;}
|
||||||
|
/** \return True if this is a SdFile for a file else false. */
|
||||||
|
uint8_t isFile(void) const {return type_ == FAT_FILE_TYPE_NORMAL;}
|
||||||
|
/** \return True if this is a SdFile for an open file/directory else false. */
|
||||||
|
uint8_t isOpen(void) const {return type_ != FAT_FILE_TYPE_CLOSED;}
|
||||||
|
/** \return True if this is a SdFile for a subdirectory else false. */
|
||||||
|
uint8_t isSubDir(void) const {return type_ == FAT_FILE_TYPE_SUBDIR;}
|
||||||
|
/** \return True if this is a SdFile for the root directory. */
|
||||||
|
uint8_t isRoot(void) const {
|
||||||
|
return type_ == FAT_FILE_TYPE_ROOT16 || type_ == FAT_FILE_TYPE_ROOT32;
|
||||||
|
}
|
||||||
|
void ls(uint8_t flags = 0, uint8_t indent = 0);
|
||||||
|
uint8_t makeDir(SdFile* dir, const char* dirName);
|
||||||
|
uint8_t open(SdFile* dirFile, uint16_t index, uint8_t oflag);
|
||||||
|
uint8_t open(SdFile* dirFile, const char* fileName, uint8_t oflag);
|
||||||
|
|
||||||
|
uint8_t openRoot(SdVolume* vol);
|
||||||
|
static void printDirName(const dir_t& dir, uint8_t width);
|
||||||
|
static void printFatDate(uint16_t fatDate);
|
||||||
|
static void printFatTime(uint16_t fatTime);
|
||||||
|
static void printTwoDigits(uint8_t v);
|
||||||
|
/**
|
||||||
|
* Read the next byte from a file.
|
||||||
|
*
|
||||||
|
* \return For success read returns the next byte in the file as an int.
|
||||||
|
* If an error occurs or end of file is reached -1 is returned.
|
||||||
|
*/
|
||||||
|
int16_t read(void) {
|
||||||
|
uint8_t b;
|
||||||
|
return read(&b, 1) == 1 ? b : -1;
|
||||||
|
}
|
||||||
|
int16_t read(void* buf, uint16_t nbyte);
|
||||||
|
int8_t readDir(dir_t* dir);
|
||||||
|
static uint8_t remove(SdFile* dirFile, const char* fileName);
|
||||||
|
uint8_t remove(void);
|
||||||
|
/** Set the file's current position to zero. */
|
||||||
|
void rewind(void) {
|
||||||
|
curPosition_ = curCluster_ = 0;
|
||||||
|
}
|
||||||
|
uint8_t rmDir(void);
|
||||||
|
uint8_t rmRfStar(void);
|
||||||
|
/** Set the files position to current position + \a pos. See seekSet(). */
|
||||||
|
uint8_t seekCur(uint32_t pos) {
|
||||||
|
return seekSet(curPosition_ + pos);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Set the files current position to end of file. Useful to position
|
||||||
|
* a file for append. See seekSet().
|
||||||
|
*/
|
||||||
|
uint8_t seekEnd(void) {return seekSet(fileSize_);}
|
||||||
|
uint8_t seekSet(uint32_t pos);
|
||||||
|
/**
|
||||||
|
* Use unbuffered reads to access this file. Used with Wave
|
||||||
|
* Shield ISR. Used with Sd2Card::partialBlockRead() in WaveRP.
|
||||||
|
*
|
||||||
|
* Not recommended for normal applications.
|
||||||
|
*/
|
||||||
|
void setUnbufferedRead(void) {
|
||||||
|
if (isFile()) flags_ |= F_FILE_UNBUFFERED_READ;
|
||||||
|
}
|
||||||
|
uint8_t timestamp(uint8_t flag, uint16_t year, uint8_t month, uint8_t day,
|
||||||
|
uint8_t hour, uint8_t minute, uint8_t second);
|
||||||
|
uint8_t sync(void);
|
||||||
|
/** Type of this SdFile. You should use isFile() or isDir() instead of type()
|
||||||
|
* if possible.
|
||||||
|
*
|
||||||
|
* \return The file or directory type.
|
||||||
|
*/
|
||||||
|
uint8_t type(void) const {return type_;}
|
||||||
|
uint8_t truncate(uint32_t size);
|
||||||
|
/** \return Unbuffered read flag. */
|
||||||
|
uint8_t unbufferedRead(void) const {
|
||||||
|
return flags_ & F_FILE_UNBUFFERED_READ;
|
||||||
|
}
|
||||||
|
/** \return SdVolume that contains this file. */
|
||||||
|
SdVolume* volume(void) const {return vol_;}
|
||||||
|
void write(uint8_t b);
|
||||||
|
int16_t write(const void* buf, uint16_t nbyte);
|
||||||
|
void write(const char* str);
|
||||||
|
void write_P(PGM_P str);
|
||||||
|
void writeln_P(PGM_P str);
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#if ALLOW_DEPRECATED_FUNCTIONS
|
||||||
|
// Deprecated functions - suppress cpplint warnings with NOLINT comment
|
||||||
|
/** \deprecated Use:
|
||||||
|
* uint8_t SdFile::contiguousRange(uint32_t* bgnBlock, uint32_t* endBlock);
|
||||||
|
*/
|
||||||
|
uint8_t contiguousRange(uint32_t& bgnBlock, uint32_t& endBlock) { // NOLINT
|
||||||
|
return contiguousRange(&bgnBlock, &endBlock);
|
||||||
|
}
|
||||||
|
/** \deprecated Use:
|
||||||
|
* uint8_t SdFile::createContiguous(SdFile* dirFile,
|
||||||
|
* const char* fileName, uint32_t size)
|
||||||
|
*/
|
||||||
|
uint8_t createContiguous(SdFile& dirFile, // NOLINT
|
||||||
|
const char* fileName, uint32_t size) {
|
||||||
|
return createContiguous(&dirFile, fileName, size);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* \deprecated Use:
|
||||||
|
* static void SdFile::dateTimeCallback(
|
||||||
|
* void (*dateTime)(uint16_t* date, uint16_t* time));
|
||||||
|
*/
|
||||||
|
static void dateTimeCallback(
|
||||||
|
void (*dateTime)(uint16_t& date, uint16_t& time)) { // NOLINT
|
||||||
|
oldDateTime_ = dateTime;
|
||||||
|
dateTime_ = dateTime ? oldToNew : 0;
|
||||||
|
}
|
||||||
|
/** \deprecated Use: uint8_t SdFile::dirEntry(dir_t* dir); */
|
||||||
|
uint8_t dirEntry(dir_t& dir) {return dirEntry(&dir);} // NOLINT
|
||||||
|
/** \deprecated Use:
|
||||||
|
* uint8_t SdFile::makeDir(SdFile* dir, const char* dirName);
|
||||||
|
*/
|
||||||
|
uint8_t makeDir(SdFile& dir, const char* dirName) { // NOLINT
|
||||||
|
return makeDir(&dir, dirName);
|
||||||
|
}
|
||||||
|
/** \deprecated Use:
|
||||||
|
* uint8_t SdFile::open(SdFile* dirFile, const char* fileName, uint8_t oflag);
|
||||||
|
*/
|
||||||
|
uint8_t open(SdFile& dirFile, // NOLINT
|
||||||
|
const char* fileName, uint8_t oflag) {
|
||||||
|
return open(&dirFile, fileName, oflag);
|
||||||
|
}
|
||||||
|
/** \deprecated Do not use in new apps */
|
||||||
|
uint8_t open(SdFile& dirFile, const char* fileName) { // NOLINT
|
||||||
|
return open(dirFile, fileName, O_RDWR);
|
||||||
|
}
|
||||||
|
/** \deprecated Use:
|
||||||
|
* uint8_t SdFile::open(SdFile* dirFile, uint16_t index, uint8_t oflag);
|
||||||
|
*/
|
||||||
|
uint8_t open(SdFile& dirFile, uint16_t index, uint8_t oflag) { // NOLINT
|
||||||
|
return open(&dirFile, index, oflag);
|
||||||
|
}
|
||||||
|
/** \deprecated Use: uint8_t SdFile::openRoot(SdVolume* vol); */
|
||||||
|
uint8_t openRoot(SdVolume& vol) {return openRoot(&vol);} // NOLINT
|
||||||
|
|
||||||
|
/** \deprecated Use: int8_t SdFile::readDir(dir_t* dir); */
|
||||||
|
int8_t readDir(dir_t& dir) {return readDir(&dir);} // NOLINT
|
||||||
|
/** \deprecated Use:
|
||||||
|
* static uint8_t SdFile::remove(SdFile* dirFile, const char* fileName);
|
||||||
|
*/
|
||||||
|
static uint8_t remove(SdFile& dirFile, const char* fileName) { // NOLINT
|
||||||
|
return remove(&dirFile, fileName);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// rest are private
|
||||||
|
private:
|
||||||
|
static void (*oldDateTime_)(uint16_t& date, uint16_t& time); // NOLINT
|
||||||
|
static void oldToNew(uint16_t* date, uint16_t* time) {
|
||||||
|
uint16_t d;
|
||||||
|
uint16_t t;
|
||||||
|
oldDateTime_(d, t);
|
||||||
|
*date = d;
|
||||||
|
*time = t;
|
||||||
|
}
|
||||||
|
#endif // ALLOW_DEPRECATED_FUNCTIONS
|
||||||
|
private:
|
||||||
|
// bits defined in flags_
|
||||||
|
// should be 0XF
|
||||||
|
static uint8_t const F_OFLAG = (O_ACCMODE | O_APPEND | O_SYNC);
|
||||||
|
// available bits
|
||||||
|
static uint8_t const F_UNUSED = 0X30;
|
||||||
|
// use unbuffered SD read
|
||||||
|
static uint8_t const F_FILE_UNBUFFERED_READ = 0X40;
|
||||||
|
// sync of directory entry required
|
||||||
|
static uint8_t const F_FILE_DIR_DIRTY = 0X80;
|
||||||
|
|
||||||
|
// make sure F_OFLAG is ok
|
||||||
|
#if ((F_UNUSED | F_FILE_UNBUFFERED_READ | F_FILE_DIR_DIRTY) & F_OFLAG)
|
||||||
|
#error flags_ bits conflict
|
||||||
|
#endif // flags_ bits
|
||||||
|
|
||||||
|
// private data
|
||||||
|
uint8_t flags_; // See above for definition of flags_ bits
|
||||||
|
uint8_t type_; // type of file see above for values
|
||||||
|
uint32_t curCluster_; // cluster for current file position
|
||||||
|
uint32_t curPosition_; // current file position in bytes from beginning
|
||||||
|
uint32_t dirBlock_; // SD block that contains directory entry for file
|
||||||
|
uint8_t dirIndex_; // index of entry in dirBlock 0 <= dirIndex_ <= 0XF
|
||||||
|
uint32_t fileSize_; // file size in bytes
|
||||||
|
uint32_t firstCluster_; // first cluster of file
|
||||||
|
SdVolume* vol_; // volume where file is located
|
||||||
|
|
||||||
|
// private functions
|
||||||
|
uint8_t addCluster(void);
|
||||||
|
uint8_t addDirCluster(void);
|
||||||
|
dir_t* cacheDirEntry(uint8_t action);
|
||||||
|
static void (*dateTime_)(uint16_t* date, uint16_t* time);
|
||||||
|
static uint8_t make83Name(const char* str, uint8_t* name);
|
||||||
|
uint8_t openCachedEntry(uint8_t cacheIndex, uint8_t oflags);
|
||||||
|
dir_t* readDirCache(void);
|
||||||
|
};
|
||||||
|
//==============================================================================
|
||||||
|
// SdVolume class
|
||||||
|
/**
|
||||||
|
* \brief Cache for an SD data block
|
||||||
|
*/
|
||||||
|
union cache_t {
|
||||||
|
/** Used to access cached file data blocks. */
|
||||||
|
uint8_t data[512];
|
||||||
|
/** Used to access cached FAT16 entries. */
|
||||||
|
uint16_t fat16[256];
|
||||||
|
/** Used to access cached FAT32 entries. */
|
||||||
|
uint32_t fat32[128];
|
||||||
|
/** Used to access cached directory entries. */
|
||||||
|
dir_t dir[16];
|
||||||
|
/** Used to access a cached MasterBoot Record. */
|
||||||
|
mbr_t mbr;
|
||||||
|
/** Used to access to a cached FAT boot sector. */
|
||||||
|
fbs_t fbs;
|
||||||
|
};
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* \class SdVolume
|
||||||
|
* \brief Access FAT16 and FAT32 volumes on SD and SDHC cards.
|
||||||
|
*/
|
||||||
|
class SdVolume {
|
||||||
|
public:
|
||||||
|
/** Create an instance of SdVolume */
|
||||||
|
SdVolume(void) :allocSearchStart_(2), fatType_(0) {}
|
||||||
|
/** Clear the cache and returns a pointer to the cache. Used by the WaveRP
|
||||||
|
* recorder to do raw write to the SD card. Not for normal apps.
|
||||||
|
*/
|
||||||
|
static uint8_t* cacheClear(void) {
|
||||||
|
cacheFlush();
|
||||||
|
cacheBlockNumber_ = 0XFFFFFFFF;
|
||||||
|
return cacheBuffer_.data;
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Initialize a FAT volume. Try partition one first then try super
|
||||||
|
* floppy format.
|
||||||
|
*
|
||||||
|
* \param[in] dev The Sd2Card where the volume is located.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure. Reasons for
|
||||||
|
* failure include not finding a valid partition, not finding a valid
|
||||||
|
* FAT file system or an I/O error.
|
||||||
|
*/
|
||||||
|
uint8_t init(Sd2Card* dev) { return init(dev, 1) ? true : init(dev, 0);}
|
||||||
|
uint8_t init(Sd2Card* dev, uint8_t part);
|
||||||
|
|
||||||
|
// inline functions that return volume info
|
||||||
|
/** \return The volume's cluster size in blocks. */
|
||||||
|
uint8_t blocksPerCluster(void) const {return blocksPerCluster_;}
|
||||||
|
/** \return The number of blocks in one FAT. */
|
||||||
|
uint32_t blocksPerFat(void) const {return blocksPerFat_;}
|
||||||
|
/** \return The total number of clusters in the volume. */
|
||||||
|
uint32_t clusterCount(void) const {return clusterCount_;}
|
||||||
|
/** \return The shift count required to multiply by blocksPerCluster. */
|
||||||
|
uint8_t clusterSizeShift(void) const {return clusterSizeShift_;}
|
||||||
|
/** \return The logical block number for the start of file data. */
|
||||||
|
uint32_t dataStartBlock(void) const {return dataStartBlock_;}
|
||||||
|
/** \return The number of FAT structures on the volume. */
|
||||||
|
uint8_t fatCount(void) const {return fatCount_;}
|
||||||
|
/** \return The logical block number for the start of the first FAT. */
|
||||||
|
uint32_t fatStartBlock(void) const {return fatStartBlock_;}
|
||||||
|
/** \return The FAT type of the volume. Values are 12, 16 or 32. */
|
||||||
|
uint8_t fatType(void) const {return fatType_;}
|
||||||
|
/** \return The number of entries in the root directory for FAT16 volumes. */
|
||||||
|
uint32_t rootDirEntryCount(void) const {return rootDirEntryCount_;}
|
||||||
|
/** \return The logical block number for the start of the root directory
|
||||||
|
on FAT16 volumes or the first cluster number on FAT32 volumes. */
|
||||||
|
uint32_t rootDirStart(void) const {return rootDirStart_;}
|
||||||
|
/** return a pointer to the Sd2Card object for this volume */
|
||||||
|
static Sd2Card* sdCard(void) {return sdCard_;}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
#if ALLOW_DEPRECATED_FUNCTIONS
|
||||||
|
// Deprecated functions - suppress cpplint warnings with NOLINT comment
|
||||||
|
/** \deprecated Use: uint8_t SdVolume::init(Sd2Card* dev); */
|
||||||
|
uint8_t init(Sd2Card& dev) {return init(&dev);} // NOLINT
|
||||||
|
|
||||||
|
/** \deprecated Use: uint8_t SdVolume::init(Sd2Card* dev, uint8_t vol); */
|
||||||
|
uint8_t init(Sd2Card& dev, uint8_t part) { // NOLINT
|
||||||
|
return init(&dev, part);
|
||||||
|
}
|
||||||
|
#endif // ALLOW_DEPRECATED_FUNCTIONS
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
private:
|
||||||
|
// Allow SdFile access to SdVolume private data.
|
||||||
|
friend class SdFile;
|
||||||
|
|
||||||
|
// value for action argument in cacheRawBlock to indicate read from cache
|
||||||
|
static uint8_t const CACHE_FOR_READ = 0;
|
||||||
|
// value for action argument in cacheRawBlock to indicate cache dirty
|
||||||
|
static uint8_t const CACHE_FOR_WRITE = 1;
|
||||||
|
|
||||||
|
static cache_t cacheBuffer_; // 512 byte cache for device blocks
|
||||||
|
static uint32_t cacheBlockNumber_; // Logical number of block in the cache
|
||||||
|
static Sd2Card* sdCard_; // Sd2Card object for cache
|
||||||
|
static uint8_t cacheDirty_; // cacheFlush() will write block if true
|
||||||
|
static uint32_t cacheMirrorBlock_; // block number for mirror FAT
|
||||||
|
//
|
||||||
|
uint32_t allocSearchStart_; // start cluster for alloc search
|
||||||
|
uint8_t blocksPerCluster_; // cluster size in blocks
|
||||||
|
uint32_t blocksPerFat_; // FAT size in blocks
|
||||||
|
uint32_t clusterCount_; // clusters in one FAT
|
||||||
|
uint8_t clusterSizeShift_; // shift to convert cluster count to block count
|
||||||
|
uint32_t dataStartBlock_; // first data block number
|
||||||
|
uint8_t fatCount_; // number of FATs on volume
|
||||||
|
uint32_t fatStartBlock_; // start block for first FAT
|
||||||
|
uint8_t fatType_; // volume type (12, 16, OR 32)
|
||||||
|
uint16_t rootDirEntryCount_; // number of entries in FAT16 root dir
|
||||||
|
uint32_t rootDirStart_; // root start block for FAT16, cluster for FAT32
|
||||||
|
//----------------------------------------------------------------------------
|
||||||
|
uint8_t allocContiguous(uint32_t count, uint32_t* curCluster);
|
||||||
|
uint8_t blockOfCluster(uint32_t position) const {
|
||||||
|
return (position >> 9) & (blocksPerCluster_ - 1);}
|
||||||
|
uint32_t clusterStartBlock(uint32_t cluster) const {
|
||||||
|
return dataStartBlock_ + ((cluster - 2) << clusterSizeShift_);}
|
||||||
|
uint32_t blockNumber(uint32_t cluster, uint32_t position) const {
|
||||||
|
return clusterStartBlock(cluster) + blockOfCluster(position);}
|
||||||
|
static uint8_t cacheFlush(void);
|
||||||
|
static uint8_t cacheRawBlock(uint32_t blockNumber, uint8_t action);
|
||||||
|
static void cacheSetDirty(void) {cacheDirty_ |= CACHE_FOR_WRITE;}
|
||||||
|
static uint8_t cacheZeroBlock(uint32_t blockNumber);
|
||||||
|
uint8_t chainSize(uint32_t beginCluster, uint32_t* size) const;
|
||||||
|
uint8_t fatGet(uint32_t cluster, uint32_t* value) const;
|
||||||
|
uint8_t fatPut(uint32_t cluster, uint32_t value);
|
||||||
|
uint8_t fatPutEOC(uint32_t cluster) {
|
||||||
|
return fatPut(cluster, 0x0FFFFFFF);
|
||||||
|
}
|
||||||
|
uint8_t freeChain(uint32_t cluster);
|
||||||
|
uint8_t isEOC(uint32_t cluster) const {
|
||||||
|
return cluster >= (fatType_ == 16 ? FAT16EOC_MIN : FAT32EOC_MIN);
|
||||||
|
}
|
||||||
|
uint8_t readBlock(uint32_t block, uint8_t* dst) {
|
||||||
|
return sdCard_->readBlock(block, dst);}
|
||||||
|
uint8_t readData(uint32_t block, uint16_t offset,
|
||||||
|
uint16_t count, uint8_t* dst) {
|
||||||
|
return sdCard_->readData(block, offset, count, dst);
|
||||||
|
}
|
||||||
|
uint8_t writeBlock(uint32_t block, const uint8_t* dst) {
|
||||||
|
return sdCard_->writeBlock(block, dst);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
#endif // SdFat_h
|
@ -0,0 +1,70 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2008 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#ifndef SdFatUtil_h
|
||||||
|
#define SdFatUtil_h
|
||||||
|
/**
|
||||||
|
* \file
|
||||||
|
* Useful utility functions.
|
||||||
|
*/
|
||||||
|
#include <WProgram.h>
|
||||||
|
#include <avr/pgmspace.h>
|
||||||
|
/** Store and print a string in flash memory.*/
|
||||||
|
#define PgmPrint(x) SerialPrint_P(PSTR(x))
|
||||||
|
/** Store and print a string in flash memory followed by a CR/LF.*/
|
||||||
|
#define PgmPrintln(x) SerialPrintln_P(PSTR(x))
|
||||||
|
/** Defined so doxygen works for function definitions. */
|
||||||
|
#define NOINLINE __attribute__((noinline))
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Return the number of bytes currently free in RAM. */
|
||||||
|
static int FreeRam(void) {
|
||||||
|
extern int __bss_end;
|
||||||
|
extern int* __brkval;
|
||||||
|
int free_memory;
|
||||||
|
if (reinterpret_cast<int>(__brkval) == 0) {
|
||||||
|
// if no heap use from end of bss section
|
||||||
|
free_memory = reinterpret_cast<int>(&free_memory)
|
||||||
|
- reinterpret_cast<int>(&__bss_end);
|
||||||
|
} else {
|
||||||
|
// use from top of stack to heap
|
||||||
|
free_memory = reinterpret_cast<int>(&free_memory)
|
||||||
|
- reinterpret_cast<int>(__brkval);
|
||||||
|
}
|
||||||
|
return free_memory;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* %Print a string in flash memory to the serial port.
|
||||||
|
*
|
||||||
|
* \param[in] str Pointer to string stored in flash memory.
|
||||||
|
*/
|
||||||
|
static NOINLINE void SerialPrint_P(PGM_P str) {
|
||||||
|
for (uint8_t c; (c = pgm_read_byte(str)); str++) Serial.print(c);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* %Print a string in flash memory followed by a CR/LF.
|
||||||
|
*
|
||||||
|
* \param[in] str Pointer to string stored in flash memory.
|
||||||
|
*/
|
||||||
|
static NOINLINE void SerialPrintln_P(PGM_P str) {
|
||||||
|
SerialPrint_P(str);
|
||||||
|
Serial.println();
|
||||||
|
}
|
||||||
|
#endif // #define SdFatUtil_h
|
@ -0,0 +1,202 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
\mainpage Arduino SdFat Library
|
||||||
|
<CENTER>Copyright © 2009 by William Greiman
|
||||||
|
</CENTER>
|
||||||
|
|
||||||
|
\section Intro Introduction
|
||||||
|
The Arduino SdFat Library is a minimal implementation of FAT16 and FAT32
|
||||||
|
file systems on SD flash memory cards. Standard SD and high capacity
|
||||||
|
SDHC cards are supported.
|
||||||
|
|
||||||
|
The SdFat only supports short 8.3 names.
|
||||||
|
|
||||||
|
The main classes in SdFat are Sd2Card, SdVolume, and SdFile.
|
||||||
|
|
||||||
|
The Sd2Card class supports access to standard SD cards and SDHC cards. Most
|
||||||
|
applications will only need to call the Sd2Card::init() member function.
|
||||||
|
|
||||||
|
The SdVolume class supports FAT16 and FAT32 partitions. Most applications
|
||||||
|
will only need to call the SdVolume::init() member function.
|
||||||
|
|
||||||
|
The SdFile class provides file access functions such as open(), read(),
|
||||||
|
remove(), write(), close() and sync(). This class supports access to the root
|
||||||
|
directory and subdirectories.
|
||||||
|
|
||||||
|
A number of example are provided in the SdFat/examples folder. These were
|
||||||
|
developed to test SdFat and illustrate its use.
|
||||||
|
|
||||||
|
SdFat was developed for high speed data recording. SdFat was used to implement
|
||||||
|
an audio record/play class, WaveRP, for the Adafruit Wave Shield. This
|
||||||
|
application uses special Sd2Card calls to write to contiguous files in raw mode.
|
||||||
|
These functions reduce write latency so that audio can be recorded with the
|
||||||
|
small amount of RAM in the Arduino.
|
||||||
|
|
||||||
|
\section SDcard SD\SDHC Cards
|
||||||
|
|
||||||
|
Arduinos access SD cards using the cards SPI protocol. PCs, Macs, and
|
||||||
|
most consumer devices use the 4-bit parallel SD protocol. A card that
|
||||||
|
functions well on A PC or Mac may not work well on the Arduino.
|
||||||
|
|
||||||
|
Most cards have good SPI read performance but cards vary widely in SPI
|
||||||
|
write performance. Write performance is limited by how efficiently the
|
||||||
|
card manages internal erase/remapping operations. The Arduino cannot
|
||||||
|
optimize writes to reduce erase operations because of its limit RAM.
|
||||||
|
|
||||||
|
SanDisk cards generally have good write performance. They seem to have
|
||||||
|
more internal RAM buffering than other cards and therefore can limit
|
||||||
|
the number of flash erase operations that the Arduino forces due to its
|
||||||
|
limited RAM.
|
||||||
|
|
||||||
|
\section Hardware Hardware Configuration
|
||||||
|
|
||||||
|
SdFat was developed using an
|
||||||
|
<A HREF = "http://www.adafruit.com/"> Adafruit Industries</A>
|
||||||
|
<A HREF = "http://www.ladyada.net/make/waveshield/"> Wave Shield</A>.
|
||||||
|
|
||||||
|
The hardware interface to the SD card should not use a resistor based level
|
||||||
|
shifter. SdFat sets the SPI bus frequency to 8 MHz which results in signal
|
||||||
|
rise times that are too slow for the edge detectors in many newer SD card
|
||||||
|
controllers when resistor voltage dividers are used.
|
||||||
|
|
||||||
|
The 5 to 3.3 V level shifter for 5 V Arduinos should be IC based like the
|
||||||
|
74HC4050N based circuit shown in the file SdLevel.png. The Adafruit Wave Shield
|
||||||
|
uses a 74AHC125N. Gravitech sells SD and MicroSD Card Adapters based on the
|
||||||
|
74LCX245.
|
||||||
|
|
||||||
|
If you are using a resistor based level shifter and are having problems try
|
||||||
|
setting the SPI bus frequency to 4 MHz. This can be done by using
|
||||||
|
card.init(SPI_HALF_SPEED) to initialize the SD card.
|
||||||
|
|
||||||
|
\section comment Bugs and Comments
|
||||||
|
|
||||||
|
If you wish to report bugs or have comments, send email to fat16lib@sbcglobal.net.
|
||||||
|
|
||||||
|
\section SdFatClass SdFat Usage
|
||||||
|
|
||||||
|
SdFat uses a slightly restricted form of short names.
|
||||||
|
Only printable ASCII characters are supported. No characters with code point
|
||||||
|
values greater than 127 are allowed. Space is not allowed even though space
|
||||||
|
was allowed in the API of early versions of DOS.
|
||||||
|
|
||||||
|
Short names are limited to 8 characters followed by an optional period (.)
|
||||||
|
and extension of up to 3 characters. The characters may be any combination
|
||||||
|
of letters and digits. The following special characters are also allowed:
|
||||||
|
|
||||||
|
$ % ' - _ @ ~ ` ! ( ) { } ^ # &
|
||||||
|
|
||||||
|
Short names are always converted to upper case and their original case
|
||||||
|
value is lost.
|
||||||
|
|
||||||
|
\note
|
||||||
|
The Arduino Print class uses character
|
||||||
|
at a time writes so it was necessary to use a \link SdFile::sync() sync() \endlink
|
||||||
|
function to control when data is written to the SD card.
|
||||||
|
|
||||||
|
\par
|
||||||
|
An application which writes to a file using \link Print::print() print()\endlink,
|
||||||
|
\link Print::println() println() \endlink
|
||||||
|
or \link SdFile::write write() \endlink must call \link SdFile::sync() sync() \endlink
|
||||||
|
at the appropriate time to force data and directory information to be written
|
||||||
|
to the SD Card. Data and directory information are also written to the SD card
|
||||||
|
when \link SdFile::close() close() \endlink is called.
|
||||||
|
|
||||||
|
\par
|
||||||
|
Applications must use care calling \link SdFile::sync() sync() \endlink
|
||||||
|
since 2048 bytes of I/O is required to update file and
|
||||||
|
directory information. This includes writing the current data block, reading
|
||||||
|
the block that contains the directory entry for update, writing the directory
|
||||||
|
block back and reading back the current data block.
|
||||||
|
|
||||||
|
It is possible to open a file with two or more instances of SdFile. A file may
|
||||||
|
be corrupted if data is written to the file by more than one instance of SdFile.
|
||||||
|
|
||||||
|
\section HowTo How to format SD Cards as FAT Volumes
|
||||||
|
|
||||||
|
You should use a freshly formatted SD card for best performance. FAT
|
||||||
|
file systems become slower if many files have been created and deleted.
|
||||||
|
This is because the directory entry for a deleted file is marked as deleted,
|
||||||
|
but is not deleted. When a new file is created, these entries must be scanned
|
||||||
|
before creating the file, a flaw in the FAT design. Also files can become
|
||||||
|
fragmented which causes reads and writes to be slower.
|
||||||
|
|
||||||
|
Microsoft operating systems support removable media formatted with a
|
||||||
|
Master Boot Record, MBR, or formatted as a super floppy with a FAT Boot Sector
|
||||||
|
in block zero.
|
||||||
|
|
||||||
|
Microsoft operating systems expect MBR formatted removable media
|
||||||
|
to have only one partition. The first partition should be used.
|
||||||
|
|
||||||
|
Microsoft operating systems do not support partitioning SD flash cards.
|
||||||
|
If you erase an SD card with a program like KillDisk, Most versions of
|
||||||
|
Windows will format the card as a super floppy.
|
||||||
|
|
||||||
|
The best way to restore an SD card's format is to use SDFormatter
|
||||||
|
which can be downloaded from:
|
||||||
|
|
||||||
|
http://www.sdcard.org/consumers/formatter/
|
||||||
|
|
||||||
|
SDFormatter aligns flash erase boundaries with file
|
||||||
|
system structures which reduces write latency and file system overhead.
|
||||||
|
|
||||||
|
SDFormatter does not have an option for FAT type so it may format
|
||||||
|
small cards as FAT12.
|
||||||
|
|
||||||
|
After the MBR is restored by SDFormatter you may need to reformat small
|
||||||
|
cards that have been formatted FAT12 to force the volume type to be FAT16.
|
||||||
|
|
||||||
|
If you reformat the SD card with an OS utility, choose a cluster size that
|
||||||
|
will result in:
|
||||||
|
|
||||||
|
4084 < CountOfClusters && CountOfClusters < 65525
|
||||||
|
|
||||||
|
The volume will then be FAT16.
|
||||||
|
|
||||||
|
If you are formatting an SD card on OS X or Linux, be sure to use the first
|
||||||
|
partition. Format this partition with a cluster count in above range.
|
||||||
|
|
||||||
|
\section References References
|
||||||
|
|
||||||
|
Adafruit Industries:
|
||||||
|
|
||||||
|
http://www.adafruit.com/
|
||||||
|
|
||||||
|
http://www.ladyada.net/make/waveshield/
|
||||||
|
|
||||||
|
The Arduino site:
|
||||||
|
|
||||||
|
http://www.arduino.cc/
|
||||||
|
|
||||||
|
For more information about FAT file systems see:
|
||||||
|
|
||||||
|
http://www.microsoft.com/whdc/system/platform/firmware/fatgen.mspx
|
||||||
|
|
||||||
|
For information about using SD cards as SPI devices see:
|
||||||
|
|
||||||
|
http://www.sdcard.org/developers/tech/sdcard/pls/Simplified_Physical_Layer_Spec.pdf
|
||||||
|
|
||||||
|
The ATmega328 datasheet:
|
||||||
|
|
||||||
|
http://www.atmel.com/dyn/resources/prod_documents/doc8161.pdf
|
||||||
|
|
||||||
|
|
||||||
|
*/
|
@ -0,0 +1,1252 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#include "SdFat.h"
|
||||||
|
#include <avr/pgmspace.h>
|
||||||
|
#include <WProgram.h>
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// callback function for date/time
|
||||||
|
void (*SdFile::dateTime_)(uint16_t* date, uint16_t* time) = NULL;
|
||||||
|
|
||||||
|
#if ALLOW_DEPRECATED_FUNCTIONS
|
||||||
|
// suppress cpplint warnings with NOLINT comment
|
||||||
|
void (*SdFile::oldDateTime_)(uint16_t& date, uint16_t& time) = NULL; // NOLINT
|
||||||
|
#endif // ALLOW_DEPRECATED_FUNCTIONS
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// add a cluster to a file
|
||||||
|
uint8_t SdFile::addCluster() {
|
||||||
|
if (!vol_->allocContiguous(1, &curCluster_)) return false;
|
||||||
|
|
||||||
|
// if first cluster of file link to directory entry
|
||||||
|
if (firstCluster_ == 0) {
|
||||||
|
firstCluster_ = curCluster_;
|
||||||
|
flags_ |= F_FILE_DIR_DIRTY;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Add a cluster to a directory file and zero the cluster.
|
||||||
|
// return with first block of cluster in the cache
|
||||||
|
uint8_t SdFile::addDirCluster(void) {
|
||||||
|
if (!addCluster()) return false;
|
||||||
|
|
||||||
|
// zero data in cluster insure first cluster is in cache
|
||||||
|
uint32_t block = vol_->clusterStartBlock(curCluster_);
|
||||||
|
for (uint8_t i = vol_->blocksPerCluster_; i != 0; i--) {
|
||||||
|
if (!SdVolume::cacheZeroBlock(block + i - 1)) return false;
|
||||||
|
}
|
||||||
|
// Increase directory file size by cluster size
|
||||||
|
fileSize_ += 512UL << vol_->clusterSizeShift_;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// cache a file's directory entry
|
||||||
|
// return pointer to cached entry or null for failure
|
||||||
|
dir_t* SdFile::cacheDirEntry(uint8_t action) {
|
||||||
|
if (!SdVolume::cacheRawBlock(dirBlock_, action)) return NULL;
|
||||||
|
return SdVolume::cacheBuffer_.dir + dirIndex_;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Close a file and force cached data and directory information
|
||||||
|
* to be written to the storage device.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include no file is open or an I/O error.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::close(void) {
|
||||||
|
if (!sync())return false;
|
||||||
|
type_ = FAT_FILE_TYPE_CLOSED;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Check for contiguous file and return its raw block range.
|
||||||
|
*
|
||||||
|
* \param[out] bgnBlock the first block address for the file.
|
||||||
|
* \param[out] endBlock the last block address for the file.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include file is not contiguous, file has zero length
|
||||||
|
* or an I/O error occurred.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::contiguousRange(uint32_t* bgnBlock, uint32_t* endBlock) {
|
||||||
|
// error if no blocks
|
||||||
|
if (firstCluster_ == 0) return false;
|
||||||
|
|
||||||
|
for (uint32_t c = firstCluster_; ; c++) {
|
||||||
|
uint32_t next;
|
||||||
|
if (!vol_->fatGet(c, &next)) return false;
|
||||||
|
|
||||||
|
// check for contiguous
|
||||||
|
if (next != (c + 1)) {
|
||||||
|
// error if not end of chain
|
||||||
|
if (!vol_->isEOC(next)) return false;
|
||||||
|
*bgnBlock = vol_->clusterStartBlock(firstCluster_);
|
||||||
|
*endBlock = vol_->clusterStartBlock(c)
|
||||||
|
+ vol_->blocksPerCluster_ - 1;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Create and open a new contiguous file of a specified size.
|
||||||
|
*
|
||||||
|
* \note This function only supports short DOS 8.3 names.
|
||||||
|
* See open() for more information.
|
||||||
|
*
|
||||||
|
* \param[in] dirFile The directory where the file will be created.
|
||||||
|
* \param[in] fileName A valid DOS 8.3 file name.
|
||||||
|
* \param[in] size The desired file size.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include \a fileName contains
|
||||||
|
* an invalid DOS 8.3 file name, the FAT volume has not been initialized,
|
||||||
|
* a file is already open, the file already exists, the root
|
||||||
|
* directory is full or an I/O error.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::createContiguous(SdFile* dirFile,
|
||||||
|
const char* fileName, uint32_t size) {
|
||||||
|
// don't allow zero length file
|
||||||
|
if (size == 0) return false;
|
||||||
|
if (!open(dirFile, fileName, O_CREAT | O_EXCL | O_RDWR)) return false;
|
||||||
|
|
||||||
|
// calculate number of clusters needed
|
||||||
|
uint32_t count = ((size - 1) >> (vol_->clusterSizeShift_ + 9)) + 1;
|
||||||
|
|
||||||
|
// allocate clusters
|
||||||
|
if (!vol_->allocContiguous(count, &firstCluster_)) {
|
||||||
|
remove();
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
fileSize_ = size;
|
||||||
|
|
||||||
|
// insure sync() will update dir entry
|
||||||
|
flags_ |= F_FILE_DIR_DIRTY;
|
||||||
|
return sync();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Return a files directory entry
|
||||||
|
*
|
||||||
|
* \param[out] dir Location for return of the files directory entry.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::dirEntry(dir_t* dir) {
|
||||||
|
// make sure fields on SD are correct
|
||||||
|
if (!sync()) return false;
|
||||||
|
|
||||||
|
// read entry
|
||||||
|
dir_t* p = cacheDirEntry(SdVolume::CACHE_FOR_READ);
|
||||||
|
if (!p) return false;
|
||||||
|
|
||||||
|
// copy to caller's struct
|
||||||
|
memcpy(dir, p, sizeof(dir_t));
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Format the name field of \a dir into the 13 byte array
|
||||||
|
* \a name in standard 8.3 short name format.
|
||||||
|
*
|
||||||
|
* \param[in] dir The directory structure containing the name.
|
||||||
|
* \param[out] name A 13 byte char array for the formatted name.
|
||||||
|
*/
|
||||||
|
void SdFile::dirName(const dir_t& dir, char* name) {
|
||||||
|
uint8_t j = 0;
|
||||||
|
for (uint8_t i = 0; i < 11; i++) {
|
||||||
|
if (dir.name[i] == ' ')continue;
|
||||||
|
if (i == 8) name[j++] = '.';
|
||||||
|
name[j++] = dir.name[i];
|
||||||
|
}
|
||||||
|
name[j] = 0;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** List directory contents to Serial.
|
||||||
|
*
|
||||||
|
* \param[in] flags The inclusive OR of
|
||||||
|
*
|
||||||
|
* LS_DATE - %Print file modification date
|
||||||
|
*
|
||||||
|
* LS_SIZE - %Print file size.
|
||||||
|
*
|
||||||
|
* LS_R - Recursive list of subdirectories.
|
||||||
|
*
|
||||||
|
* \param[in] indent Amount of space before file name. Used for recursive
|
||||||
|
* list to indicate subdirectory level.
|
||||||
|
*/
|
||||||
|
void SdFile::ls(uint8_t flags, uint8_t indent) {
|
||||||
|
dir_t* p;
|
||||||
|
|
||||||
|
rewind();
|
||||||
|
while ((p = readDirCache())) {
|
||||||
|
// done if past last used entry
|
||||||
|
if (p->name[0] == DIR_NAME_FREE) break;
|
||||||
|
|
||||||
|
// skip deleted entry and entries for . and ..
|
||||||
|
if (p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') continue;
|
||||||
|
|
||||||
|
// only list subdirectories and files
|
||||||
|
if (!DIR_IS_FILE_OR_SUBDIR(p)) continue;
|
||||||
|
|
||||||
|
// print any indent spaces
|
||||||
|
for (int8_t i = 0; i < indent; i++) Serial.print(' ');
|
||||||
|
|
||||||
|
// print file name with possible blank fill
|
||||||
|
printDirName(*p, flags & (LS_DATE | LS_SIZE) ? 14 : 0);
|
||||||
|
|
||||||
|
// print modify date/time if requested
|
||||||
|
if (flags & LS_DATE) {
|
||||||
|
printFatDate(p->lastWriteDate);
|
||||||
|
Serial.print(' ');
|
||||||
|
printFatTime(p->lastWriteTime);
|
||||||
|
}
|
||||||
|
// print size if requested
|
||||||
|
if (!DIR_IS_SUBDIR(p) && (flags & LS_SIZE)) {
|
||||||
|
Serial.print(' ');
|
||||||
|
Serial.print(p->fileSize);
|
||||||
|
}
|
||||||
|
Serial.println();
|
||||||
|
|
||||||
|
// list subdirectory content if requested
|
||||||
|
if ((flags & LS_R) && DIR_IS_SUBDIR(p)) {
|
||||||
|
uint16_t index = curPosition()/32 - 1;
|
||||||
|
SdFile s;
|
||||||
|
if (s.open(this, index, O_READ)) s.ls(flags, indent + 2);
|
||||||
|
seekSet(32 * (index + 1));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// format directory name field from a 8.3 name string
|
||||||
|
uint8_t SdFile::make83Name(const char* str, uint8_t* name) {
|
||||||
|
uint8_t c;
|
||||||
|
uint8_t n = 7; // max index for part before dot
|
||||||
|
uint8_t i = 0;
|
||||||
|
// blank fill name and extension
|
||||||
|
while (i < 11) name[i++] = ' ';
|
||||||
|
i = 0;
|
||||||
|
while ((c = *str++) != '\0') {
|
||||||
|
if (c == '.') {
|
||||||
|
if (n == 10) return false; // only one dot allowed
|
||||||
|
n = 10; // max index for full 8.3 name
|
||||||
|
i = 8; // place for extension
|
||||||
|
} else {
|
||||||
|
// illegal FAT characters
|
||||||
|
PGM_P p = PSTR("|<>^+=?/[];,*\"\\");
|
||||||
|
uint8_t b;
|
||||||
|
while ((b = pgm_read_byte(p++))) if (b == c) return false;
|
||||||
|
// check size and only allow ASCII printable characters
|
||||||
|
if (i > n || c < 0X21 || c > 0X7E)return false;
|
||||||
|
// only upper case allowed in 8.3 names - convert lower to upper
|
||||||
|
name[i++] = c < 'a' || c > 'z' ? c : c + ('A' - 'a');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// must have a file name, extension is optional
|
||||||
|
return name[0] != ' ';
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Make a new directory.
|
||||||
|
*
|
||||||
|
* \param[in] dir An open SdFat instance for the directory that will containing
|
||||||
|
* the new directory.
|
||||||
|
*
|
||||||
|
* \param[in] dirName A valid 8.3 DOS name for the new directory.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include this SdFile is already open, \a dir is not a
|
||||||
|
* directory, \a dirName is invalid or already exists in \a dir.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::makeDir(SdFile* dir, const char* dirName) {
|
||||||
|
dir_t d;
|
||||||
|
|
||||||
|
// create a normal file
|
||||||
|
if (!open(dir, dirName, O_CREAT | O_EXCL | O_RDWR)) return false;
|
||||||
|
|
||||||
|
// convert SdFile to directory
|
||||||
|
flags_ = O_READ;
|
||||||
|
type_ = FAT_FILE_TYPE_SUBDIR;
|
||||||
|
|
||||||
|
// allocate and zero first cluster
|
||||||
|
if (!addDirCluster())return false;
|
||||||
|
|
||||||
|
// force entry to SD
|
||||||
|
if (!sync()) return false;
|
||||||
|
|
||||||
|
// cache entry - should already be in cache due to sync() call
|
||||||
|
dir_t* p = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);
|
||||||
|
if (!p) return false;
|
||||||
|
|
||||||
|
// change directory entry attribute
|
||||||
|
p->attributes = DIR_ATT_DIRECTORY;
|
||||||
|
|
||||||
|
// make entry for '.'
|
||||||
|
memcpy(&d, p, sizeof(d));
|
||||||
|
for (uint8_t i = 1; i < 11; i++) d.name[i] = ' ';
|
||||||
|
d.name[0] = '.';
|
||||||
|
|
||||||
|
// cache block for '.' and '..'
|
||||||
|
uint32_t block = vol_->clusterStartBlock(firstCluster_);
|
||||||
|
if (!SdVolume::cacheRawBlock(block, SdVolume::CACHE_FOR_WRITE)) return false;
|
||||||
|
|
||||||
|
// copy '.' to block
|
||||||
|
memcpy(&SdVolume::cacheBuffer_.dir[0], &d, sizeof(d));
|
||||||
|
|
||||||
|
// make entry for '..'
|
||||||
|
d.name[1] = '.';
|
||||||
|
if (dir->isRoot()) {
|
||||||
|
d.firstClusterLow = 0;
|
||||||
|
d.firstClusterHigh = 0;
|
||||||
|
} else {
|
||||||
|
d.firstClusterLow = dir->firstCluster_ & 0XFFFF;
|
||||||
|
d.firstClusterHigh = dir->firstCluster_ >> 16;
|
||||||
|
}
|
||||||
|
// copy '..' to block
|
||||||
|
memcpy(&SdVolume::cacheBuffer_.dir[1], &d, sizeof(d));
|
||||||
|
|
||||||
|
// set position after '..'
|
||||||
|
curPosition_ = 2 * sizeof(d);
|
||||||
|
|
||||||
|
// write first block
|
||||||
|
return SdVolume::cacheFlush();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Open a file or directory by name.
|
||||||
|
*
|
||||||
|
* \param[in] dirFile An open SdFat instance for the directory containing the
|
||||||
|
* file to be opened.
|
||||||
|
*
|
||||||
|
* \param[in] fileName A valid 8.3 DOS name for a file to be opened.
|
||||||
|
*
|
||||||
|
* \param[in] oflag Values for \a oflag are constructed by a bitwise-inclusive
|
||||||
|
* OR of flags from the following list
|
||||||
|
*
|
||||||
|
* O_READ - Open for reading.
|
||||||
|
*
|
||||||
|
* O_RDONLY - Same as O_READ.
|
||||||
|
*
|
||||||
|
* O_WRITE - Open for writing.
|
||||||
|
*
|
||||||
|
* O_WRONLY - Same as O_WRITE.
|
||||||
|
*
|
||||||
|
* O_RDWR - Open for reading and writing.
|
||||||
|
*
|
||||||
|
* O_APPEND - If set, the file offset shall be set to the end of the
|
||||||
|
* file prior to each write.
|
||||||
|
*
|
||||||
|
* O_CREAT - If the file exists, this flag has no effect except as noted
|
||||||
|
* under O_EXCL below. Otherwise, the file shall be created
|
||||||
|
*
|
||||||
|
* O_EXCL - If O_CREAT and O_EXCL are set, open() shall fail if the file exists.
|
||||||
|
*
|
||||||
|
* O_SYNC - Call sync() after each write. This flag should not be used with
|
||||||
|
* write(uint8_t), write_P(PGM_P), writeln_P(PGM_P), or the Arduino Print class.
|
||||||
|
* These functions do character at a time writes so sync() will be called
|
||||||
|
* after each byte.
|
||||||
|
*
|
||||||
|
* O_TRUNC - If the file exists and is a regular file, and the file is
|
||||||
|
* successfully opened and is not read only, its length shall be truncated to 0.
|
||||||
|
*
|
||||||
|
* \note Directory files must be opened read only. Write and truncation is
|
||||||
|
* not allowed for directory files.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include this SdFile is already open, \a difFile is not
|
||||||
|
* a directory, \a fileName is invalid, the file does not exist
|
||||||
|
* or can't be opened in the access mode specified by oflag.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::open(SdFile* dirFile, const char* fileName, uint8_t oflag) {
|
||||||
|
uint8_t dname[11];
|
||||||
|
dir_t* p;
|
||||||
|
|
||||||
|
// error if already open
|
||||||
|
if (isOpen())return false;
|
||||||
|
|
||||||
|
if (!make83Name(fileName, dname)) return false;
|
||||||
|
vol_ = dirFile->vol_;
|
||||||
|
dirFile->rewind();
|
||||||
|
|
||||||
|
// bool for empty entry found
|
||||||
|
uint8_t emptyFound = false;
|
||||||
|
|
||||||
|
// search for file
|
||||||
|
while (dirFile->curPosition_ < dirFile->fileSize_) {
|
||||||
|
uint8_t index = 0XF & (dirFile->curPosition_ >> 5);
|
||||||
|
p = dirFile->readDirCache();
|
||||||
|
if (p == NULL) return false;
|
||||||
|
|
||||||
|
if (p->name[0] == DIR_NAME_FREE || p->name[0] == DIR_NAME_DELETED) {
|
||||||
|
// remember first empty slot
|
||||||
|
if (!emptyFound) {
|
||||||
|
emptyFound = true;
|
||||||
|
dirIndex_ = index;
|
||||||
|
dirBlock_ = SdVolume::cacheBlockNumber_;
|
||||||
|
}
|
||||||
|
// done if no entries follow
|
||||||
|
if (p->name[0] == DIR_NAME_FREE) break;
|
||||||
|
} else if (!memcmp(dname, p->name, 11)) {
|
||||||
|
// don't open existing file if O_CREAT and O_EXCL
|
||||||
|
if ((oflag & (O_CREAT | O_EXCL)) == (O_CREAT | O_EXCL)) return false;
|
||||||
|
|
||||||
|
// open found file
|
||||||
|
return openCachedEntry(0XF & index, oflag);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// only create file if O_CREAT and O_WRITE
|
||||||
|
if ((oflag & (O_CREAT | O_WRITE)) != (O_CREAT | O_WRITE)) return false;
|
||||||
|
|
||||||
|
// cache found slot or add cluster if end of file
|
||||||
|
if (emptyFound) {
|
||||||
|
p = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);
|
||||||
|
if (!p) return false;
|
||||||
|
} else {
|
||||||
|
if (dirFile->type_ == FAT_FILE_TYPE_ROOT16) return false;
|
||||||
|
|
||||||
|
// add and zero cluster for dirFile - first cluster is in cache for write
|
||||||
|
if (!dirFile->addDirCluster()) return false;
|
||||||
|
|
||||||
|
// use first entry in cluster
|
||||||
|
dirIndex_ = 0;
|
||||||
|
p = SdVolume::cacheBuffer_.dir;
|
||||||
|
}
|
||||||
|
// initialize as empty file
|
||||||
|
memset(p, 0, sizeof(dir_t));
|
||||||
|
memcpy(p->name, dname, 11);
|
||||||
|
|
||||||
|
// set timestamps
|
||||||
|
if (dateTime_) {
|
||||||
|
// call user function
|
||||||
|
dateTime_(&p->creationDate, &p->creationTime);
|
||||||
|
} else {
|
||||||
|
// use default date/time
|
||||||
|
p->creationDate = FAT_DEFAULT_DATE;
|
||||||
|
p->creationTime = FAT_DEFAULT_TIME;
|
||||||
|
}
|
||||||
|
p->lastAccessDate = p->creationDate;
|
||||||
|
p->lastWriteDate = p->creationDate;
|
||||||
|
p->lastWriteTime = p->creationTime;
|
||||||
|
|
||||||
|
// force write of entry to SD
|
||||||
|
if (!SdVolume::cacheFlush()) return false;
|
||||||
|
|
||||||
|
// open entry in cache
|
||||||
|
return openCachedEntry(dirIndex_, oflag);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Open a file by index.
|
||||||
|
*
|
||||||
|
* \param[in] dirFile An open SdFat instance for the directory.
|
||||||
|
*
|
||||||
|
* \param[in] index The \a index of the directory entry for the file to be
|
||||||
|
* opened. The value for \a index is (directory file position)/32.
|
||||||
|
*
|
||||||
|
* \param[in] oflag Values for \a oflag are constructed by a bitwise-inclusive
|
||||||
|
* OR of flags O_READ, O_WRITE, O_TRUNC, and O_SYNC.
|
||||||
|
*
|
||||||
|
* See open() by fileName for definition of flags and return values.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::open(SdFile* dirFile, uint16_t index, uint8_t oflag) {
|
||||||
|
// error if already open
|
||||||
|
if (isOpen())return false;
|
||||||
|
|
||||||
|
// don't open existing file if O_CREAT and O_EXCL - user call error
|
||||||
|
if ((oflag & (O_CREAT | O_EXCL)) == (O_CREAT | O_EXCL)) return false;
|
||||||
|
|
||||||
|
vol_ = dirFile->vol_;
|
||||||
|
|
||||||
|
// seek to location of entry
|
||||||
|
if (!dirFile->seekSet(32 * index)) return false;
|
||||||
|
|
||||||
|
// read entry into cache
|
||||||
|
dir_t* p = dirFile->readDirCache();
|
||||||
|
if (p == NULL) return false;
|
||||||
|
|
||||||
|
// error if empty slot or '.' or '..'
|
||||||
|
if (p->name[0] == DIR_NAME_FREE ||
|
||||||
|
p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
// open cached entry
|
||||||
|
return openCachedEntry(index & 0XF, oflag);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// open a cached directory entry. Assumes vol_ is initializes
|
||||||
|
uint8_t SdFile::openCachedEntry(uint8_t dirIndex, uint8_t oflag) {
|
||||||
|
// location of entry in cache
|
||||||
|
dir_t* p = SdVolume::cacheBuffer_.dir + dirIndex;
|
||||||
|
|
||||||
|
// write or truncate is an error for a directory or read-only file
|
||||||
|
if (p->attributes & (DIR_ATT_READ_ONLY | DIR_ATT_DIRECTORY)) {
|
||||||
|
if (oflag & (O_WRITE | O_TRUNC)) return false;
|
||||||
|
}
|
||||||
|
// remember location of directory entry on SD
|
||||||
|
dirIndex_ = dirIndex;
|
||||||
|
dirBlock_ = SdVolume::cacheBlockNumber_;
|
||||||
|
|
||||||
|
// copy first cluster number for directory fields
|
||||||
|
firstCluster_ = (uint32_t)p->firstClusterHigh << 16;
|
||||||
|
firstCluster_ |= p->firstClusterLow;
|
||||||
|
|
||||||
|
// make sure it is a normal file or subdirectory
|
||||||
|
if (DIR_IS_FILE(p)) {
|
||||||
|
fileSize_ = p->fileSize;
|
||||||
|
type_ = FAT_FILE_TYPE_NORMAL;
|
||||||
|
} else if (DIR_IS_SUBDIR(p)) {
|
||||||
|
if (!vol_->chainSize(firstCluster_, &fileSize_)) return false;
|
||||||
|
type_ = FAT_FILE_TYPE_SUBDIR;
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
// save open flags for read/write
|
||||||
|
flags_ = oflag & (O_ACCMODE | O_SYNC | O_APPEND);
|
||||||
|
|
||||||
|
// set to start of file
|
||||||
|
curCluster_ = 0;
|
||||||
|
curPosition_ = 0;
|
||||||
|
|
||||||
|
// truncate file to zero length if requested
|
||||||
|
if (oflag & O_TRUNC) return truncate(0);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Open a volume's root directory.
|
||||||
|
*
|
||||||
|
* \param[in] vol The FAT volume containing the root directory to be opened.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include the FAT volume has not been initialized
|
||||||
|
* or it a FAT12 volume.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::openRoot(SdVolume* vol) {
|
||||||
|
// error if file is already open
|
||||||
|
if (isOpen()) return false;
|
||||||
|
|
||||||
|
if (vol->fatType() == 16) {
|
||||||
|
type_ = FAT_FILE_TYPE_ROOT16;
|
||||||
|
firstCluster_ = 0;
|
||||||
|
fileSize_ = 32 * vol->rootDirEntryCount();
|
||||||
|
} else if (vol->fatType() == 32) {
|
||||||
|
type_ = FAT_FILE_TYPE_ROOT32;
|
||||||
|
firstCluster_ = vol->rootDirStart();
|
||||||
|
if (!vol->chainSize(firstCluster_, &fileSize_)) return false;
|
||||||
|
} else {
|
||||||
|
// volume is not initialized or FAT12
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
vol_ = vol;
|
||||||
|
// read only
|
||||||
|
flags_ = O_READ;
|
||||||
|
|
||||||
|
// set to start of file
|
||||||
|
curCluster_ = 0;
|
||||||
|
curPosition_ = 0;
|
||||||
|
|
||||||
|
// root has no directory entry
|
||||||
|
dirBlock_ = 0;
|
||||||
|
dirIndex_ = 0;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** %Print the name field of a directory entry in 8.3 format to Serial.
|
||||||
|
*
|
||||||
|
* \param[in] dir The directory structure containing the name.
|
||||||
|
* \param[in] width Blank fill name if length is less than \a width.
|
||||||
|
*/
|
||||||
|
void SdFile::printDirName(const dir_t& dir, uint8_t width) {
|
||||||
|
uint8_t w = 0;
|
||||||
|
for (uint8_t i = 0; i < 11; i++) {
|
||||||
|
if (dir.name[i] == ' ')continue;
|
||||||
|
if (i == 8) {
|
||||||
|
Serial.print('.');
|
||||||
|
w++;
|
||||||
|
}
|
||||||
|
Serial.print(dir.name[i]);
|
||||||
|
w++;
|
||||||
|
}
|
||||||
|
if (DIR_IS_SUBDIR(&dir)) {
|
||||||
|
Serial.print('/');
|
||||||
|
w++;
|
||||||
|
}
|
||||||
|
while (w < width) {
|
||||||
|
Serial.print(' ');
|
||||||
|
w++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** %Print a directory date field to Serial.
|
||||||
|
*
|
||||||
|
* Format is yyyy-mm-dd.
|
||||||
|
*
|
||||||
|
* \param[in] fatDate The date field from a directory entry.
|
||||||
|
*/
|
||||||
|
void SdFile::printFatDate(uint16_t fatDate) {
|
||||||
|
Serial.print(FAT_YEAR(fatDate));
|
||||||
|
Serial.print('-');
|
||||||
|
printTwoDigits(FAT_MONTH(fatDate));
|
||||||
|
Serial.print('-');
|
||||||
|
printTwoDigits(FAT_DAY(fatDate));
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** %Print a directory time field to Serial.
|
||||||
|
*
|
||||||
|
* Format is hh:mm:ss.
|
||||||
|
*
|
||||||
|
* \param[in] fatTime The time field from a directory entry.
|
||||||
|
*/
|
||||||
|
void SdFile::printFatTime(uint16_t fatTime) {
|
||||||
|
printTwoDigits(FAT_HOUR(fatTime));
|
||||||
|
Serial.print(':');
|
||||||
|
printTwoDigits(FAT_MINUTE(fatTime));
|
||||||
|
Serial.print(':');
|
||||||
|
printTwoDigits(FAT_SECOND(fatTime));
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** %Print a value as two digits to Serial.
|
||||||
|
*
|
||||||
|
* \param[in] v Value to be printed, 0 <= \a v <= 99
|
||||||
|
*/
|
||||||
|
void SdFile::printTwoDigits(uint8_t v) {
|
||||||
|
char str[3];
|
||||||
|
str[0] = '0' + v/10;
|
||||||
|
str[1] = '0' + v % 10;
|
||||||
|
str[2] = 0;
|
||||||
|
Serial.print(str);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Read data from a file starting at the current position.
|
||||||
|
*
|
||||||
|
* \param[out] buf Pointer to the location that will receive the data.
|
||||||
|
*
|
||||||
|
* \param[in] nbyte Maximum number of bytes to read.
|
||||||
|
*
|
||||||
|
* \return For success read() returns the number of bytes read.
|
||||||
|
* A value less than \a nbyte, including zero, will be returned
|
||||||
|
* if end of file is reached.
|
||||||
|
* If an error occurs, read() returns -1. Possible errors include
|
||||||
|
* read() called before a file has been opened, corrupt file system
|
||||||
|
* or an I/O error occurred.
|
||||||
|
*/
|
||||||
|
int16_t SdFile::read(void* buf, uint16_t nbyte) {
|
||||||
|
uint8_t* dst = reinterpret_cast<uint8_t*>(buf);
|
||||||
|
|
||||||
|
// error if not open or write only
|
||||||
|
if (!isOpen() || !(flags_ & O_READ)) return -1;
|
||||||
|
|
||||||
|
// max bytes left in file
|
||||||
|
if (nbyte > (fileSize_ - curPosition_)) nbyte = fileSize_ - curPosition_;
|
||||||
|
|
||||||
|
// amount left to read
|
||||||
|
uint16_t toRead = nbyte;
|
||||||
|
while (toRead > 0) {
|
||||||
|
uint32_t block; // raw device block number
|
||||||
|
uint16_t offset = curPosition_ & 0X1FF; // offset in block
|
||||||
|
if (type_ == FAT_FILE_TYPE_ROOT16) {
|
||||||
|
block = vol_->rootDirStart() + (curPosition_ >> 9);
|
||||||
|
} else {
|
||||||
|
uint8_t blockOfCluster = vol_->blockOfCluster(curPosition_);
|
||||||
|
if (offset == 0 && blockOfCluster == 0) {
|
||||||
|
// start of new cluster
|
||||||
|
if (curPosition_ == 0) {
|
||||||
|
// use first cluster in file
|
||||||
|
curCluster_ = firstCluster_;
|
||||||
|
} else {
|
||||||
|
// get next cluster from FAT
|
||||||
|
if (!vol_->fatGet(curCluster_, &curCluster_)) return -1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
block = vol_->clusterStartBlock(curCluster_) + blockOfCluster;
|
||||||
|
}
|
||||||
|
uint16_t n = toRead;
|
||||||
|
|
||||||
|
// amount to be read from current block
|
||||||
|
if (n > (512 - offset)) n = 512 - offset;
|
||||||
|
|
||||||
|
// no buffering needed if n == 512 or user requests no buffering
|
||||||
|
if ((unbufferedRead() || n == 512) &&
|
||||||
|
block != SdVolume::cacheBlockNumber_) {
|
||||||
|
if (!vol_->readData(block, offset, n, dst)) return -1;
|
||||||
|
dst += n;
|
||||||
|
} else {
|
||||||
|
// read block to cache and copy data to caller
|
||||||
|
if (!SdVolume::cacheRawBlock(block, SdVolume::CACHE_FOR_READ)) return -1;
|
||||||
|
uint8_t* src = SdVolume::cacheBuffer_.data + offset;
|
||||||
|
uint8_t* end = src + n;
|
||||||
|
while (src != end) *dst++ = *src++;
|
||||||
|
}
|
||||||
|
curPosition_ += n;
|
||||||
|
toRead -= n;
|
||||||
|
}
|
||||||
|
return nbyte;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Read the next directory entry from a directory file.
|
||||||
|
*
|
||||||
|
* \param[out] dir The dir_t struct that will receive the data.
|
||||||
|
*
|
||||||
|
* \return For success readDir() returns the number of bytes read.
|
||||||
|
* A value of zero will be returned if end of file is reached.
|
||||||
|
* If an error occurs, readDir() returns -1. Possible errors include
|
||||||
|
* readDir() called before a directory has been opened, this is not
|
||||||
|
* a directory file or an I/O error occurred.
|
||||||
|
*/
|
||||||
|
int8_t SdFile::readDir(dir_t* dir) {
|
||||||
|
int8_t n;
|
||||||
|
// if not a directory file or miss-positioned return an error
|
||||||
|
if (!isDir() || (0X1F & curPosition_)) return -1;
|
||||||
|
|
||||||
|
while ((n = read(dir, sizeof(dir_t))) == sizeof(dir_t)) {
|
||||||
|
// last entry if DIR_NAME_FREE
|
||||||
|
if (dir->name[0] == DIR_NAME_FREE) break;
|
||||||
|
// skip empty entries and entry for . and ..
|
||||||
|
if (dir->name[0] == DIR_NAME_DELETED || dir->name[0] == '.') continue;
|
||||||
|
// return if normal file or subdirectory
|
||||||
|
if (DIR_IS_FILE_OR_SUBDIR(dir)) return n;
|
||||||
|
}
|
||||||
|
// error, end of file, or past last entry
|
||||||
|
return n < 0 ? -1 : 0;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Read next directory entry into the cache
|
||||||
|
// Assumes file is correctly positioned
|
||||||
|
dir_t* SdFile::readDirCache(void) {
|
||||||
|
// error if not directory
|
||||||
|
if (!isDir()) return NULL;
|
||||||
|
|
||||||
|
// index of entry in cache
|
||||||
|
uint8_t i = (curPosition_ >> 5) & 0XF;
|
||||||
|
|
||||||
|
// use read to locate and cache block
|
||||||
|
if (read() < 0) return NULL;
|
||||||
|
|
||||||
|
// advance to next entry
|
||||||
|
curPosition_ += 31;
|
||||||
|
|
||||||
|
// return pointer to entry
|
||||||
|
return (SdVolume::cacheBuffer_.dir + i);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Remove a file.
|
||||||
|
*
|
||||||
|
* The directory entry and all data for the file are deleted.
|
||||||
|
*
|
||||||
|
* \note This function should not be used to delete the 8.3 version of a
|
||||||
|
* file that has a long name. For example if a file has the long name
|
||||||
|
* "New Text Document.txt" you should not delete the 8.3 name "NEWTEX~1.TXT".
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include the file read-only, is a directory,
|
||||||
|
* or an I/O error occurred.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::remove(void) {
|
||||||
|
// free any clusters - will fail if read-only or directory
|
||||||
|
if (!truncate(0)) return false;
|
||||||
|
|
||||||
|
// cache directory entry
|
||||||
|
dir_t* d = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);
|
||||||
|
if (!d) return false;
|
||||||
|
|
||||||
|
// mark entry deleted
|
||||||
|
d->name[0] = DIR_NAME_DELETED;
|
||||||
|
|
||||||
|
// set this SdFile closed
|
||||||
|
type_ = FAT_FILE_TYPE_CLOSED;
|
||||||
|
|
||||||
|
// write entry to SD
|
||||||
|
return SdVolume::cacheFlush();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Remove a file.
|
||||||
|
*
|
||||||
|
* The directory entry and all data for the file are deleted.
|
||||||
|
*
|
||||||
|
* \param[in] dirFile The directory that contains the file.
|
||||||
|
* \param[in] fileName The name of the file to be removed.
|
||||||
|
*
|
||||||
|
* \note This function should not be used to delete the 8.3 version of a
|
||||||
|
* file that has a long name. For example if a file has the long name
|
||||||
|
* "New Text Document.txt" you should not delete the 8.3 name "NEWTEX~1.TXT".
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include the file is a directory, is read only,
|
||||||
|
* \a dirFile is not a directory, \a fileName is not found
|
||||||
|
* or an I/O error occurred.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::remove(SdFile* dirFile, const char* fileName) {
|
||||||
|
SdFile file;
|
||||||
|
if (!file.open(dirFile, fileName, O_WRITE)) return false;
|
||||||
|
return file.remove();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Remove a directory file.
|
||||||
|
*
|
||||||
|
* The directory file will be removed only if it is empty and is not the
|
||||||
|
* root directory. rmDir() follows DOS and Windows and ignores the
|
||||||
|
* read-only attribute for the directory.
|
||||||
|
*
|
||||||
|
* \note This function should not be used to delete the 8.3 version of a
|
||||||
|
* directory that has a long name. For example if a directory has the
|
||||||
|
* long name "New folder" you should not delete the 8.3 name "NEWFOL~1".
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include the file is not a directory, is the root
|
||||||
|
* directory, is not empty, or an I/O error occurred.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::rmDir(void) {
|
||||||
|
// must be open subdirectory
|
||||||
|
if (!isSubDir()) return false;
|
||||||
|
|
||||||
|
rewind();
|
||||||
|
|
||||||
|
// make sure directory is empty
|
||||||
|
while (curPosition_ < fileSize_) {
|
||||||
|
dir_t* p = readDirCache();
|
||||||
|
if (p == NULL) return false;
|
||||||
|
// done if past last used entry
|
||||||
|
if (p->name[0] == DIR_NAME_FREE) break;
|
||||||
|
// skip empty slot or '.' or '..'
|
||||||
|
if (p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') continue;
|
||||||
|
// error not empty
|
||||||
|
if (DIR_IS_FILE_OR_SUBDIR(p)) return false;
|
||||||
|
}
|
||||||
|
// convert empty directory to normal file for remove
|
||||||
|
type_ = FAT_FILE_TYPE_NORMAL;
|
||||||
|
flags_ |= O_WRITE;
|
||||||
|
return remove();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** Recursively delete a directory and all contained files.
|
||||||
|
*
|
||||||
|
* This is like the Unix/Linux 'rm -rf *' if called with the root directory
|
||||||
|
* hence the name.
|
||||||
|
*
|
||||||
|
* Warning - This will remove all contents of the directory including
|
||||||
|
* subdirectories. The directory will then be removed if it is not root.
|
||||||
|
* The read-only attribute for files will be ignored.
|
||||||
|
*
|
||||||
|
* \note This function should not be used to delete the 8.3 version of
|
||||||
|
* a directory that has a long name. See remove() and rmDir().
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::rmRfStar(void) {
|
||||||
|
rewind();
|
||||||
|
while (curPosition_ < fileSize_) {
|
||||||
|
SdFile f;
|
||||||
|
|
||||||
|
// remember position
|
||||||
|
uint16_t index = curPosition_/32;
|
||||||
|
|
||||||
|
dir_t* p = readDirCache();
|
||||||
|
if (!p) return false;
|
||||||
|
|
||||||
|
// done if past last entry
|
||||||
|
if (p->name[0] == DIR_NAME_FREE) break;
|
||||||
|
|
||||||
|
// skip empty slot or '.' or '..'
|
||||||
|
if (p->name[0] == DIR_NAME_DELETED || p->name[0] == '.') continue;
|
||||||
|
|
||||||
|
// skip if part of long file name or volume label in root
|
||||||
|
if (!DIR_IS_FILE_OR_SUBDIR(p)) continue;
|
||||||
|
|
||||||
|
if (!f.open(this, index, O_READ)) return false;
|
||||||
|
if (f.isSubDir()) {
|
||||||
|
// recursively delete
|
||||||
|
if (!f.rmRfStar()) return false;
|
||||||
|
} else {
|
||||||
|
// ignore read-only
|
||||||
|
f.flags_ |= O_WRITE;
|
||||||
|
if (!f.remove()) return false;
|
||||||
|
}
|
||||||
|
// position to next entry if required
|
||||||
|
if (curPosition_ != (32*(index + 1))) {
|
||||||
|
if (!seekSet(32*(index + 1))) return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// don't try to delete root
|
||||||
|
if (isRoot()) return true;
|
||||||
|
return rmDir();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Sets a file's position.
|
||||||
|
*
|
||||||
|
* \param[in] pos The new position in bytes from the beginning of the file.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::seekSet(uint32_t pos) {
|
||||||
|
// error if file not open or seek past end of file
|
||||||
|
if (!isOpen() || pos > fileSize_) return false;
|
||||||
|
|
||||||
|
if (type_ == FAT_FILE_TYPE_ROOT16) {
|
||||||
|
curPosition_ = pos;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (pos == 0) {
|
||||||
|
// set position to start of file
|
||||||
|
curCluster_ = 0;
|
||||||
|
curPosition_ = 0;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
// calculate cluster index for cur and new position
|
||||||
|
uint32_t nCur = (curPosition_ - 1) >> (vol_->clusterSizeShift_ + 9);
|
||||||
|
uint32_t nNew = (pos - 1) >> (vol_->clusterSizeShift_ + 9);
|
||||||
|
|
||||||
|
if (nNew < nCur || curPosition_ == 0) {
|
||||||
|
// must follow chain from first cluster
|
||||||
|
curCluster_ = firstCluster_;
|
||||||
|
} else {
|
||||||
|
// advance from curPosition
|
||||||
|
nNew -= nCur;
|
||||||
|
}
|
||||||
|
while (nNew--) {
|
||||||
|
if (!vol_->fatGet(curCluster_, &curCluster_)) return false;
|
||||||
|
}
|
||||||
|
curPosition_ = pos;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* The sync() call causes all modified data and directory fields
|
||||||
|
* to be written to the storage device.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include a call to sync() before a file has been
|
||||||
|
* opened or an I/O error.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::sync(void) {
|
||||||
|
// only allow open files and directories
|
||||||
|
if (!isOpen()) return false;
|
||||||
|
|
||||||
|
if (flags_ & F_FILE_DIR_DIRTY) {
|
||||||
|
dir_t* d = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);
|
||||||
|
if (!d) return false;
|
||||||
|
|
||||||
|
// do not set filesize for dir files
|
||||||
|
if (!isDir()) d->fileSize = fileSize_;
|
||||||
|
|
||||||
|
// update first cluster fields
|
||||||
|
d->firstClusterLow = firstCluster_ & 0XFFFF;
|
||||||
|
d->firstClusterHigh = firstCluster_ >> 16;
|
||||||
|
|
||||||
|
// set modify time if user supplied a callback date/time function
|
||||||
|
if (dateTime_) {
|
||||||
|
dateTime_(&d->lastWriteDate, &d->lastWriteTime);
|
||||||
|
d->lastAccessDate = d->lastWriteDate;
|
||||||
|
}
|
||||||
|
// clear directory dirty
|
||||||
|
flags_ &= ~F_FILE_DIR_DIRTY;
|
||||||
|
}
|
||||||
|
return SdVolume::cacheFlush();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Set a file's timestamps in its directory entry.
|
||||||
|
*
|
||||||
|
* \param[in] flags Values for \a flags are constructed by a bitwise-inclusive
|
||||||
|
* OR of flags from the following list
|
||||||
|
*
|
||||||
|
* T_ACCESS - Set the file's last access date.
|
||||||
|
*
|
||||||
|
* T_CREATE - Set the file's creation date and time.
|
||||||
|
*
|
||||||
|
* T_WRITE - Set the file's last write/modification date and time.
|
||||||
|
*
|
||||||
|
* \param[in] year Valid range 1980 - 2107 inclusive.
|
||||||
|
*
|
||||||
|
* \param[in] month Valid range 1 - 12 inclusive.
|
||||||
|
*
|
||||||
|
* \param[in] day Valid range 1 - 31 inclusive.
|
||||||
|
*
|
||||||
|
* \param[in] hour Valid range 0 - 23 inclusive.
|
||||||
|
*
|
||||||
|
* \param[in] minute Valid range 0 - 59 inclusive.
|
||||||
|
*
|
||||||
|
* \param[in] second Valid range 0 - 59 inclusive
|
||||||
|
*
|
||||||
|
* \note It is possible to set an invalid date since there is no check for
|
||||||
|
* the number of days in a month.
|
||||||
|
*
|
||||||
|
* \note
|
||||||
|
* Modify and access timestamps may be overwritten if a date time callback
|
||||||
|
* function has been set by dateTimeCallback().
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::timestamp(uint8_t flags, uint16_t year, uint8_t month,
|
||||||
|
uint8_t day, uint8_t hour, uint8_t minute, uint8_t second) {
|
||||||
|
if (!isOpen()
|
||||||
|
|| year < 1980
|
||||||
|
|| year > 2107
|
||||||
|
|| month < 1
|
||||||
|
|| month > 12
|
||||||
|
|| day < 1
|
||||||
|
|| day > 31
|
||||||
|
|| hour > 23
|
||||||
|
|| minute > 59
|
||||||
|
|| second > 59) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
dir_t* d = cacheDirEntry(SdVolume::CACHE_FOR_WRITE);
|
||||||
|
if (!d) return false;
|
||||||
|
|
||||||
|
uint16_t dirDate = FAT_DATE(year, month, day);
|
||||||
|
uint16_t dirTime = FAT_TIME(hour, minute, second);
|
||||||
|
if (flags & T_ACCESS) {
|
||||||
|
d->lastAccessDate = dirDate;
|
||||||
|
}
|
||||||
|
if (flags & T_CREATE) {
|
||||||
|
d->creationDate = dirDate;
|
||||||
|
d->creationTime = dirTime;
|
||||||
|
// seems to be units of 1/100 second not 1/10 as Microsoft states
|
||||||
|
d->creationTimeTenths = second & 1 ? 100 : 0;
|
||||||
|
}
|
||||||
|
if (flags & T_WRITE) {
|
||||||
|
d->lastWriteDate = dirDate;
|
||||||
|
d->lastWriteTime = dirTime;
|
||||||
|
}
|
||||||
|
SdVolume::cacheSetDirty();
|
||||||
|
return sync();
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Truncate a file to a specified length. The current file position
|
||||||
|
* will be maintained if it is less than or equal to \a length otherwise
|
||||||
|
* it will be set to end of file.
|
||||||
|
*
|
||||||
|
* \param[in] length The desired length for the file.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure.
|
||||||
|
* Reasons for failure include file is read only, file is a directory,
|
||||||
|
* \a length is greater than the current file size or an I/O error occurs.
|
||||||
|
*/
|
||||||
|
uint8_t SdFile::truncate(uint32_t length) {
|
||||||
|
// error if not a normal file or read-only
|
||||||
|
if (!isFile() || !(flags_ & O_WRITE)) return false;
|
||||||
|
|
||||||
|
// error if length is greater than current size
|
||||||
|
if (length > fileSize_) return false;
|
||||||
|
|
||||||
|
// fileSize and length are zero - nothing to do
|
||||||
|
if (fileSize_ == 0) return true;
|
||||||
|
|
||||||
|
// remember position for seek after truncation
|
||||||
|
uint32_t newPos = curPosition_ > length ? length : curPosition_;
|
||||||
|
|
||||||
|
// position to last cluster in truncated file
|
||||||
|
if (!seekSet(length)) return false;
|
||||||
|
|
||||||
|
if (length == 0) {
|
||||||
|
// free all clusters
|
||||||
|
if (!vol_->freeChain(firstCluster_)) return false;
|
||||||
|
firstCluster_ = 0;
|
||||||
|
} else {
|
||||||
|
uint32_t toFree;
|
||||||
|
if (!vol_->fatGet(curCluster_, &toFree)) return false;
|
||||||
|
|
||||||
|
if (!vol_->isEOC(toFree)) {
|
||||||
|
// free extra clusters
|
||||||
|
if (!vol_->freeChain(toFree)) return false;
|
||||||
|
|
||||||
|
// current cluster is end of chain
|
||||||
|
if (!vol_->fatPutEOC(curCluster_)) return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
fileSize_ = length;
|
||||||
|
|
||||||
|
// need to update directory entry
|
||||||
|
flags_ |= F_FILE_DIR_DIRTY;
|
||||||
|
|
||||||
|
if (!sync()) return false;
|
||||||
|
|
||||||
|
// set file to correct position
|
||||||
|
return seekSet(newPos);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Write data to an open file.
|
||||||
|
*
|
||||||
|
* \note Data is moved to the cache but may not be written to the
|
||||||
|
* storage device until sync() is called.
|
||||||
|
*
|
||||||
|
* \param[in] buf Pointer to the location of the data to be written.
|
||||||
|
*
|
||||||
|
* \param[in] nbyte Number of bytes to write.
|
||||||
|
*
|
||||||
|
* \return For success write() returns the number of bytes written, always
|
||||||
|
* \a nbyte. If an error occurs, write() returns -1. Possible errors
|
||||||
|
* include write() is called before a file has been opened, write is called
|
||||||
|
* for a read-only file, device is full, a corrupt file system or an I/O error.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
int16_t SdFile::write(const void* buf, uint16_t nbyte) {
|
||||||
|
// convert void* to uint8_t* - must be before goto statements
|
||||||
|
const uint8_t* src = reinterpret_cast<const uint8_t*>(buf);
|
||||||
|
|
||||||
|
// number of bytes left to write - must be before goto statements
|
||||||
|
uint16_t nToWrite = nbyte;
|
||||||
|
|
||||||
|
// error if not a normal file or is read-only
|
||||||
|
if (!isFile() || !(flags_ & O_WRITE)) goto writeErrorReturn;
|
||||||
|
|
||||||
|
// seek to end of file if append flag
|
||||||
|
if ((flags_ & O_APPEND) && curPosition_ != fileSize_) {
|
||||||
|
if (!seekEnd()) goto writeErrorReturn;
|
||||||
|
}
|
||||||
|
|
||||||
|
while (nToWrite > 0) {
|
||||||
|
uint8_t blockOfCluster = vol_->blockOfCluster(curPosition_);
|
||||||
|
uint16_t blockOffset = curPosition_ & 0X1FF;
|
||||||
|
if (blockOfCluster == 0 && blockOffset == 0) {
|
||||||
|
// start of new cluster
|
||||||
|
if (curCluster_ == 0) {
|
||||||
|
if (firstCluster_ == 0) {
|
||||||
|
// allocate first cluster of file
|
||||||
|
if (!addCluster()) goto writeErrorReturn;
|
||||||
|
} else {
|
||||||
|
curCluster_ = firstCluster_;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
uint32_t next;
|
||||||
|
if (!vol_->fatGet(curCluster_, &next)) return false;
|
||||||
|
if (vol_->isEOC(next)) {
|
||||||
|
// add cluster if at end of chain
|
||||||
|
if (!addCluster()) goto writeErrorReturn;
|
||||||
|
} else {
|
||||||
|
curCluster_ = next;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// max space in block
|
||||||
|
uint16_t n = 512 - blockOffset;
|
||||||
|
|
||||||
|
// lesser of space and amount to write
|
||||||
|
if (n > nToWrite) n = nToWrite;
|
||||||
|
|
||||||
|
// block for data write
|
||||||
|
uint32_t block = vol_->clusterStartBlock(curCluster_) + blockOfCluster;
|
||||||
|
if (n == 512) {
|
||||||
|
// full block - don't need to use cache
|
||||||
|
// invalidate cache if block is in cache
|
||||||
|
if (SdVolume::cacheBlockNumber_ == block) {
|
||||||
|
SdVolume::cacheBlockNumber_ = 0XFFFFFFFF;
|
||||||
|
}
|
||||||
|
if (!vol_->writeBlock(block, src)) goto writeErrorReturn;
|
||||||
|
src += 512;
|
||||||
|
} else {
|
||||||
|
if (blockOffset == 0 && curPosition_ >= fileSize_) {
|
||||||
|
// start of new block don't need to read into cache
|
||||||
|
if (!SdVolume::cacheFlush()) goto writeErrorReturn;
|
||||||
|
SdVolume::cacheBlockNumber_ = block;
|
||||||
|
SdVolume::cacheSetDirty();
|
||||||
|
} else {
|
||||||
|
// rewrite part of block
|
||||||
|
if (!SdVolume::cacheRawBlock(block, SdVolume::CACHE_FOR_WRITE)) {
|
||||||
|
goto writeErrorReturn;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
uint8_t* dst = SdVolume::cacheBuffer_.data + blockOffset;
|
||||||
|
uint8_t* end = dst + n;
|
||||||
|
while (dst != end) *dst++ = *src++;
|
||||||
|
}
|
||||||
|
nToWrite -= n;
|
||||||
|
curPosition_ += n;
|
||||||
|
}
|
||||||
|
if (curPosition_ > fileSize_) {
|
||||||
|
// update fileSize and insure sync will update dir entry
|
||||||
|
fileSize_ = curPosition_;
|
||||||
|
flags_ |= F_FILE_DIR_DIRTY;
|
||||||
|
} else if (dateTime_ && nbyte) {
|
||||||
|
// insure sync will update modified date and time
|
||||||
|
flags_ |= F_FILE_DIR_DIRTY;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (flags_ & O_SYNC) {
|
||||||
|
if (!sync()) goto writeErrorReturn;
|
||||||
|
}
|
||||||
|
return nbyte;
|
||||||
|
|
||||||
|
writeErrorReturn:
|
||||||
|
// return for write error
|
||||||
|
writeError = true;
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Write a byte to a file. Required by the Arduino Print class.
|
||||||
|
*
|
||||||
|
* Use SdFile::writeError to check for errors.
|
||||||
|
*/
|
||||||
|
void SdFile::write(uint8_t b) {
|
||||||
|
write(&b, 1);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Write a string to a file. Used by the Arduino Print class.
|
||||||
|
*
|
||||||
|
* Use SdFile::writeError to check for errors.
|
||||||
|
*/
|
||||||
|
void SdFile::write(const char* str) {
|
||||||
|
write(str, strlen(str));
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Write a PROGMEM string to a file.
|
||||||
|
*
|
||||||
|
* Use SdFile::writeError to check for errors.
|
||||||
|
*/
|
||||||
|
void SdFile::write_P(PGM_P str) {
|
||||||
|
for (uint8_t c; (c = pgm_read_byte(str)); str++) write(c);
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Write a PROGMEM string followed by CR/LF to a file.
|
||||||
|
*
|
||||||
|
* Use SdFile::writeError to check for errors.
|
||||||
|
*/
|
||||||
|
void SdFile::writeln_P(PGM_P str) {
|
||||||
|
write_P(str);
|
||||||
|
println();
|
||||||
|
}
|
@ -0,0 +1,232 @@
|
|||||||
|
/* Arduino Sd2Card Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino Sd2Card Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino Sd2Card Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#ifndef SdInfo_h
|
||||||
|
#define SdInfo_h
|
||||||
|
#include <stdint.h>
|
||||||
|
// Based on the document:
|
||||||
|
//
|
||||||
|
// SD Specifications
|
||||||
|
// Part 1
|
||||||
|
// Physical Layer
|
||||||
|
// Simplified Specification
|
||||||
|
// Version 2.00
|
||||||
|
// September 25, 2006
|
||||||
|
//
|
||||||
|
// www.sdcard.org/developers/tech/sdcard/pls/Simplified_Physical_Layer_Spec.pdf
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// SD card commands
|
||||||
|
/** GO_IDLE_STATE - init card in spi mode if CS low */
|
||||||
|
uint8_t const CMD0 = 0X00;
|
||||||
|
/** SEND_IF_COND - verify SD Memory Card interface operating condition.*/
|
||||||
|
uint8_t const CMD8 = 0X08;
|
||||||
|
/** SEND_CSD - read the Card Specific Data (CSD register) */
|
||||||
|
uint8_t const CMD9 = 0X09;
|
||||||
|
/** SEND_CID - read the card identification information (CID register) */
|
||||||
|
uint8_t const CMD10 = 0X0A;
|
||||||
|
/** SEND_STATUS - read the card status register */
|
||||||
|
uint8_t const CMD13 = 0X0D;
|
||||||
|
/** READ_BLOCK - read a single data block from the card */
|
||||||
|
uint8_t const CMD17 = 0X11;
|
||||||
|
/** WRITE_BLOCK - write a single data block to the card */
|
||||||
|
uint8_t const CMD24 = 0X18;
|
||||||
|
/** WRITE_MULTIPLE_BLOCK - write blocks of data until a STOP_TRANSMISSION */
|
||||||
|
uint8_t const CMD25 = 0X19;
|
||||||
|
/** ERASE_WR_BLK_START - sets the address of the first block to be erased */
|
||||||
|
uint8_t const CMD32 = 0X20;
|
||||||
|
/** ERASE_WR_BLK_END - sets the address of the last block of the continuous
|
||||||
|
range to be erased*/
|
||||||
|
uint8_t const CMD33 = 0X21;
|
||||||
|
/** ERASE - erase all previously selected blocks */
|
||||||
|
uint8_t const CMD38 = 0X26;
|
||||||
|
/** APP_CMD - escape for application specific command */
|
||||||
|
uint8_t const CMD55 = 0X37;
|
||||||
|
/** READ_OCR - read the OCR register of a card */
|
||||||
|
uint8_t const CMD58 = 0X3A;
|
||||||
|
/** SET_WR_BLK_ERASE_COUNT - Set the number of write blocks to be
|
||||||
|
pre-erased before writing */
|
||||||
|
uint8_t const ACMD23 = 0X17;
|
||||||
|
/** SD_SEND_OP_COMD - Sends host capacity support information and
|
||||||
|
activates the card's initialization process */
|
||||||
|
uint8_t const ACMD41 = 0X29;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/** status for card in the ready state */
|
||||||
|
uint8_t const R1_READY_STATE = 0X00;
|
||||||
|
/** status for card in the idle state */
|
||||||
|
uint8_t const R1_IDLE_STATE = 0X01;
|
||||||
|
/** status bit for illegal command */
|
||||||
|
uint8_t const R1_ILLEGAL_COMMAND = 0X04;
|
||||||
|
/** start data token for read or write single block*/
|
||||||
|
uint8_t const DATA_START_BLOCK = 0XFE;
|
||||||
|
/** stop token for write multiple blocks*/
|
||||||
|
uint8_t const STOP_TRAN_TOKEN = 0XFD;
|
||||||
|
/** start data token for write multiple blocks*/
|
||||||
|
uint8_t const WRITE_MULTIPLE_TOKEN = 0XFC;
|
||||||
|
/** mask for data response tokens after a write block operation */
|
||||||
|
uint8_t const DATA_RES_MASK = 0X1F;
|
||||||
|
/** write data accepted token */
|
||||||
|
uint8_t const DATA_RES_ACCEPTED = 0X05;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
typedef struct CID {
|
||||||
|
// byte 0
|
||||||
|
uint8_t mid; // Manufacturer ID
|
||||||
|
// byte 1-2
|
||||||
|
char oid[2]; // OEM/Application ID
|
||||||
|
// byte 3-7
|
||||||
|
char pnm[5]; // Product name
|
||||||
|
// byte 8
|
||||||
|
unsigned prv_m : 4; // Product revision n.m
|
||||||
|
unsigned prv_n : 4;
|
||||||
|
// byte 9-12
|
||||||
|
uint32_t psn; // Product serial number
|
||||||
|
// byte 13
|
||||||
|
unsigned mdt_year_high : 4; // Manufacturing date
|
||||||
|
unsigned reserved : 4;
|
||||||
|
// byte 14
|
||||||
|
unsigned mdt_month : 4;
|
||||||
|
unsigned mdt_year_low :4;
|
||||||
|
// byte 15
|
||||||
|
unsigned always1 : 1;
|
||||||
|
unsigned crc : 7;
|
||||||
|
}cid_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// CSD for version 1.00 cards
|
||||||
|
typedef struct CSDV1 {
|
||||||
|
// byte 0
|
||||||
|
unsigned reserved1 : 6;
|
||||||
|
unsigned csd_ver : 2;
|
||||||
|
// byte 1
|
||||||
|
uint8_t taac;
|
||||||
|
// byte 2
|
||||||
|
uint8_t nsac;
|
||||||
|
// byte 3
|
||||||
|
uint8_t tran_speed;
|
||||||
|
// byte 4
|
||||||
|
uint8_t ccc_high;
|
||||||
|
// byte 5
|
||||||
|
unsigned read_bl_len : 4;
|
||||||
|
unsigned ccc_low : 4;
|
||||||
|
// byte 6
|
||||||
|
unsigned c_size_high : 2;
|
||||||
|
unsigned reserved2 : 2;
|
||||||
|
unsigned dsr_imp : 1;
|
||||||
|
unsigned read_blk_misalign :1;
|
||||||
|
unsigned write_blk_misalign : 1;
|
||||||
|
unsigned read_bl_partial : 1;
|
||||||
|
// byte 7
|
||||||
|
uint8_t c_size_mid;
|
||||||
|
// byte 8
|
||||||
|
unsigned vdd_r_curr_max : 3;
|
||||||
|
unsigned vdd_r_curr_min : 3;
|
||||||
|
unsigned c_size_low :2;
|
||||||
|
// byte 9
|
||||||
|
unsigned c_size_mult_high : 2;
|
||||||
|
unsigned vdd_w_cur_max : 3;
|
||||||
|
unsigned vdd_w_curr_min : 3;
|
||||||
|
// byte 10
|
||||||
|
unsigned sector_size_high : 6;
|
||||||
|
unsigned erase_blk_en : 1;
|
||||||
|
unsigned c_size_mult_low : 1;
|
||||||
|
// byte 11
|
||||||
|
unsigned wp_grp_size : 7;
|
||||||
|
unsigned sector_size_low : 1;
|
||||||
|
// byte 12
|
||||||
|
unsigned write_bl_len_high : 2;
|
||||||
|
unsigned r2w_factor : 3;
|
||||||
|
unsigned reserved3 : 2;
|
||||||
|
unsigned wp_grp_enable : 1;
|
||||||
|
// byte 13
|
||||||
|
unsigned reserved4 : 5;
|
||||||
|
unsigned write_partial : 1;
|
||||||
|
unsigned write_bl_len_low : 2;
|
||||||
|
// byte 14
|
||||||
|
unsigned reserved5: 2;
|
||||||
|
unsigned file_format : 2;
|
||||||
|
unsigned tmp_write_protect : 1;
|
||||||
|
unsigned perm_write_protect : 1;
|
||||||
|
unsigned copy : 1;
|
||||||
|
unsigned file_format_grp : 1;
|
||||||
|
// byte 15
|
||||||
|
unsigned always1 : 1;
|
||||||
|
unsigned crc : 7;
|
||||||
|
}csd1_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// CSD for version 2.00 cards
|
||||||
|
typedef struct CSDV2 {
|
||||||
|
// byte 0
|
||||||
|
unsigned reserved1 : 6;
|
||||||
|
unsigned csd_ver : 2;
|
||||||
|
// byte 1
|
||||||
|
uint8_t taac;
|
||||||
|
// byte 2
|
||||||
|
uint8_t nsac;
|
||||||
|
// byte 3
|
||||||
|
uint8_t tran_speed;
|
||||||
|
// byte 4
|
||||||
|
uint8_t ccc_high;
|
||||||
|
// byte 5
|
||||||
|
unsigned read_bl_len : 4;
|
||||||
|
unsigned ccc_low : 4;
|
||||||
|
// byte 6
|
||||||
|
unsigned reserved2 : 4;
|
||||||
|
unsigned dsr_imp : 1;
|
||||||
|
unsigned read_blk_misalign :1;
|
||||||
|
unsigned write_blk_misalign : 1;
|
||||||
|
unsigned read_bl_partial : 1;
|
||||||
|
// byte 7
|
||||||
|
unsigned reserved3 : 2;
|
||||||
|
unsigned c_size_high : 6;
|
||||||
|
// byte 8
|
||||||
|
uint8_t c_size_mid;
|
||||||
|
// byte 9
|
||||||
|
uint8_t c_size_low;
|
||||||
|
// byte 10
|
||||||
|
unsigned sector_size_high : 6;
|
||||||
|
unsigned erase_blk_en : 1;
|
||||||
|
unsigned reserved4 : 1;
|
||||||
|
// byte 11
|
||||||
|
unsigned wp_grp_size : 7;
|
||||||
|
unsigned sector_size_low : 1;
|
||||||
|
// byte 12
|
||||||
|
unsigned write_bl_len_high : 2;
|
||||||
|
unsigned r2w_factor : 3;
|
||||||
|
unsigned reserved5 : 2;
|
||||||
|
unsigned wp_grp_enable : 1;
|
||||||
|
// byte 13
|
||||||
|
unsigned reserved6 : 5;
|
||||||
|
unsigned write_partial : 1;
|
||||||
|
unsigned write_bl_len_low : 2;
|
||||||
|
// byte 14
|
||||||
|
unsigned reserved7: 2;
|
||||||
|
unsigned file_format : 2;
|
||||||
|
unsigned tmp_write_protect : 1;
|
||||||
|
unsigned perm_write_protect : 1;
|
||||||
|
unsigned copy : 1;
|
||||||
|
unsigned file_format_grp : 1;
|
||||||
|
// byte 15
|
||||||
|
unsigned always1 : 1;
|
||||||
|
unsigned crc : 7;
|
||||||
|
}csd2_t;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// union of old and new style CSD register
|
||||||
|
union csd_t {
|
||||||
|
csd1_t v1;
|
||||||
|
csd2_t v2;
|
||||||
|
};
|
||||||
|
#endif // SdInfo_h
|
@ -0,0 +1,295 @@
|
|||||||
|
/* Arduino SdFat Library
|
||||||
|
* Copyright (C) 2009 by William Greiman
|
||||||
|
*
|
||||||
|
* This file is part of the Arduino SdFat Library
|
||||||
|
*
|
||||||
|
* This Library 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 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 General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU General Public License
|
||||||
|
* along with the Arduino SdFat Library. If not, see
|
||||||
|
* <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
#include "SdFat.h"
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// raw block cache
|
||||||
|
// init cacheBlockNumber_to invalid SD block number
|
||||||
|
uint32_t SdVolume::cacheBlockNumber_ = 0XFFFFFFFF;
|
||||||
|
cache_t SdVolume::cacheBuffer_; // 512 byte cache for Sd2Card
|
||||||
|
Sd2Card* SdVolume::sdCard_; // pointer to SD card object
|
||||||
|
uint8_t SdVolume::cacheDirty_ = 0; // cacheFlush() will write block if true
|
||||||
|
uint32_t SdVolume::cacheMirrorBlock_ = 0; // mirror block for second FAT
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// find a contiguous group of clusters
|
||||||
|
uint8_t SdVolume::allocContiguous(uint32_t count, uint32_t* curCluster) {
|
||||||
|
// start of group
|
||||||
|
uint32_t bgnCluster;
|
||||||
|
|
||||||
|
// flag to save place to start next search
|
||||||
|
uint8_t setStart;
|
||||||
|
|
||||||
|
// set search start cluster
|
||||||
|
if (*curCluster) {
|
||||||
|
// try to make file contiguous
|
||||||
|
bgnCluster = *curCluster + 1;
|
||||||
|
|
||||||
|
// don't save new start location
|
||||||
|
setStart = false;
|
||||||
|
} else {
|
||||||
|
// start at likely place for free cluster
|
||||||
|
bgnCluster = allocSearchStart_;
|
||||||
|
|
||||||
|
// save next search start if one cluster
|
||||||
|
setStart = 1 == count;
|
||||||
|
}
|
||||||
|
// end of group
|
||||||
|
uint32_t endCluster = bgnCluster;
|
||||||
|
|
||||||
|
// last cluster of FAT
|
||||||
|
uint32_t fatEnd = clusterCount_ + 1;
|
||||||
|
|
||||||
|
// search the FAT for free clusters
|
||||||
|
for (uint32_t n = 0;; n++, endCluster++) {
|
||||||
|
// can't find space checked all clusters
|
||||||
|
if (n >= clusterCount_) return false;
|
||||||
|
|
||||||
|
// past end - start from beginning of FAT
|
||||||
|
if (endCluster > fatEnd) {
|
||||||
|
bgnCluster = endCluster = 2;
|
||||||
|
}
|
||||||
|
uint32_t f;
|
||||||
|
if (!fatGet(endCluster, &f)) return false;
|
||||||
|
|
||||||
|
if (f != 0) {
|
||||||
|
// cluster in use try next cluster as bgnCluster
|
||||||
|
bgnCluster = endCluster + 1;
|
||||||
|
} else if ((endCluster - bgnCluster + 1) == count) {
|
||||||
|
// done - found space
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// mark end of chain
|
||||||
|
if (!fatPutEOC(endCluster)) return false;
|
||||||
|
|
||||||
|
// link clusters
|
||||||
|
while (endCluster > bgnCluster) {
|
||||||
|
if (!fatPut(endCluster - 1, endCluster)) return false;
|
||||||
|
endCluster--;
|
||||||
|
}
|
||||||
|
if (*curCluster != 0) {
|
||||||
|
// connect chains
|
||||||
|
if (!fatPut(*curCluster, bgnCluster)) return false;
|
||||||
|
}
|
||||||
|
// return first cluster number to caller
|
||||||
|
*curCluster = bgnCluster;
|
||||||
|
|
||||||
|
// remember possible next free cluster
|
||||||
|
if (setStart) allocSearchStart_ = bgnCluster + 1;
|
||||||
|
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
uint8_t SdVolume::cacheFlush(void) {
|
||||||
|
if (cacheDirty_) {
|
||||||
|
if (!sdCard_->writeBlock(cacheBlockNumber_, cacheBuffer_.data)) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
// mirror FAT tables
|
||||||
|
if (cacheMirrorBlock_) {
|
||||||
|
if (!sdCard_->writeBlock(cacheMirrorBlock_, cacheBuffer_.data)) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
cacheMirrorBlock_ = 0;
|
||||||
|
}
|
||||||
|
cacheDirty_ = 0;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
uint8_t SdVolume::cacheRawBlock(uint32_t blockNumber, uint8_t action) {
|
||||||
|
if (cacheBlockNumber_ != blockNumber) {
|
||||||
|
if (!cacheFlush()) return false;
|
||||||
|
if (!sdCard_->readBlock(blockNumber, cacheBuffer_.data)) return false;
|
||||||
|
cacheBlockNumber_ = blockNumber;
|
||||||
|
}
|
||||||
|
cacheDirty_ |= action;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// cache a zero block for blockNumber
|
||||||
|
uint8_t SdVolume::cacheZeroBlock(uint32_t blockNumber) {
|
||||||
|
if (!cacheFlush()) return false;
|
||||||
|
|
||||||
|
// loop take less flash than memset(cacheBuffer_.data, 0, 512);
|
||||||
|
for (uint16_t i = 0; i < 512; i++) {
|
||||||
|
cacheBuffer_.data[i] = 0;
|
||||||
|
}
|
||||||
|
cacheBlockNumber_ = blockNumber;
|
||||||
|
cacheSetDirty();
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// return the size in bytes of a cluster chain
|
||||||
|
uint8_t SdVolume::chainSize(uint32_t cluster, uint32_t* size) const {
|
||||||
|
uint32_t s = 0;
|
||||||
|
do {
|
||||||
|
if (!fatGet(cluster, &cluster)) return false;
|
||||||
|
s += 512UL << clusterSizeShift_;
|
||||||
|
} while (!isEOC(cluster));
|
||||||
|
*size = s;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Fetch a FAT entry
|
||||||
|
uint8_t SdVolume::fatGet(uint32_t cluster, uint32_t* value) const {
|
||||||
|
if (cluster > (clusterCount_ + 1)) return false;
|
||||||
|
uint32_t lba = fatStartBlock_;
|
||||||
|
lba += fatType_ == 16 ? cluster >> 8 : cluster >> 7;
|
||||||
|
if (lba != cacheBlockNumber_) {
|
||||||
|
if (!cacheRawBlock(lba, CACHE_FOR_READ)) return false;
|
||||||
|
}
|
||||||
|
if (fatType_ == 16) {
|
||||||
|
*value = cacheBuffer_.fat16[cluster & 0XFF];
|
||||||
|
} else {
|
||||||
|
*value = cacheBuffer_.fat32[cluster & 0X7F] & FAT32MASK;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Store a FAT entry
|
||||||
|
uint8_t SdVolume::fatPut(uint32_t cluster, uint32_t value) {
|
||||||
|
// error if reserved cluster
|
||||||
|
if (cluster < 2) return false;
|
||||||
|
|
||||||
|
// error if not in FAT
|
||||||
|
if (cluster > (clusterCount_ + 1)) return false;
|
||||||
|
|
||||||
|
// calculate block address for entry
|
||||||
|
uint32_t lba = fatStartBlock_;
|
||||||
|
lba += fatType_ == 16 ? cluster >> 8 : cluster >> 7;
|
||||||
|
|
||||||
|
if (lba != cacheBlockNumber_) {
|
||||||
|
if (!cacheRawBlock(lba, CACHE_FOR_READ)) return false;
|
||||||
|
}
|
||||||
|
// store entry
|
||||||
|
if (fatType_ == 16) {
|
||||||
|
cacheBuffer_.fat16[cluster & 0XFF] = value;
|
||||||
|
} else {
|
||||||
|
cacheBuffer_.fat32[cluster & 0X7F] = value;
|
||||||
|
}
|
||||||
|
cacheSetDirty();
|
||||||
|
|
||||||
|
// mirror second FAT
|
||||||
|
if (fatCount_ > 1) cacheMirrorBlock_ = lba + blocksPerFat_;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// free a cluster chain
|
||||||
|
uint8_t SdVolume::freeChain(uint32_t cluster) {
|
||||||
|
// clear free cluster location
|
||||||
|
allocSearchStart_ = 2;
|
||||||
|
|
||||||
|
do {
|
||||||
|
uint32_t next;
|
||||||
|
if (!fatGet(cluster, &next)) return false;
|
||||||
|
|
||||||
|
// free cluster
|
||||||
|
if (!fatPut(cluster, 0)) return false;
|
||||||
|
|
||||||
|
cluster = next;
|
||||||
|
} while (!isEOC(cluster));
|
||||||
|
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
/**
|
||||||
|
* Initialize a FAT volume.
|
||||||
|
*
|
||||||
|
* \param[in] dev The SD card where the volume is located.
|
||||||
|
*
|
||||||
|
* \param[in] part The partition to be used. Legal values for \a part are
|
||||||
|
* 1-4 to use the corresponding partition on a device formatted with
|
||||||
|
* a MBR, Master Boot Record, or zero if the device is formatted as
|
||||||
|
* a super floppy with the FAT boot sector in block zero.
|
||||||
|
*
|
||||||
|
* \return The value one, true, is returned for success and
|
||||||
|
* the value zero, false, is returned for failure. Reasons for
|
||||||
|
* failure include not finding a valid partition, not finding a valid
|
||||||
|
* FAT file system in the specified partition or an I/O error.
|
||||||
|
*/
|
||||||
|
uint8_t SdVolume::init(Sd2Card* dev, uint8_t part) {
|
||||||
|
uint32_t volumeStartBlock = 0;
|
||||||
|
sdCard_ = dev;
|
||||||
|
// if part == 0 assume super floppy with FAT boot sector in block zero
|
||||||
|
// if part > 0 assume mbr volume with partition table
|
||||||
|
if (part) {
|
||||||
|
if (part > 4)return false;
|
||||||
|
if (!cacheRawBlock(volumeStartBlock, CACHE_FOR_READ)) return false;
|
||||||
|
part_t* p = &cacheBuffer_.mbr.part[part-1];
|
||||||
|
if ((p->boot & 0X7F) !=0 ||
|
||||||
|
p->totalSectors < 100 ||
|
||||||
|
p->firstSector == 0) {
|
||||||
|
// not a valid partition
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
volumeStartBlock = p->firstSector;
|
||||||
|
}
|
||||||
|
if (!cacheRawBlock(volumeStartBlock, CACHE_FOR_READ)) return false;
|
||||||
|
bpb_t* bpb = &cacheBuffer_.fbs.bpb;
|
||||||
|
if (bpb->bytesPerSector != 512 ||
|
||||||
|
bpb->fatCount == 0 ||
|
||||||
|
bpb->reservedSectorCount == 0 ||
|
||||||
|
bpb->sectorsPerCluster == 0) {
|
||||||
|
// not valid FAT volume
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
fatCount_ = bpb->fatCount;
|
||||||
|
blocksPerCluster_ = bpb->sectorsPerCluster;
|
||||||
|
|
||||||
|
// determine shift that is same as multiply by blocksPerCluster_
|
||||||
|
clusterSizeShift_ = 0;
|
||||||
|
while (blocksPerCluster_ != (1 << clusterSizeShift_)) {
|
||||||
|
// error if not power of 2
|
||||||
|
if (clusterSizeShift_++ > 7) return false;
|
||||||
|
}
|
||||||
|
blocksPerFat_ = bpb->sectorsPerFat16 ?
|
||||||
|
bpb->sectorsPerFat16 : bpb->sectorsPerFat32;
|
||||||
|
|
||||||
|
fatStartBlock_ = volumeStartBlock + bpb->reservedSectorCount;
|
||||||
|
|
||||||
|
// count for FAT16 zero for FAT32
|
||||||
|
rootDirEntryCount_ = bpb->rootDirEntryCount;
|
||||||
|
|
||||||
|
// directory start for FAT16 dataStart for FAT32
|
||||||
|
rootDirStart_ = fatStartBlock_ + bpb->fatCount * blocksPerFat_;
|
||||||
|
|
||||||
|
// data start for FAT16 and FAT32
|
||||||
|
dataStartBlock_ = rootDirStart_ + ((32 * bpb->rootDirEntryCount + 511)/512);
|
||||||
|
|
||||||
|
// total blocks for FAT16 or FAT32
|
||||||
|
uint32_t totalBlocks = bpb->totalSectors16 ?
|
||||||
|
bpb->totalSectors16 : bpb->totalSectors32;
|
||||||
|
// total data blocks
|
||||||
|
clusterCount_ = totalBlocks - (dataStartBlock_ - volumeStartBlock);
|
||||||
|
|
||||||
|
// divide by cluster size to get cluster count
|
||||||
|
clusterCount_ >>= clusterSizeShift_;
|
||||||
|
|
||||||
|
// FAT type is determined by cluster count
|
||||||
|
if (clusterCount_ < 4085) {
|
||||||
|
fatType_ = 12;
|
||||||
|
} else if (clusterCount_ < 65525) {
|
||||||
|
fatType_ = 16;
|
||||||
|
} else {
|
||||||
|
rootDirStart_ = bpb->fat32RootCluster;
|
||||||
|
fatType_ = 32;
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,494 @@
|
|||||||
|
#ifndef PINS_H
|
||||||
|
#define PINS_H
|
||||||
|
|
||||||
|
/****************************************************************************************
|
||||||
|
* Arduino pin assignment
|
||||||
|
*
|
||||||
|
* ATMega168
|
||||||
|
* +-\/-+
|
||||||
|
* PC6 1| |28 PC5 (AI 5 / D19)
|
||||||
|
* (D 0) PD0 2| |27 PC4 (AI 4 / D18)
|
||||||
|
* (D 1) PD1 3| |26 PC3 (AI 3 / D17)
|
||||||
|
* (D 2) PD2 4| |25 PC2 (AI 2 / D16)
|
||||||
|
* PWM+ (D 3) PD3 5| |24 PC1 (AI 1 / D15)
|
||||||
|
* (D 4) PD4 6| |23 PC0 (AI 0 / D14)
|
||||||
|
* VCC 7| |22 GND
|
||||||
|
* GND 8| |21 AREF
|
||||||
|
* PB6 9| |20 AVCC
|
||||||
|
* PB7 10| |19 PB5 (D 13)
|
||||||
|
* PWM+ (D 5) PD5 11| |18 PB4 (D 12)
|
||||||
|
* PWM+ (D 6) PD6 12| |17 PB3 (D 11) PWM
|
||||||
|
* (D 7) PD7 13| |16 PB2 (D 10) PWM
|
||||||
|
* (D 8) PB0 14| |15 PB1 (D 9) PWM
|
||||||
|
* +----+
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 0
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
|
||||||
|
#ifndef __AVR_ATmega168__
|
||||||
|
#error Oops! Make sure you have 'Arduino Diecimila' selected from the boards menu.
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define X_STEP_PIN 2
|
||||||
|
#define X_DIR_PIN 3
|
||||||
|
#define X_ENABLE_PIN -1
|
||||||
|
#define X_MIN_PIN 4
|
||||||
|
#define X_MAX_PIN 9
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 10
|
||||||
|
#define Y_DIR_PIN 7
|
||||||
|
#define Y_ENABLE_PIN -1
|
||||||
|
#define Y_MIN_PIN 8
|
||||||
|
#define Y_MAX_PIN 13
|
||||||
|
|
||||||
|
#define Z_STEP_PIN 19
|
||||||
|
#define Z_DIR_PIN 18
|
||||||
|
#define Z_ENABLE_PIN 5
|
||||||
|
#define Z_MIN_PIN 17
|
||||||
|
#define Z_MAX_PIN 16
|
||||||
|
|
||||||
|
#define E_STEP_PIN 11
|
||||||
|
#define E_DIR_PIN 12
|
||||||
|
#define E_ENABLE_PIN -1
|
||||||
|
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS -1
|
||||||
|
#define LED_PIN -1
|
||||||
|
#define FAN_PIN -1
|
||||||
|
#define PS_ON_PIN 15
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
#define HEATER_0_PIN 6
|
||||||
|
#define TEMP_0_PIN 0 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!!
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/****************************************************************************************
|
||||||
|
* Sanguino/RepRap Motherboard with direct-drive extruders
|
||||||
|
*
|
||||||
|
* ATMega644P
|
||||||
|
*
|
||||||
|
* +---\/---+
|
||||||
|
* (D 0) PB0 1| |40 PA0 (AI 0 / D31)
|
||||||
|
* (D 1) PB1 2| |39 PA1 (AI 1 / D30)
|
||||||
|
* INT2 (D 2) PB2 3| |38 PA2 (AI 2 / D29)
|
||||||
|
* PWM (D 3) PB3 4| |37 PA3 (AI 3 / D28)
|
||||||
|
* PWM (D 4) PB4 5| |36 PA4 (AI 4 / D27)
|
||||||
|
* MOSI (D 5) PB5 6| |35 PA5 (AI 5 / D26)
|
||||||
|
* MISO (D 6) PB6 7| |34 PA6 (AI 6 / D25)
|
||||||
|
* SCK (D 7) PB7 8| |33 PA7 (AI 7 / D24)
|
||||||
|
* RST 9| |32 AREF
|
||||||
|
* VCC 10| |31 GND
|
||||||
|
* GND 11| |30 AVCC
|
||||||
|
* XTAL2 12| |29 PC7 (D 23)
|
||||||
|
* XTAL1 13| |28 PC6 (D 22)
|
||||||
|
* RX0 (D 8) PD0 14| |27 PC5 (D 21) TDI
|
||||||
|
* TX0 (D 9) PD1 15| |26 PC4 (D 20) TDO
|
||||||
|
* INT0 RX1 (D 10) PD2 16| |25 PC3 (D 19) TMS
|
||||||
|
* INT1 TX1 (D 11) PD3 17| |24 PC2 (D 18) TCK
|
||||||
|
* PWM (D 12) PD4 18| |23 PC1 (D 17) SDA
|
||||||
|
* PWM (D 13) PD5 19| |22 PC0 (D 16) SCL
|
||||||
|
* PWM (D 14) PD6 20| |21 PD7 (D 15) PWM
|
||||||
|
* +--------+
|
||||||
|
*
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 1
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
|
||||||
|
#ifndef __AVR_ATmega644P__
|
||||||
|
#error Oops! Make sure you have 'Sanguino' selected from the 'Tools -> Boards' menu.
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define X_STEP_PIN 15
|
||||||
|
#define X_DIR_PIN 18
|
||||||
|
#define X_ENABLE_PIN 19
|
||||||
|
#define X_MIN_PIN 20
|
||||||
|
#define X_MAX_PIN 21
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 23
|
||||||
|
#define Y_DIR_PIN 22
|
||||||
|
#define Y_ENABLE_PIN 19
|
||||||
|
#define Y_MIN_PIN 25
|
||||||
|
#define Y_MAX_PIN 26
|
||||||
|
|
||||||
|
#define Z_STEP_PIN 29
|
||||||
|
#define Z_DIR_PIN 30
|
||||||
|
#define Z_ENABLE_PIN 31
|
||||||
|
#define Z_MIN_PIN 2
|
||||||
|
#define Z_MAX_PIN 1
|
||||||
|
|
||||||
|
#define E_STEP_PIN 12
|
||||||
|
#define E_DIR_PIN 16
|
||||||
|
#define E_ENABLE_PIN 3
|
||||||
|
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS -1
|
||||||
|
#define LED_PIN 0
|
||||||
|
#define FAN_PIN -1
|
||||||
|
#define PS_ON_PIN -1
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
#define HEATER_0_PIN 14
|
||||||
|
#define TEMP_0_PIN 4 //D27 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!!
|
||||||
|
|
||||||
|
/* Unused (1) (2) (3) 4 5 6 7 8 9 10 11 12 13 (14) (15) (16) 17 (18) (19) (20) (21) (22) (23) 24 (25) (26) (27) 28 (29) (30) (31) */
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
||||||
|
/****************************************************************************************
|
||||||
|
* RepRap Motherboard ****---NOOOOOO RS485/EXTRUDER CONTROLLER!!!!!!!!!!!!!!!!!---*******
|
||||||
|
*
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 2
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
|
||||||
|
#ifndef __AVR_ATmega644P__
|
||||||
|
#error Oops! Make sure you have 'Sanguino' selected from the 'Tools -> Boards' menu.
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define X_STEP_PIN 15
|
||||||
|
#define X_DIR_PIN 18
|
||||||
|
#define X_ENABLE_PIN 19
|
||||||
|
#define X_MIN_PIN 20
|
||||||
|
#define X_MAX_PIN 21
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 23
|
||||||
|
#define Y_DIR_PIN 22
|
||||||
|
#define Y_ENABLE_PIN 24
|
||||||
|
#define Y_MIN_PIN 25
|
||||||
|
#define Y_MAX_PIN 26
|
||||||
|
|
||||||
|
#define Z_STEP_PINN 27
|
||||||
|
#define Z_DIR_PINN 28
|
||||||
|
#define Z_ENABLE_PIN 29
|
||||||
|
#define Z_MIN_PIN 30
|
||||||
|
#define Z_MAX_PIN 31
|
||||||
|
|
||||||
|
#define E_STEP_PIN 17
|
||||||
|
#define E_DIR_PIN 16
|
||||||
|
#define E_ENABLE_PIN -1
|
||||||
|
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS 4
|
||||||
|
#define LED_PIN 0
|
||||||
|
|
||||||
|
#define SD_CARD_WRITE 2
|
||||||
|
#define SD_CARD_DETECT 3
|
||||||
|
#define SD_CARD_SELECT 4
|
||||||
|
|
||||||
|
//our RS485 pins
|
||||||
|
#define TX_ENABLE_PIN 12
|
||||||
|
#define RX_ENABLE_PIN 13
|
||||||
|
|
||||||
|
//pin for controlling the PSU.
|
||||||
|
#define PS_ON_PIN 14
|
||||||
|
|
||||||
|
#define FAN_PIN -1
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
#define HEATER_0_PIN -1
|
||||||
|
#define TEMP_0_PIN -1 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!!
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/****************************************************************************************
|
||||||
|
* Arduino Mega pin assignment
|
||||||
|
*
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 33
|
||||||
|
#define MOTHERBOARD 3
|
||||||
|
#define RAMPS_V_1_3
|
||||||
|
#endif
|
||||||
|
#if MOTHERBOARD == 3
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
|
||||||
|
//////////////////FIX THIS//////////////
|
||||||
|
#ifndef __AVR_ATmega1280__
|
||||||
|
#ifndef __AVR_ATmega2560__
|
||||||
|
#error Oops! Make sure you have 'Arduino Mega' selected from the 'Tools -> Boards' menu.
|
||||||
|
#endif
|
||||||
|
#endif
|
||||||
|
|
||||||
|
// uncomment one of the following lines for RAMPS v1.3 or v1.0, comment both for v1.2 or 1.1
|
||||||
|
// #define RAMPS_V_1_3
|
||||||
|
// #define RAMPS_V_1_0
|
||||||
|
|
||||||
|
#ifdef RAMPS_V_1_3
|
||||||
|
|
||||||
|
#define X_STEP_PIN 54
|
||||||
|
#define X_DIR_PIN 55
|
||||||
|
#define X_ENABLE_PIN 38
|
||||||
|
#define X_MIN_PIN 3
|
||||||
|
#define X_MAX_PIN -1 //2 //Max endstops default to disabled "-1", set to commented value to enable.
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 60
|
||||||
|
#define Y_DIR_PIN 61
|
||||||
|
#define Y_ENABLE_PIN 56
|
||||||
|
#define Y_MIN_PIN 14
|
||||||
|
#define Y_MAX_PIN -1 //15
|
||||||
|
|
||||||
|
#define Z_STEP_PIN 46
|
||||||
|
#define Z_DIR_PIN 48
|
||||||
|
#define Z_ENABLE_PIN 62
|
||||||
|
#define Z_MIN_PIN 18
|
||||||
|
#define Z_MAX_PIN -1 //19
|
||||||
|
|
||||||
|
#define E_STEP_PIN 26
|
||||||
|
#define E_DIR_PIN 28
|
||||||
|
#define E_ENABLE_PIN 24
|
||||||
|
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS 53
|
||||||
|
#define LED_PIN 13
|
||||||
|
#define FAN_PIN 9
|
||||||
|
#define PS_ON_PIN 12
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
#define HEATER_0_PIN 10
|
||||||
|
#define HEATER_1_PIN 8
|
||||||
|
#define TEMP_0_PIN 13 // ANALOG NUMBERING
|
||||||
|
#define TEMP_1_PIN 14 // ANALOG NUMBERING
|
||||||
|
|
||||||
|
|
||||||
|
#else // RAMPS_V_1_1 or RAMPS_V_1_2 as default
|
||||||
|
|
||||||
|
#define X_STEP_PIN 26
|
||||||
|
#define X_DIR_PIN 28
|
||||||
|
#define X_ENABLE_PIN 24
|
||||||
|
#define X_MIN_PIN 3
|
||||||
|
#define X_MAX_PIN -1 //2
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 38
|
||||||
|
#define Y_DIR_PIN 40
|
||||||
|
#define Y_ENABLE_PIN 36
|
||||||
|
#define Y_MIN_PIN 16
|
||||||
|
#define Y_MAX_PIN -1 //17
|
||||||
|
|
||||||
|
#define Z_STEP_PIN 44
|
||||||
|
#define Z_DIR_PIN 46
|
||||||
|
#define Z_ENABLE_PIN 42
|
||||||
|
#define Z_MIN_PIN 18
|
||||||
|
#define Z_MAX_PIN -1 //19
|
||||||
|
|
||||||
|
#define E_STEP_PIN 32
|
||||||
|
#define E_DIR_PIN 34
|
||||||
|
#define E_ENABLE_PIN 30
|
||||||
|
|
||||||
|
#define SDPOWER 48
|
||||||
|
#define SDSS 53
|
||||||
|
#define LED_PIN 13
|
||||||
|
#define PS_ON_PIN -1
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
#ifdef RAMPS_V_1_0 // RAMPS_V_1_0
|
||||||
|
#define HEATER_0_PIN 12 // RAMPS 1.0
|
||||||
|
#define HEATER_1_PIN -1 // RAMPS 1.0
|
||||||
|
#define FAN_PIN 11 // RAMPS 1.0
|
||||||
|
|
||||||
|
#else // RAMPS_V_1_1 or RAMPS_V_1_2
|
||||||
|
#define HEATER_0_PIN 10 // RAMPS 1.1
|
||||||
|
#define HEATER_1_PIN 8 // RAMPS 1.1
|
||||||
|
#define FAN_PIN 9 // RAMPS 1.1
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define TEMP_0_PIN 2 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!!
|
||||||
|
#define TEMP_1_PIN 1 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!!
|
||||||
|
#endif
|
||||||
|
|
||||||
|
// SPI for Max6675 Thermocouple
|
||||||
|
|
||||||
|
#ifndef SDSUPPORT
|
||||||
|
// these pins are defined in the SD library if building with SD support #define SCK_PIN 52
|
||||||
|
#define MISO_PIN 50
|
||||||
|
#define MOSI_PIN 51
|
||||||
|
#define MAX6675_SS 53
|
||||||
|
#else
|
||||||
|
#define MAX6675_SS 49
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
||||||
|
/****************************************************************************************
|
||||||
|
* Duemilanove w/ ATMega328P pin assignment
|
||||||
|
*
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 4
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
|
||||||
|
#ifndef __AVR_ATmega328P__
|
||||||
|
#error Oops! Make sure you have 'Arduino Duemilanove w/ ATMega328' selected from the 'Tools -> Boards' menu.
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define X_STEP_PIN 19
|
||||||
|
#define X_DIR_PIN 18
|
||||||
|
#define X_ENABLE_PIN -1
|
||||||
|
#define X_MIN_PIN 17
|
||||||
|
#define X_MAX_PIN -1
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 10
|
||||||
|
#define Y_DIR_PIN 7
|
||||||
|
#define Y_ENABLE_PIN -1
|
||||||
|
#define Y_MIN_PIN 8
|
||||||
|
#define Y_MAX_PIN -1
|
||||||
|
|
||||||
|
#define Z_STEP_PIN 13
|
||||||
|
#define Z_DIR_PIN 3
|
||||||
|
#define Z_ENABLE_PIN 2
|
||||||
|
#define Z_MIN_PIN 4
|
||||||
|
#define Z_MAX_PIN -1
|
||||||
|
|
||||||
|
#define E_STEP_PIN 11
|
||||||
|
#define E_DIR_PIN 12
|
||||||
|
#define E_ENABLE_PIN -1
|
||||||
|
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS -1
|
||||||
|
#define LED_PIN -1
|
||||||
|
#define FAN_PIN 5
|
||||||
|
#define PS_ON_PIN -1
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
#define HEATER_0_PIN 6
|
||||||
|
#define TEMP_0_PIN 0 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!!
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/****************************************************************************************
|
||||||
|
* Gen6 pin assignment
|
||||||
|
*
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 5
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
|
||||||
|
#ifndef __AVR_ATmega644P__
|
||||||
|
#error Oops! Make sure you have 'Sanguino' selected from the 'Tools -> Boards' menu.
|
||||||
|
#endif
|
||||||
|
|
||||||
|
//x axis pins
|
||||||
|
#define X_STEP_PIN 15
|
||||||
|
#define X_DIR_PIN 18
|
||||||
|
#define X_ENABLE_PIN 19
|
||||||
|
#define X_MIN_PIN 20
|
||||||
|
#define X_MAX_PIN -1
|
||||||
|
|
||||||
|
//y axis pins
|
||||||
|
#define Y_STEP_PIN 23
|
||||||
|
#define Y_DIR_PIN 22
|
||||||
|
#define Y_ENABLE_PIN 24
|
||||||
|
#define Y_MIN_PIN 25
|
||||||
|
#define Y_MAX_PIN -1
|
||||||
|
|
||||||
|
//z axis pins
|
||||||
|
#define Z_STEP_PIN 27
|
||||||
|
#define Z_DIR_PIN 28
|
||||||
|
#define Z_ENABLE_PIN 29
|
||||||
|
#define Z_MIN_PIN 30
|
||||||
|
#define Z_MAX_PIN -1
|
||||||
|
|
||||||
|
//extruder pins
|
||||||
|
#define E_STEP_PIN 4 //Edited @ EJE Electronics 20100715
|
||||||
|
#define E_DIR_PIN 2 //Edited @ EJE Electronics 20100715
|
||||||
|
#define E_ENABLE_PIN 3 //Added @ EJE Electronics 20100715
|
||||||
|
#define TEMP_0_PIN 5 //changed @ rkoeppl 20110410
|
||||||
|
#define HEATER_0_PIN 14 //changed @ rkoeppl 20110410
|
||||||
|
#define HEATER_1_PIN -1 //changed @ rkoeppl 20110410
|
||||||
|
|
||||||
|
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS 17
|
||||||
|
#define LED_PIN -1 //changed @ rkoeppl 20110410
|
||||||
|
#define TEMP_1_PIN -1 //changed @ rkoeppl 20110410
|
||||||
|
#define FAN_PIN -1 //changed @ rkoeppl 20110410
|
||||||
|
#define PS_ON_PIN -1 //changed @ rkoeppl 20110410
|
||||||
|
//our pin for debugging.
|
||||||
|
|
||||||
|
#define DEBUG_PIN 0
|
||||||
|
|
||||||
|
//our RS485 pins
|
||||||
|
#define TX_ENABLE_PIN 12
|
||||||
|
#define RX_ENABLE_PIN 13
|
||||||
|
|
||||||
|
#endif
|
||||||
|
/****************************************************************************************
|
||||||
|
* Sanguinololu pin assignment
|
||||||
|
*
|
||||||
|
****************************************************************************************/
|
||||||
|
#if MOTHERBOARD == 62
|
||||||
|
#define MOTHERBOARD 6
|
||||||
|
#define SANGUINOLOLU_V_1_2
|
||||||
|
#endif
|
||||||
|
#if MOTHERBOARD == 6
|
||||||
|
#define KNOWN_BOARD 1
|
||||||
|
#ifndef __AVR_ATmega644P__
|
||||||
|
#error Oops! Make sure you have 'Sanguino' selected from the 'Tools -> Boards' menu.
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define X_STEP_PIN 15
|
||||||
|
#define X_DIR_PIN 21
|
||||||
|
#define X_MIN_PIN 18
|
||||||
|
#define X_MAX_PIN -2
|
||||||
|
|
||||||
|
#define Y_STEP_PIN 22
|
||||||
|
#define Y_DIR_PIN 23
|
||||||
|
#define Y_MIN_PIN 19
|
||||||
|
#define Y_MAX_PIN -1
|
||||||
|
|
||||||
|
#define Z_STEP_PIN 3
|
||||||
|
#define Z_DIR_PIN 2
|
||||||
|
#define Z_MIN_PIN 20
|
||||||
|
#define Z_MAX_PIN -1
|
||||||
|
|
||||||
|
#define E_STEP_PIN 1
|
||||||
|
#define E_DIR_PIN 0
|
||||||
|
|
||||||
|
#define LED_PIN -1
|
||||||
|
|
||||||
|
#define FAN_PIN -1
|
||||||
|
|
||||||
|
#define PS_ON_PIN -1
|
||||||
|
#define KILL_PIN -1
|
||||||
|
|
||||||
|
#define HEATER_0_PIN 13 // (extruder)
|
||||||
|
|
||||||
|
#ifdef SANGUINOLOLU_V_1_2
|
||||||
|
|
||||||
|
#define HEATER_1_PIN 12 // (bed)
|
||||||
|
#define X_ENABLE_PIN 14
|
||||||
|
#define Y_ENABLE_PIN 14
|
||||||
|
#define Z_ENABLE_PIN 26
|
||||||
|
#define E_ENABLE_PIN 14
|
||||||
|
|
||||||
|
#else
|
||||||
|
|
||||||
|
#define HEATER_1_PIN 14 // (bed)
|
||||||
|
#define X_ENABLE_PIN -1
|
||||||
|
#define Y_ENABLE_PIN -1
|
||||||
|
#define Z_ENABLE_PIN -1
|
||||||
|
#define E_ENABLE_PIN -1
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define TEMP_0_PIN 7 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!! (pin 33 extruder)
|
||||||
|
#define TEMP_1_PIN 6 // MUST USE ANALOG INPUT NUMBERING NOT DIGITAL OUTPUT NUMBERING!!!!!!!!! (pin 34 bed)
|
||||||
|
#define SDPOWER -1
|
||||||
|
#define SDSS 31
|
||||||
|
|
||||||
|
#ifndef KNOWN_BOARD
|
||||||
|
#error Unknown MOTHERBOARD value in configuration.h
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif
|
@ -0,0 +1,75 @@
|
|||||||
|
#ifndef SPEED_LOOKUPTABLE_H
|
||||||
|
#define SPEED_LOOKUPTABLE_H
|
||||||
|
|
||||||
|
#include <avr/pgmspace.h>
|
||||||
|
|
||||||
|
uint16_t speed_lookuptable_fast[256][2] PROGMEM = {
|
||||||
|
{ 62500, 55556}, { 6944, 3268}, { 3676, 1176}, { 2500, 607}, { 1893, 369}, { 1524, 249}, { 1275, 179}, { 1096, 135},
|
||||||
|
{ 961, 105}, { 856, 85}, { 771, 69}, { 702, 58}, { 644, 49}, { 595, 42}, { 553, 37}, { 516, 32},
|
||||||
|
{ 484, 28}, { 456, 25}, { 431, 23}, { 408, 20}, { 388, 19}, { 369, 16}, { 353, 16}, { 337, 14},
|
||||||
|
{ 323, 13}, { 310, 11}, { 299, 11}, { 288, 11}, { 277, 9}, { 268, 9}, { 259, 8}, { 251, 8},
|
||||||
|
{ 243, 8}, { 235, 7}, { 228, 6}, { 222, 6}, { 216, 6}, { 210, 6}, { 204, 5}, { 199, 5},
|
||||||
|
{ 194, 5}, { 189, 4}, { 185, 4}, { 181, 4}, { 177, 4}, { 173, 4}, { 169, 4}, { 165, 3},
|
||||||
|
{ 162, 3}, { 159, 4}, { 155, 3}, { 152, 3}, { 149, 2}, { 147, 3}, { 144, 3}, { 141, 2},
|
||||||
|
{ 139, 3}, { 136, 2}, { 134, 2}, { 132, 3}, { 129, 2}, { 127, 2}, { 125, 2}, { 123, 2},
|
||||||
|
{ 121, 2}, { 119, 1}, { 118, 2}, { 116, 2}, { 114, 1}, { 113, 2}, { 111, 2}, { 109, 1},
|
||||||
|
{ 108, 2}, { 106, 1}, { 105, 2}, { 103, 1}, { 102, 1}, { 101, 1}, { 100, 2}, { 98, 1},
|
||||||
|
{ 97, 1}, { 96, 1}, { 95, 2}, { 93, 1}, { 92, 1}, { 91, 1}, { 90, 1}, { 89, 1},
|
||||||
|
{ 88, 1}, { 87, 1}, { 86, 1}, { 85, 1}, { 84, 1}, { 83, 0}, { 83, 1}, { 82, 1},
|
||||||
|
{ 81, 1}, { 80, 1}, { 79, 1}, { 78, 0}, { 78, 1}, { 77, 1}, { 76, 1}, { 75, 0},
|
||||||
|
{ 75, 1}, { 74, 1}, { 73, 1}, { 72, 0}, { 72, 1}, { 71, 1}, { 70, 0}, { 70, 1},
|
||||||
|
{ 69, 0}, { 69, 1}, { 68, 1}, { 67, 0}, { 67, 1}, { 66, 0}, { 66, 1}, { 65, 0},
|
||||||
|
{ 65, 1}, { 64, 1}, { 63, 0}, { 63, 1}, { 62, 0}, { 62, 1}, { 61, 0}, { 61, 1},
|
||||||
|
{ 60, 0}, { 60, 0}, { 60, 1}, { 59, 0}, { 59, 1}, { 58, 0}, { 58, 1}, { 57, 0},
|
||||||
|
{ 57, 1}, { 56, 0}, { 56, 0}, { 56, 1}, { 55, 0}, { 55, 1}, { 54, 0}, { 54, 0},
|
||||||
|
{ 54, 1}, { 53, 0}, { 53, 0}, { 53, 1}, { 52, 0}, { 52, 0}, { 52, 1}, { 51, 0},
|
||||||
|
{ 51, 0}, { 51, 1}, { 50, 0}, { 50, 0}, { 50, 1}, { 49, 0}, { 49, 0}, { 49, 1},
|
||||||
|
{ 48, 0}, { 48, 0}, { 48, 1}, { 47, 0}, { 47, 0}, { 47, 0}, { 47, 1}, { 46, 0},
|
||||||
|
{ 46, 0}, { 46, 1}, { 45, 0}, { 45, 0}, { 45, 0}, { 45, 1}, { 44, 0}, { 44, 0},
|
||||||
|
{ 44, 0}, { 44, 1}, { 43, 0}, { 43, 0}, { 43, 0}, { 43, 1}, { 42, 0}, { 42, 0},
|
||||||
|
{ 42, 0}, { 42, 1}, { 41, 0}, { 41, 0}, { 41, 0}, { 41, 0}, { 41, 1}, { 40, 0},
|
||||||
|
{ 40, 0}, { 40, 0}, { 40, 0}, { 40, 1}, { 39, 0}, { 39, 0}, { 39, 0}, { 39, 0},
|
||||||
|
{ 39, 1}, { 38, 0}, { 38, 0}, { 38, 0}, { 38, 0}, { 38, 1}, { 37, 0}, { 37, 0},
|
||||||
|
{ 37, 0}, { 37, 0}, { 37, 0}, { 37, 1}, { 36, 0}, { 36, 0}, { 36, 0}, { 36, 0},
|
||||||
|
{ 36, 1}, { 35, 0}, { 35, 0}, { 35, 0}, { 35, 0}, { 35, 0}, { 35, 0}, { 35, 1},
|
||||||
|
{ 34, 0}, { 34, 0}, { 34, 0}, { 34, 0}, { 34, 0}, { 34, 1}, { 33, 0}, { 33, 0},
|
||||||
|
{ 33, 0}, { 33, 0}, { 33, 0}, { 33, 0}, { 33, 1}, { 32, 0}, { 32, 0}, { 32, 0},
|
||||||
|
{ 32, 0}, { 32, 0}, { 32, 0}, { 32, 0}, { 32, 1}, { 31, 0}, { 31, 0}, { 31, 0},
|
||||||
|
{ 31, 0}, { 31, 0}, { 31, 0}, { 31, 1}, { 30, 0}, { 30, 0}, { 30, 0}, { 30, 0},
|
||||||
|
};
|
||||||
|
uint16_t speed_lookuptable_slow[256][2] PROGMEM = {
|
||||||
|
{ 62500, 12500}, { 50000, 8334}, { 41666, 5952}, { 35714, 4464}, { 31250, 3473}, { 27777, 2777}, { 25000, 2273}, { 22727, 1894},
|
||||||
|
{ 20833, 1603}, { 19230, 1373}, { 17857, 1191}, { 16666, 1041}, { 15625, 920}, { 14705, 817}, { 13888, 731}, { 13157, 657},
|
||||||
|
{ 12500, 596}, { 11904, 541}, { 11363, 494}, { 10869, 453}, { 10416, 416}, { 10000, 385}, { 9615, 356}, { 9259, 331},
|
||||||
|
{ 8928, 308}, { 8620, 287}, { 8333, 269}, { 8064, 252}, { 7812, 237}, { 7575, 223}, { 7352, 210}, { 7142, 198},
|
||||||
|
{ 6944, 188}, { 6756, 178}, { 6578, 168}, { 6410, 160}, { 6250, 153}, { 6097, 145}, { 5952, 139}, { 5813, 132},
|
||||||
|
{ 5681, 126}, { 5555, 121}, { 5434, 115}, { 5319, 111}, { 5208, 106}, { 5102, 102}, { 5000, 99}, { 4901, 94},
|
||||||
|
{ 4807, 91}, { 4716, 87}, { 4629, 84}, { 4545, 81}, { 4464, 79}, { 4385, 75}, { 4310, 73}, { 4237, 71},
|
||||||
|
{ 4166, 68}, { 4098, 66}, { 4032, 64}, { 3968, 62}, { 3906, 60}, { 3846, 59}, { 3787, 56}, { 3731, 55},
|
||||||
|
{ 3676, 53}, { 3623, 52}, { 3571, 50}, { 3521, 49}, { 3472, 48}, { 3424, 46}, { 3378, 45}, { 3333, 44},
|
||||||
|
{ 3289, 43}, { 3246, 41}, { 3205, 41}, { 3164, 39}, { 3125, 39}, { 3086, 38}, { 3048, 36}, { 3012, 36},
|
||||||
|
{ 2976, 35}, { 2941, 35}, { 2906, 33}, { 2873, 33}, { 2840, 32}, { 2808, 31}, { 2777, 30}, { 2747, 30},
|
||||||
|
{ 2717, 29}, { 2688, 29}, { 2659, 28}, { 2631, 27}, { 2604, 27}, { 2577, 26}, { 2551, 26}, { 2525, 25},
|
||||||
|
{ 2500, 25}, { 2475, 25}, { 2450, 23}, { 2427, 24}, { 2403, 23}, { 2380, 22}, { 2358, 22}, { 2336, 22},
|
||||||
|
{ 2314, 21}, { 2293, 21}, { 2272, 20}, { 2252, 20}, { 2232, 20}, { 2212, 20}, { 2192, 19}, { 2173, 18},
|
||||||
|
{ 2155, 19}, { 2136, 18}, { 2118, 18}, { 2100, 17}, { 2083, 17}, { 2066, 17}, { 2049, 17}, { 2032, 16},
|
||||||
|
{ 2016, 16}, { 2000, 16}, { 1984, 16}, { 1968, 15}, { 1953, 16}, { 1937, 14}, { 1923, 15}, { 1908, 15},
|
||||||
|
{ 1893, 14}, { 1879, 14}, { 1865, 14}, { 1851, 13}, { 1838, 14}, { 1824, 13}, { 1811, 13}, { 1798, 13},
|
||||||
|
{ 1785, 12}, { 1773, 13}, { 1760, 12}, { 1748, 12}, { 1736, 12}, { 1724, 12}, { 1712, 12}, { 1700, 11},
|
||||||
|
{ 1689, 12}, { 1677, 11}, { 1666, 11}, { 1655, 11}, { 1644, 11}, { 1633, 10}, { 1623, 11}, { 1612, 10},
|
||||||
|
{ 1602, 10}, { 1592, 10}, { 1582, 10}, { 1572, 10}, { 1562, 10}, { 1552, 9}, { 1543, 10}, { 1533, 9},
|
||||||
|
{ 1524, 9}, { 1515, 9}, { 1506, 9}, { 1497, 9}, { 1488, 9}, { 1479, 9}, { 1470, 9}, { 1461, 8},
|
||||||
|
{ 1453, 8}, { 1445, 9}, { 1436, 8}, { 1428, 8}, { 1420, 8}, { 1412, 8}, { 1404, 8}, { 1396, 8},
|
||||||
|
{ 1388, 7}, { 1381, 8}, { 1373, 7}, { 1366, 8}, { 1358, 7}, { 1351, 7}, { 1344, 8}, { 1336, 7},
|
||||||
|
{ 1329, 7}, { 1322, 7}, { 1315, 7}, { 1308, 6}, { 1302, 7}, { 1295, 7}, { 1288, 6}, { 1282, 7},
|
||||||
|
{ 1275, 6}, { 1269, 7}, { 1262, 6}, { 1256, 6}, { 1250, 7}, { 1243, 6}, { 1237, 6}, { 1231, 6},
|
||||||
|
{ 1225, 6}, { 1219, 6}, { 1213, 6}, { 1207, 6}, { 1201, 5}, { 1196, 6}, { 1190, 6}, { 1184, 5},
|
||||||
|
{ 1179, 6}, { 1173, 5}, { 1168, 6}, { 1162, 5}, { 1157, 5}, { 1152, 6}, { 1146, 5}, { 1141, 5},
|
||||||
|
{ 1136, 5}, { 1131, 5}, { 1126, 5}, { 1121, 5}, { 1116, 5}, { 1111, 5}, { 1106, 5}, { 1101, 5},
|
||||||
|
{ 1096, 5}, { 1091, 5}, { 1086, 4}, { 1082, 5}, { 1077, 5}, { 1072, 4}, { 1068, 5}, { 1063, 4},
|
||||||
|
{ 1059, 5}, { 1054, 4}, { 1050, 4}, { 1046, 5}, { 1041, 4}, { 1037, 4}, { 1033, 5}, { 1028, 4},
|
||||||
|
{ 1024, 4}, { 1020, 4}, { 1016, 4}, { 1012, 4}, { 1008, 4}, { 1004, 4}, { 1000, 4}, { 996, 4},
|
||||||
|
{ 992, 4}, { 988, 4}, { 984, 4}, { 980, 4}, { 976, 4}, { 972, 4}, { 968, 3}, { 965, 3},
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
@ -0,0 +1,148 @@
|
|||||||
|
#ifndef THERMISTORTABLES_H_
|
||||||
|
#define THERMISTORTABLES_H_
|
||||||
|
|
||||||
|
#if (THERMISTORHEATER == 1) || (THERMISTORBED == 1) //100k bed thermistor
|
||||||
|
|
||||||
|
|
||||||
|
#define NUMTEMPS_1 61
|
||||||
|
const short temptable_1[NUMTEMPS_1][2] = {
|
||||||
|
{ (23*16) , 300 },
|
||||||
|
{ (25*16) , 295 },
|
||||||
|
{ (27*16) , 290 },
|
||||||
|
{ (28*16) , 285 },
|
||||||
|
{ (31*16) , 280 },
|
||||||
|
{ (33*16) , 275 },
|
||||||
|
{ (35*16) , 270 },
|
||||||
|
{ (38*16) , 265 },
|
||||||
|
{ (41*16) , 260 },
|
||||||
|
{ (44*16) , 255 },
|
||||||
|
{ (48*16) , 250 },
|
||||||
|
{ (52*16) , 245 },
|
||||||
|
{ (56*16) , 240 },
|
||||||
|
{ (61*16) , 235 },
|
||||||
|
{ (66*16) , 230 },
|
||||||
|
{ (71*16) , 225 },
|
||||||
|
{ (78*16) , 220 },
|
||||||
|
{ (84*16) , 215 },
|
||||||
|
{ (92*16) , 210 },
|
||||||
|
{ (100*16), 205 },
|
||||||
|
{ (109*16), 200 },
|
||||||
|
{ (120*16), 195 },
|
||||||
|
{ (131*16), 190 },
|
||||||
|
{ (143*16), 185 },
|
||||||
|
{ (156*16), 180 },
|
||||||
|
{ (171*16), 175 },
|
||||||
|
{ (187*16), 170 },
|
||||||
|
{ (205*16), 165 },
|
||||||
|
{ (224*16), 160 },
|
||||||
|
{ (245*16), 155 },
|
||||||
|
{ (268*16), 150 },
|
||||||
|
{ (293*16), 145 },
|
||||||
|
{ (320*16), 140 },
|
||||||
|
{ (348*16), 135 },
|
||||||
|
{ (379*16), 130 },
|
||||||
|
{ (411*16), 125 },
|
||||||
|
{ (445*16), 120 },
|
||||||
|
{ (480*16), 115 },
|
||||||
|
{ (516*16), 110 },
|
||||||
|
{ (553*16), 105 },
|
||||||
|
{ (591*16), 100 },
|
||||||
|
{ (628*16), 95 },
|
||||||
|
{ (665*16), 90 },
|
||||||
|
{ (702*16), 85 },
|
||||||
|
{ (737*16), 80 },
|
||||||
|
{ (770*16), 75 },
|
||||||
|
{ (801*16), 70 },
|
||||||
|
{ (830*16), 65 },
|
||||||
|
{ (857*16), 60 },
|
||||||
|
{ (881*16), 55 },
|
||||||
|
{ (903*16), 50 },
|
||||||
|
{ (922*16), 45 },
|
||||||
|
{ (939*16), 40 },
|
||||||
|
{ (954*16), 35 },
|
||||||
|
{ (966*16), 30 },
|
||||||
|
{ (977*16), 25 },
|
||||||
|
{ (985*16), 20 },
|
||||||
|
{ (993*16), 15 },
|
||||||
|
{ (999*16), 10 },
|
||||||
|
{ (1004*16), 5 },
|
||||||
|
{ (1008*16), 0 } //safety
|
||||||
|
};
|
||||||
|
#endif
|
||||||
|
#if (THERMISTORHEATER == 2) || (THERMISTORBED == 2) //200k bed thermistor
|
||||||
|
#define NUMTEMPS_2 21
|
||||||
|
const short temptable_2[NUMTEMPS_2][2] = {
|
||||||
|
{(1*16), 848},
|
||||||
|
{(54*16), 275},
|
||||||
|
{(107*16), 228},
|
||||||
|
{(160*16), 202},
|
||||||
|
{(213*16), 185},
|
||||||
|
{(266*16), 171},
|
||||||
|
{(319*16), 160},
|
||||||
|
{(372*16), 150},
|
||||||
|
{(425*16), 141},
|
||||||
|
{(478*16), 133},
|
||||||
|
{(531*16), 125},
|
||||||
|
{(584*16), 118},
|
||||||
|
{(637*16), 110},
|
||||||
|
{(690*16), 103},
|
||||||
|
{(743*16), 95},
|
||||||
|
{(796*16), 86},
|
||||||
|
{(849*16), 77},
|
||||||
|
{(902*16), 65},
|
||||||
|
{(955*16), 49},
|
||||||
|
{(1008*16), 17},
|
||||||
|
{(1020*16), 0} //safety
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
#if (THERMISTORHEATER == 3) || (THERMISTORBED == 3) //mendel-parts
|
||||||
|
#define NUMTEMPS_3 28
|
||||||
|
const short temptable_3[NUMTEMPS_3][2] = {
|
||||||
|
{(1*16),864},
|
||||||
|
{(21*16),300},
|
||||||
|
{(25*16),290},
|
||||||
|
{(29*16),280},
|
||||||
|
{(33*16),270},
|
||||||
|
{(39*16),260},
|
||||||
|
{(46*16),250},
|
||||||
|
{(54*16),240},
|
||||||
|
{(64*16),230},
|
||||||
|
{(75*16),220},
|
||||||
|
{(90*16),210},
|
||||||
|
{(107*16),200},
|
||||||
|
{(128*16),190},
|
||||||
|
{(154*16),180},
|
||||||
|
{(184*16),170},
|
||||||
|
{(221*16),160},
|
||||||
|
{(265*16),150},
|
||||||
|
{(316*16),140},
|
||||||
|
{(375*16),130},
|
||||||
|
{(441*16),120},
|
||||||
|
{(513*16),110},
|
||||||
|
{(588*16),100},
|
||||||
|
{(734*16),80},
|
||||||
|
{(856*16),60},
|
||||||
|
{(938*16),40},
|
||||||
|
{(986*16),20},
|
||||||
|
{(1008*16),0},
|
||||||
|
{(1018*16),-20}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if THERMISTORHEATER == 1
|
||||||
|
#define NUMTEMPS NUMTEMPS_1
|
||||||
|
#define temptable temptable_1
|
||||||
|
#elif THERMISTORHEATER == 2
|
||||||
|
#define NUMTEMPS NUMTEMPS_2
|
||||||
|
#define temptable temptable_2
|
||||||
|
#elif THERMISTORHEATER == 3
|
||||||
|
#define NUMTEMPS NUMTEMPS_3
|
||||||
|
#define temptable temptable_3
|
||||||
|
#else
|
||||||
|
#error No heater thermistor table specified
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
||||||
|
#endif //THERMISTORTABLES_H_
|
@ -0,0 +1,176 @@
|
|||||||
|
/*
|
||||||
|
wiring.c - Partial implementation of the Wiring API for the ATmega8.
|
||||||
|
Part of Arduino - http://www.arduino.cc/
|
||||||
|
|
||||||
|
Copyright (c) 2005-2006 David A. Mellis
|
||||||
|
|
||||||
|
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 2.1 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 library; if not, write to the
|
||||||
|
Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
||||||
|
Boston, MA 02111-1307 USA
|
||||||
|
|
||||||
|
$Id: wiring.c 388 2008-03-08 22:05:23Z mellis $
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include "wiring_private.h"
|
||||||
|
|
||||||
|
volatile unsigned long timer0_millis = 0;
|
||||||
|
|
||||||
|
SIGNAL(TIMER0_OVF_vect)
|
||||||
|
{
|
||||||
|
// timer 0 prescale factor is 64 and the timer overflows at 256
|
||||||
|
timer0_millis++;
|
||||||
|
}
|
||||||
|
|
||||||
|
unsigned long millis()
|
||||||
|
{
|
||||||
|
unsigned long m;
|
||||||
|
uint8_t oldSREG = SREG;
|
||||||
|
|
||||||
|
// disable interrupts while we read timer0_millis or we might get an
|
||||||
|
// inconsistent value (e.g. in the middle of the timer0_millis++)
|
||||||
|
cli();
|
||||||
|
m = timer0_millis;
|
||||||
|
SREG = oldSREG;
|
||||||
|
|
||||||
|
return m;
|
||||||
|
}
|
||||||
|
|
||||||
|
void delay(unsigned long ms)
|
||||||
|
{
|
||||||
|
unsigned long start = millis();
|
||||||
|
|
||||||
|
while (millis() - start <= ms)
|
||||||
|
;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Delay for the given number of microseconds. Assumes a 8 or 16 MHz clock.
|
||||||
|
* Disables interrupts, which will disrupt the millis() function if used
|
||||||
|
* too frequently. */
|
||||||
|
void delayMicroseconds(unsigned int us)
|
||||||
|
{
|
||||||
|
uint8_t oldSREG;
|
||||||
|
|
||||||
|
// calling avrlib's delay_us() function with low values (e.g. 1 or
|
||||||
|
// 2 microseconds) gives delays longer than desired.
|
||||||
|
//delay_us(us);
|
||||||
|
|
||||||
|
#if F_CPU >= 16000000L
|
||||||
|
// for the 16 MHz clock on most Arduino boards
|
||||||
|
|
||||||
|
// for a one-microsecond delay, simply return. the overhead
|
||||||
|
// of the function call yields a delay of approximately 1 1/8 us.
|
||||||
|
if (--us == 0)
|
||||||
|
return;
|
||||||
|
|
||||||
|
// the following loop takes a quarter of a microsecond (4 cycles)
|
||||||
|
// per iteration, so execute it four times for each microsecond of
|
||||||
|
// delay requested.
|
||||||
|
us <<= 2;
|
||||||
|
|
||||||
|
// account for the time taken in the preceeding commands.
|
||||||
|
us -= 2;
|
||||||
|
#else
|
||||||
|
// for the 8 MHz internal clock on the ATmega168
|
||||||
|
|
||||||
|
// for a one- or two-microsecond delay, simply return. the overhead of
|
||||||
|
// the function calls takes more than two microseconds. can't just
|
||||||
|
// subtract two, since us is unsigned; we'd overflow.
|
||||||
|
if (--us == 0)
|
||||||
|
return;
|
||||||
|
if (--us == 0)
|
||||||
|
return;
|
||||||
|
|
||||||
|
// the following loop takes half of a microsecond (4 cycles)
|
||||||
|
// per iteration, so execute it twice for each microsecond of
|
||||||
|
// delay requested.
|
||||||
|
us <<= 1;
|
||||||
|
|
||||||
|
// partially compensate for the time taken by the preceeding commands.
|
||||||
|
// we can't subtract any more than this or we'd overflow w/ small delays.
|
||||||
|
us--;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
// disable interrupts, otherwise the timer 0 overflow interrupt that
|
||||||
|
// tracks milliseconds will make us delay longer than we want.
|
||||||
|
oldSREG = SREG;
|
||||||
|
cli();
|
||||||
|
|
||||||
|
// busy wait
|
||||||
|
__asm__ __volatile__ (
|
||||||
|
"1: sbiw %0,1" "\n\t" // 2 cycles
|
||||||
|
"brne 1b" : "=w" (us) : "0" (us) // 2 cycles
|
||||||
|
);
|
||||||
|
|
||||||
|
// reenable interrupts.
|
||||||
|
SREG = oldSREG;
|
||||||
|
}
|
||||||
|
|
||||||
|
void init()
|
||||||
|
{
|
||||||
|
// this needs to be called before setup() or some functions won't
|
||||||
|
// work there
|
||||||
|
sei();
|
||||||
|
|
||||||
|
// on the ATmega168, timer 0 is also used for fast hardware pwm
|
||||||
|
// (using phase-correct PWM would mean that timer 0 overflowed half as often
|
||||||
|
// resulting in different millis() behavior on the ATmega8 and ATmega168)
|
||||||
|
sbi(TCCR0A, WGM01);
|
||||||
|
sbi(TCCR0A, WGM00);
|
||||||
|
|
||||||
|
// set timer 0 prescale factor to 64
|
||||||
|
sbi(TCCR0B, CS01);
|
||||||
|
sbi(TCCR0B, CS00);
|
||||||
|
|
||||||
|
// enable timer 0 overflow interrupt
|
||||||
|
sbi(TIMSK0, TOIE0);
|
||||||
|
|
||||||
|
// timers 1 and 2 are used for phase-correct hardware pwm
|
||||||
|
// this is better for motors as it ensures an even waveform
|
||||||
|
// note, however, that fast pwm mode can achieve a frequency of up
|
||||||
|
// 8 MHz (with a 16 MHz clock) at 50% duty cycle
|
||||||
|
#if 0
|
||||||
|
// set timer 1 prescale factor to 64
|
||||||
|
sbi(TCCR1B, CS11);
|
||||||
|
sbi(TCCR1B, CS10);
|
||||||
|
|
||||||
|
// put timer 1 in 8-bit phase correct pwm mode
|
||||||
|
sbi(TCCR1A, WGM10);
|
||||||
|
|
||||||
|
// set timer 2 prescale factor to 64
|
||||||
|
sbi(TCCR2B, CS22);
|
||||||
|
|
||||||
|
// configure timer 2 for phase correct pwm (8-bit)
|
||||||
|
sbi(TCCR2A, WGM20);
|
||||||
|
|
||||||
|
// set a2d prescale factor to 128
|
||||||
|
// 16 MHz / 128 = 125 KHz, inside the desired 50-200 KHz range.
|
||||||
|
// XXX: this will not work properly for other clock speeds, and
|
||||||
|
// this code should use F_CPU to determine the prescale factor.
|
||||||
|
sbi(ADCSRA, ADPS2);
|
||||||
|
sbi(ADCSRA, ADPS1);
|
||||||
|
sbi(ADCSRA, ADPS0);
|
||||||
|
|
||||||
|
// enable a2d conversions
|
||||||
|
sbi(ADCSRA, ADEN);
|
||||||
|
|
||||||
|
// the bootloader connects pins 0 and 1 to the USART; disconnect them
|
||||||
|
// here so they can be used as normal digital i/o; they will be
|
||||||
|
// reconnected in Serial.begin()
|
||||||
|
UCSR0B = 0;
|
||||||
|
#if defined(__AVR_ATmega644P__)
|
||||||
|
//TODO: test to see if disabling this helps?
|
||||||
|
//UCSR1B = 0;
|
||||||
|
#endif
|
||||||
|
#endif
|
||||||
|
}
|
@ -0,0 +1,139 @@
|
|||||||
|
/*
|
||||||
|
wiring_serial.c - serial functions.
|
||||||
|
Part of Arduino - http://www.arduino.cc/
|
||||||
|
|
||||||
|
Copyright (c) 2005-2006 David A. Mellis
|
||||||
|
Modified 29 January 2009, Marius Kintel for Sanguino - http://www.sanguino.cc/
|
||||||
|
|
||||||
|
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 2.1 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 library; if not, write to the
|
||||||
|
Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
||||||
|
Boston, MA 02111-1307 USA
|
||||||
|
|
||||||
|
$Id: wiring.c 248 2007-02-03 15:36:30Z mellis $
|
||||||
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
#include "wiring_private.h"
|
||||||
|
|
||||||
|
// Define constants and variables for buffering incoming serial data. We're
|
||||||
|
// using a ring buffer (I think), in which rx_buffer_head is the index of the
|
||||||
|
// location to which to write the next incoming character and rx_buffer_tail
|
||||||
|
// is the index of the location from which to read.
|
||||||
|
#define RX_BUFFER_SIZE 128
|
||||||
|
#define RX_BUFFER_MASK 0x7f
|
||||||
|
|
||||||
|
#if defined(__AVR_ATmega644P__)
|
||||||
|
unsigned char rx_buffer[2][RX_BUFFER_SIZE];
|
||||||
|
int rx_buffer_head[2] = {0, 0};
|
||||||
|
int rx_buffer_tail[2] = {0, 0};
|
||||||
|
#else
|
||||||
|
unsigned char rx_buffer[1][RX_BUFFER_SIZE];
|
||||||
|
int rx_buffer_head[1] = {0};
|
||||||
|
int rx_buffer_tail[1] = {0};
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
||||||
|
#define BEGIN_SERIAL(uart_, baud_) \
|
||||||
|
{ \
|
||||||
|
UBRR##uart_##H = ((F_CPU / 16 + baud / 2) / baud - 1) >> 8; \
|
||||||
|
UBRR##uart_##L = ((F_CPU / 16 + baud / 2) / baud - 1); \
|
||||||
|
\
|
||||||
|
/* reset config for UART */ \
|
||||||
|
UCSR##uart_##A = 0; \
|
||||||
|
UCSR##uart_##B = 0; \
|
||||||
|
UCSR##uart_##C = 0; \
|
||||||
|
\
|
||||||
|
/* enable rx and tx */ \
|
||||||
|
sbi(UCSR##uart_##B, RXEN##uart_);\
|
||||||
|
sbi(UCSR##uart_##B, TXEN##uart_);\
|
||||||
|
\
|
||||||
|
/* enable interrupt on complete reception of a byte */ \
|
||||||
|
sbi(UCSR##uart_##B, RXCIE##uart_); \
|
||||||
|
UCSR##uart_##C = _BV(UCSZ##uart_##1)|_BV(UCSZ##uart_##0); \
|
||||||
|
/* defaults to 8-bit, no parity, 1 stop bit */ \
|
||||||
|
}
|
||||||
|
|
||||||
|
void beginSerial(uint8_t uart, long baud)
|
||||||
|
{
|
||||||
|
if (uart == 0) BEGIN_SERIAL(0, baud)
|
||||||
|
#if defined(__AVR_ATmega644P__)
|
||||||
|
else BEGIN_SERIAL(1, baud)
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
|
||||||
|
#define SERIAL_WRITE(uart_, c_) \
|
||||||
|
while (!(UCSR##uart_##A & (1 << UDRE##uart_))) \
|
||||||
|
; \
|
||||||
|
UDR##uart_ = c
|
||||||
|
|
||||||
|
void serialWrite(uint8_t uart, unsigned char c)
|
||||||
|
{
|
||||||
|
if (uart == 0) {
|
||||||
|
SERIAL_WRITE(0, c);
|
||||||
|
}
|
||||||
|
#if defined(__AVR_ATmega644P__)
|
||||||
|
else {
|
||||||
|
SERIAL_WRITE(1, c);
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
|
||||||
|
int serialAvailable(uint8_t uart)
|
||||||
|
{
|
||||||
|
return (RX_BUFFER_SIZE + rx_buffer_head[uart] - rx_buffer_tail[uart]) & RX_BUFFER_MASK;
|
||||||
|
}
|
||||||
|
|
||||||
|
int serialRead(uint8_t uart)
|
||||||
|
{
|
||||||
|
// if the head isn't ahead of the tail, we don't have any characters
|
||||||
|
if (rx_buffer_head[uart] == rx_buffer_tail[uart]) {
|
||||||
|
return -1;
|
||||||
|
} else {
|
||||||
|
unsigned char c = rx_buffer[uart][rx_buffer_tail[uart]];
|
||||||
|
rx_buffer_tail[uart] = (rx_buffer_tail[uart] + 1) & RX_BUFFER_MASK;
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void serialFlush(uint8_t uart)
|
||||||
|
{
|
||||||
|
// don't reverse this or there may be problems if the RX interrupt
|
||||||
|
// occurs after reading the value of rx_buffer_head but before writing
|
||||||
|
// the value to rx_buffer_tail; the previous value of rx_buffer_head
|
||||||
|
// may be written to rx_buffer_tail, making it appear as if the buffer
|
||||||
|
// were full, not empty.
|
||||||
|
rx_buffer_head[uart] = rx_buffer_tail[uart];
|
||||||
|
}
|
||||||
|
|
||||||
|
#define UART_ISR(uart_) \
|
||||||
|
ISR(USART##uart_##_RX_vect) \
|
||||||
|
{ \
|
||||||
|
unsigned char c = UDR##uart_; \
|
||||||
|
\
|
||||||
|
int i = (rx_buffer_head[uart_] + 1) & RX_BUFFER_MASK; \
|
||||||
|
\
|
||||||
|
/* if we should be storing the received character into the location \
|
||||||
|
just before the tail (meaning that the head would advance to the \
|
||||||
|
current location of the tail), we're about to overflow the buffer \
|
||||||
|
and so we don't write the character or advance the head. */ \
|
||||||
|
if (i != rx_buffer_tail[uart_]) { \
|
||||||
|
rx_buffer[uart_][rx_buffer_head[uart_]] = c; \
|
||||||
|
rx_buffer_head[uart_] = i; \
|
||||||
|
} \
|
||||||
|
}
|
||||||
|
|
||||||
|
UART_ISR(0)
|
||||||
|
#if defined(__AVR_ATmega644P__)
|
||||||
|
UART_ISR(1)
|
||||||
|
#endif
|
Loading…
Reference in new issue