From 775bcbaff39958a12c69d93f54fa899dbd9694bd Mon Sep 17 00:00:00 2001 From: Chris Spangler <chris.spangler@fau.de> Date: Fri, 10 Aug 2018 13:19:59 +0200 Subject: [PATCH] FIRMWARE DONE Former-commit-id: d70f3511cb04814eb9e3756a22463b4478b79794 --- ToyRep/firmware/LICENSE | 674 +++++++++++++++++++++++++++++++++++++ ToyRep/firmware/hello.c | 86 +---- ToyRep/firmware/system.pdf | Bin 0 -> 20237 bytes 3 files changed, 689 insertions(+), 71 deletions(-) create mode 100644 ToyRep/firmware/LICENSE create mode 100644 ToyRep/firmware/system.pdf diff --git a/ToyRep/firmware/LICENSE b/ToyRep/firmware/LICENSE new file mode 100644 index 0000000..f288702 --- /dev/null +++ b/ToyRep/firmware/LICENSE @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + <one line to give the program's name and a brief idea of what it does.> + Copyright (C) <year> <name of author> + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see <https://www.gnu.org/licenses/>. + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + <program> Copyright (C) <year> <name of author> + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +<https://www.gnu.org/licenses/>. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +<https://www.gnu.org/licenses/why-not-lgpl.html>. diff --git a/ToyRep/firmware/hello.c b/ToyRep/firmware/hello.c index c94998a..521471a 100644 --- a/ToyRep/firmware/hello.c +++ b/ToyRep/firmware/hello.c @@ -103,13 +103,9 @@ static cyg_uint32 serial_isr_handler(cyg_vector_t vector, cyg_addrword_t data); #define TEMP_KI_LIMIT 5000 #define TEMP_KD 800.0 -/* ISR data */ -#define CAMERA_BUFFER_AMOUNT 1 #define CAMERA_IMAGE_WIDTH 176 #define CAMERA_IMAGE_HEIGHT 144 -static volatile uint16_t cameraBuffer[CAMERA_BUFFER_AMOUNT]; -static volatile uint8_t cameraBufferPos; -static volatile uint8_t cameraImage[CAMERA_IMAGE_HEIGHT][CAMERA_IMAGE_WIDTH*2]; +/*static volatile uint8_t cameraImage[CAMERA_IMAGE_HEIGHT][CAMERA_IMAGE_WIDTH*2]; static volatile uint16_t cameraImagePosX = 0; static volatile uint16_t cameraImagePosY = 0; static volatile bool cameraImageStarted = true; @@ -117,9 +113,8 @@ static volatile bool cameraImageLineStarted = true; static volatile bool cameraImageFinished = false; static cyg_handle_t pclk_handle; static cyg_interrupt pclk_interrupt; -/* ISR functions */ static cyg_uint32 pclk_isr(cyg_vector_t vector, cyg_addrword_t); -static void pclk_dsr(cyg_vector_t vector, cyg_ucount32 count, cyg_addrword_t data); +static void pclk_dsr(cyg_vector_t vector, cyg_ucount32 count, cyg_addrword_t data);*/ #define CAMERA_XCLK_TIMER TIM3 #define CAMERA_XCLK_TIMCHANNEL TIM_OC4 @@ -324,15 +319,10 @@ void thread_hotend(cyg_addrword_t arg) ezs_printf("// Temperature Control ready.\n"); - // this is for testing which pins are GPIO pins lol - //setup_input_gpio(GPIOB, GPIO12, false); - while (!axisReady) {} ezs_printf("// All systems ready.\nstart\n"); - while (1) { - //ezs_printf("THIS MOTHERFUCKER IS: %d\n", diy_gpio_read_pin(GPIOB, GPIO12)); - + while (1) { uint16_t destination[1]; diy_adc_read(ADC1, channels, destination, 1); @@ -362,7 +352,6 @@ void thread_hotend(cyg_addrword_t arg) } pidLastError = e; - //ezs_printf("// PWM: %d\n", pwm); diy_tim_channel_set_compare_value((uint32_t) TIM2, TIM_OC2, pwm); // If absolute temperature error has been <= TEMP_TOLERANCE for 10s, it's stable @@ -395,8 +384,6 @@ void thread_gcodereader(cyg_addrword_t arg) gcode gc; uint8_t result = readGcode(&gc, s_serial_buffer[serial_read_next]); serial_read_next = (serial_read_next + 1) % SERIAL_BUFFER_AMOUNT; - - ezs_printf("// Reading Gcode %c%d (CS %d)\n", gc.operationCategory, gc.operationId, gc.checksumActual); if (result == ERR_GCODE_NO_N) { ezs_printf("!! Missing line number\n"); @@ -448,7 +435,6 @@ void thread_gcodeexecutor(cyg_addrword_t arg) { while (1) { gcode* gc = readFromBuffer(&buffer); - ezs_printf("// Executing Gcode %c%d\n", gc->operationCategory, gc->operationId); if (gc->operationCategory == 'G') { if (gc->operationId == 0 || gc->operationId == 1) { @@ -534,8 +520,6 @@ void thread_gcodeexecutor(cyg_addrword_t arg) if (yRel != 0.0) setAxisTarget(&axis_y, yTarget, ySpeed * lowestFactor); if (zRel != 0.0) setAxisTarget(&axis_z, zTarget, zSpeed * lowestFactor); if (eRel != 0.0) setAxisTarget(&axis_e, eRel, eSpeed * lowestFactor); - - ezs_printf("MOVE: %f, %f, %f, %f, Speed %f, %f, %f, %f", xRel, yRel, zRel, eRel, xSpeed * lowestFactor, ySpeed * lowestFactor, zSpeed * lowestFactor, eSpeed * lowestFactor); allAxesFinished = false; while (!allAxesFinished) {} @@ -661,7 +645,7 @@ bool gCodeIsSupported(gcode* gc) else return false; } -static cyg_uint8 stack_camerareader[STACKSIZE]; +/*static cyg_uint8 stack_camerareader[STACKSIZE]; static cyg_handle_t handle_camerareader; static cyg_thread threaddata_camerareader; void thread_camerareader(cyg_addrword_t arg) @@ -673,11 +657,11 @@ void thread_camerareader(cyg_addrword_t arg) uint16_t xP = 0, yP = 0, printed = 0; while (yP < CAMERA_IMAGE_HEIGHT) { while (xP < CAMERA_IMAGE_WIDTH*2) { - ezs_printf("%d x %d\n", xP, yP); - ezs_serial_putc(cameraImage[yP][xP]); + ezs_serial_putc(cameraImage[yP][xP]); printed++; xP++; } + xP = 0; yP++; } ezs_serial_putc('E');ezs_serial_putc('N');ezs_serial_putc('D');ezs_serial_putc('\n'); @@ -685,7 +669,7 @@ void thread_camerareader(cyg_addrword_t arg) } ezs_delay_us(1e4); } -} +}*/ void cyg_user_start(void) { @@ -714,7 +698,7 @@ void cyg_user_start(void) cyg_thread_create(11, &thread_hotend, 0, "hotend", stack_hotend, STACKSIZE, &handle_hotend, &threaddata_hotend); cyg_thread_create(11, &thread_gcodereader, 0, "gcode read", stack_gcodereader, STACKSIZE, &handle_gcodereader, &threaddata_gcodereader); cyg_thread_create(11, &thread_gcodeexecutor, 0, "gcode exec", stack_gcodeexecutor, STACKSIZE, &handle_gcodeexecutor, &threaddata_gcodeexecutor); - cyg_thread_create(11, &thread_camerareader, 0, "camera", stack_camerareader, STACKSIZE, &handle_camerareader, &threaddata_camerareader); + //cyg_thread_create(11, &thread_camerareader, 0, "camera", stack_camerareader, STACKSIZE, &handle_camerareader, &threaddata_camerareader); ezs_printf("// Creating serial interrupt...\n"); @@ -733,7 +717,7 @@ void cyg_user_start(void) cyg_interrupt_attach(serial_isr_handle); cyg_interrupt_unmask(SERIAL_IRQ); - ezs_printf("// Initializing Camera Pins...\n"); + /*ezs_printf("// Initializing Camera Pins...\n"); setup_input_gpio(CAMERA_DATA_PORT, CAMERA_DATA_PIN1 | CAMERA_DATA_PIN2 @@ -771,16 +755,6 @@ void cyg_user_start(void) tmp = 0b00011111; writeSCCB(&sccb, 0x11, tmp); - /*tmp = readSCCB(&sccb, 0x3E); - tmp &= 0b11100000; - tmp |= 0b00010100; - writeSCCB(&sccb, 0x3E, tmp); - - tmp = readSCCB(&sccb, 0x73); - tmp &= 0b11110000; - tmp |= 0b00000100; - writeSCCB(&sccb, 0x73, tmp);*/ - tmp = readSCCB(&sccb, 0x0C); tmp |= 0b00001000; writeSCCB(&sccb, 0x0C, tmp); @@ -811,7 +785,7 @@ void cyg_user_start(void) nvic_enable_irq(NVIC_EXTI15_10_IRQ); exti_select_source(EXTI15, GPIOA); - exti_set_trigger(EXTI15, EXTI_TRIGGER_RISING); + exti_set_trigger(EXTI15, EXTI_TRIGGER_RISING);*/ ezs_printf("// Starting threads...\n"); @@ -819,13 +793,13 @@ void cyg_user_start(void) cyg_thread_resume(handle_hotend); cyg_thread_resume(handle_gcodereader); cyg_thread_resume(handle_gcodeexecutor); - cyg_thread_resume(handle_camerareader); + //cyg_thread_resume(handle_camerareader); // hotend ready thread is also responsible for sending "start" when all systems are ready - tmp = readSCCB(&sccb, 0x09); + /*tmp = readSCCB(&sccb, 0x09); tmp &= 0b11101111; - writeSCCB(&sccb, 0x09, tmp); + writeSCCB(&sccb, 0x09, tmp);*/ } // ISR for reading from serial port @@ -856,7 +830,7 @@ static void serial_dsr_handler(cyg_vector_t vector, cyg_ucount32 count, cyg_addr } -static cyg_uint32 pclk_isr(cyg_vector_t vector, cyg_addrword_t data){ +/*static cyg_uint32 pclk_isr(cyg_vector_t vector, cyg_addrword_t data){ cyg_interrupt_acknowledge(vector); if (diy_gpio_read_pin(GPIOB, GPIO15) == 1) { // VSync Pin (B15) @@ -876,34 +850,4 @@ static cyg_uint32 pclk_isr(cyg_vector_t vector, cyg_addrword_t data){ return CYG_ISR_HANDLED; } -static void pclk_dsr(cyg_vector_t vector, cyg_ucount32 count, cyg_addrword_t data) {} - -/*static cyg_uint32 pclk_isr(cyg_vector_t vector, cyg_addrword_t data){ - cyg_interrupt_acknowledge(vector); - - uint16_t signal = (GPIOB_IDR >> 14) & 0x00000003; // pins B14 and B15 - if (signal != 0) { - signal |= (GPIOD_IDR & 0x0000FF00); // pins D8 to D15 - cameraBuffer[cameraBufferPos++] = signal; - return CYG_ISR_CALL_DSR | CYG_ISR_HANDLED; - } else { - return CYG_ISR_HANDLED; - } -} - -static void pclk_dsr(cyg_vector_t vector, cyg_ucount32 count, cyg_addrword_t data){ - uint8_t i = 0; - while (i < cameraBufferPos) { - //ezs_printf("Buf: %#04x\n", cameraBuffer[i]); - uint16_t buf = cameraBuffer[i]; - if ((buf & 0x02) != 0) { // VSync Pin (B15) - ezs_serial_putc('V'); - ezs_serial_putc('S'); - ezs_serial_putc('C'); - } else if ((buf & 0x01) != 0) { // HRef Pin (B14) - ezs_serial_putc((buf >> 8) & 0x00FF); - } - i++; - } - cameraBufferPos = 0; -}*/ +static void pclk_dsr(cyg_vector_t vector, cyg_ucount32 count, cyg_addrword_t data) {}*/ diff --git a/ToyRep/firmware/system.pdf b/ToyRep/firmware/system.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1dc016ab3706b12b8c70fa2e944f5dc234d93266 GIT binary patch literal 20237 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 literal 0 HcmV?d00001 -- GitLab