Add fxload3 utility needed for QHY cameras
This commit is contained in:
Executable
+9
@@ -0,0 +1,9 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
DIR=$(dirname "$0")
|
||||||
|
|
||||||
|
cd $DIR/fxload
|
||||||
|
|
||||||
|
cmake -B build -S . -DCMAKE_INSTALL_PREFIX=/usr
|
||||||
|
cmake --build ./build
|
||||||
|
sudo cmake --install ./build
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
cmake_minimum_required(VERSION 3.0)
|
||||||
|
PROJECT(fx3load C)
|
||||||
|
|
||||||
|
set(DATA_INSTALL_DIR "${CMAKE_INSTALL_PREFIX}/share/usb/")
|
||||||
|
############# FX3 Load ###############
|
||||||
|
set(fx3load_SRCS ${CMAKE_CURRENT_SOURCE_DIR}/main.c ${CMAKE_CURRENT_SOURCE_DIR}/ezusb.c)
|
||||||
|
|
||||||
|
add_executable(fxload ${fx3load_SRCS})
|
||||||
|
|
||||||
|
install(TARGETS fxload RUNTIME DESTINATION sbin)
|
||||||
|
install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/a3load.hex DESTINATION ${DATA_INSTALL_DIR})
|
||||||
+340
@@ -0,0 +1,340 @@
|
|||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 2, June 1991
|
||||||
|
|
||||||
|
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
|
||||||
|
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The licenses for most software are designed to take away your
|
||||||
|
freedom to share and change it. By contrast, the GNU General Public
|
||||||
|
License is intended to guarantee your freedom to share and change free
|
||||||
|
software--to make sure the software is free for all its users. This
|
||||||
|
General Public License applies to most of the Free Software
|
||||||
|
Foundation's software and to any other program whose authors commit to
|
||||||
|
using it. (Some other Free Software Foundation software is covered by
|
||||||
|
the GNU Library General Public License instead.) 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
|
||||||
|
this service 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 make restrictions that forbid
|
||||||
|
anyone to deny you these rights or to ask you to surrender the rights.
|
||||||
|
These restrictions translate to certain responsibilities for you if you
|
||||||
|
distribute copies of the software, or if you modify it.
|
||||||
|
|
||||||
|
For example, if you distribute copies of such a program, whether
|
||||||
|
gratis or for a fee, you must give the recipients all the rights that
|
||||||
|
you have. 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.
|
||||||
|
|
||||||
|
We protect your rights with two steps: (1) copyright the software, and
|
||||||
|
(2) offer you this license which gives you legal permission to copy,
|
||||||
|
distribute and/or modify the software.
|
||||||
|
|
||||||
|
Also, for each author's protection and ours, we want to make certain
|
||||||
|
that everyone understands that there is no warranty for this free
|
||||||
|
software. If the software is modified by someone else and passed on, we
|
||||||
|
want its recipients to know that what they have is not the original, so
|
||||||
|
that any problems introduced by others will not reflect on the original
|
||||||
|
authors' reputations.
|
||||||
|
|
||||||
|
Finally, any free program is threatened constantly by software
|
||||||
|
patents. We wish to avoid the danger that redistributors of a free
|
||||||
|
program will individually obtain patent licenses, in effect making the
|
||||||
|
program proprietary. To prevent this, we have made it clear that any
|
||||||
|
patent must be licensed for everyone's free use or not licensed at all.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow.
|
||||||
|
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||||
|
|
||||||
|
0. This License applies to any program or other work which contains
|
||||||
|
a notice placed by the copyright holder saying it may be distributed
|
||||||
|
under the terms of this General Public License. The "Program", below,
|
||||||
|
refers to any such program or work, and a "work based on the Program"
|
||||||
|
means either the Program or any derivative work under copyright law:
|
||||||
|
that is to say, a work containing the Program or a portion of it,
|
||||||
|
either verbatim or with modifications and/or translated into another
|
||||||
|
language. (Hereinafter, translation is included without limitation in
|
||||||
|
the term "modification".) Each licensee is addressed as "you".
|
||||||
|
|
||||||
|
Activities other than copying, distribution and modification are not
|
||||||
|
covered by this License; they are outside its scope. The act of
|
||||||
|
running the Program is not restricted, and the output from the Program
|
||||||
|
is covered only if its contents constitute a work based on the
|
||||||
|
Program (independent of having been made by running the Program).
|
||||||
|
Whether that is true depends on what the Program does.
|
||||||
|
|
||||||
|
1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the
|
||||||
|
notices that refer to this License and to the absence of any warranty;
|
||||||
|
and give any other recipients of the Program a copy of this License
|
||||||
|
along with the Program.
|
||||||
|
|
||||||
|
You may charge a fee for the physical act of transferring a copy, and
|
||||||
|
you may at your option offer warranty protection in exchange for a fee.
|
||||||
|
|
||||||
|
2. You may modify your copy or copies of the Program or any portion
|
||||||
|
of it, thus forming a work based on the Program, and copy and
|
||||||
|
distribute such modifications or work under the terms of Section 1
|
||||||
|
above, provided that you also meet all of these conditions:
|
||||||
|
|
||||||
|
a) You must cause the modified files to carry prominent notices
|
||||||
|
stating that you changed the files and the date of any change.
|
||||||
|
|
||||||
|
b) You must cause any work that you distribute or publish, that in
|
||||||
|
whole or in part contains or is derived from the Program or any
|
||||||
|
part thereof, to be licensed as a whole at no charge to all third
|
||||||
|
parties under the terms of this License.
|
||||||
|
|
||||||
|
c) If the modified program normally reads commands interactively
|
||||||
|
when run, you must cause it, when started running for such
|
||||||
|
interactive use in the most ordinary way, to print or display an
|
||||||
|
announcement including an appropriate copyright notice and a
|
||||||
|
notice that there is no warranty (or else, saying that you provide
|
||||||
|
a warranty) and that users may redistribute the program under
|
||||||
|
these conditions, and telling the user how to view a copy of this
|
||||||
|
License. (Exception: if the Program itself is interactive but
|
||||||
|
does not normally print such an announcement, your work based on
|
||||||
|
the Program is not required to print an announcement.)
|
||||||
|
|
||||||
|
These requirements apply to the modified work as a whole. If
|
||||||
|
identifiable sections of that work are not derived from the Program,
|
||||||
|
and can be reasonably considered independent and separate works in
|
||||||
|
themselves, then this License, and its terms, do not apply to those
|
||||||
|
sections when you distribute them as separate works. But when you
|
||||||
|
distribute the same sections as part of a whole which is a work based
|
||||||
|
on the Program, the distribution of the whole must be on the terms of
|
||||||
|
this License, whose permissions for other licensees extend to the
|
||||||
|
entire whole, and thus to each and every part regardless of who wrote it.
|
||||||
|
|
||||||
|
Thus, it is not the intent of this section to claim rights or contest
|
||||||
|
your rights to work written entirely by you; rather, the intent is to
|
||||||
|
exercise the right to control the distribution of derivative or
|
||||||
|
collective works based on the Program.
|
||||||
|
|
||||||
|
In addition, mere aggregation of another work not based on the Program
|
||||||
|
with the Program (or with a work based on the Program) on a volume of
|
||||||
|
a storage or distribution medium does not bring the other work under
|
||||||
|
the scope of this License.
|
||||||
|
|
||||||
|
3. You may copy and distribute the Program (or a work based on it,
|
||||||
|
under Section 2) in object code or executable form under the terms of
|
||||||
|
Sections 1 and 2 above provided that you also do one of the following:
|
||||||
|
|
||||||
|
a) Accompany it with the complete corresponding machine-readable
|
||||||
|
source code, which must be distributed under the terms of Sections
|
||||||
|
1 and 2 above on a medium customarily used for software interchange; or,
|
||||||
|
|
||||||
|
b) Accompany it with a written offer, valid for at least three
|
||||||
|
years, to give any third party, for a charge no more than your
|
||||||
|
cost of physically performing source distribution, a complete
|
||||||
|
machine-readable copy of the corresponding source code, to be
|
||||||
|
distributed under the terms of Sections 1 and 2 above on a medium
|
||||||
|
customarily used for software interchange; or,
|
||||||
|
|
||||||
|
c) Accompany it with the information you received as to the offer
|
||||||
|
to distribute corresponding source code. (This alternative is
|
||||||
|
allowed only for noncommercial distribution and only if you
|
||||||
|
received the program in object code or executable form with such
|
||||||
|
an offer, in accord with Subsection b above.)
|
||||||
|
|
||||||
|
The source code for a work means the preferred form of the work for
|
||||||
|
making modifications to it. For an executable work, complete source
|
||||||
|
code means all the source code for all modules it contains, plus any
|
||||||
|
associated interface definition files, plus the scripts used to
|
||||||
|
control compilation and installation of the executable. However, as a
|
||||||
|
special exception, the source code distributed need not include
|
||||||
|
anything that is normally distributed (in either source or binary
|
||||||
|
form) with the major components (compiler, kernel, and so on) of the
|
||||||
|
operating system on which the executable runs, unless that component
|
||||||
|
itself accompanies the executable.
|
||||||
|
|
||||||
|
If distribution of executable or object code is made by offering
|
||||||
|
access to copy from a designated place, then offering equivalent
|
||||||
|
access to copy the source code from the same place counts as
|
||||||
|
distribution of the source code, even though third parties are not
|
||||||
|
compelled to copy the source along with the object code.
|
||||||
|
|
||||||
|
4. You may not copy, modify, sublicense, or distribute the Program
|
||||||
|
except as expressly provided under this License. Any attempt
|
||||||
|
otherwise to copy, modify, sublicense or distribute the Program is
|
||||||
|
void, and will automatically terminate your rights under this License.
|
||||||
|
However, parties who have received copies, or rights, from you under
|
||||||
|
this License will not have their licenses terminated so long as such
|
||||||
|
parties remain in full compliance.
|
||||||
|
|
||||||
|
5. You are not required to accept this License, since you have not
|
||||||
|
signed it. However, nothing else grants you permission to modify or
|
||||||
|
distribute the Program or its derivative works. These actions are
|
||||||
|
prohibited by law if you do not accept this License. Therefore, by
|
||||||
|
modifying or distributing the Program (or any work based on the
|
||||||
|
Program), you indicate your acceptance of this License to do so, and
|
||||||
|
all its terms and conditions for copying, distributing or modifying
|
||||||
|
the Program or works based on it.
|
||||||
|
|
||||||
|
6. Each time you redistribute the Program (or any work based on the
|
||||||
|
Program), the recipient automatically receives a license from the
|
||||||
|
original licensor to copy, distribute or modify the Program subject to
|
||||||
|
these terms and conditions. You may not impose any further
|
||||||
|
restrictions on the recipients' exercise of the rights granted herein.
|
||||||
|
You are not responsible for enforcing compliance by third parties to
|
||||||
|
this License.
|
||||||
|
|
||||||
|
7. If, as a consequence of a court judgment or allegation of patent
|
||||||
|
infringement or for any other reason (not limited to patent issues),
|
||||||
|
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
|
||||||
|
distribute so as to satisfy simultaneously your obligations under this
|
||||||
|
License and any other pertinent obligations, then as a consequence you
|
||||||
|
may not distribute the Program at all. For example, if a patent
|
||||||
|
license would not permit royalty-free redistribution of the Program by
|
||||||
|
all those who receive copies directly or indirectly through you, then
|
||||||
|
the only way you could satisfy both it and this License would be to
|
||||||
|
refrain entirely from distribution of the Program.
|
||||||
|
|
||||||
|
If any portion of this section is held invalid or unenforceable under
|
||||||
|
any particular circumstance, the balance of the section is intended to
|
||||||
|
apply and the section as a whole is intended to apply in other
|
||||||
|
circumstances.
|
||||||
|
|
||||||
|
It is not the purpose of this section to induce you to infringe any
|
||||||
|
patents or other property right claims or to contest validity of any
|
||||||
|
such claims; this section has the sole purpose of protecting the
|
||||||
|
integrity of the free software distribution system, which is
|
||||||
|
implemented by public license practices. Many people have made
|
||||||
|
generous contributions to the wide range of software distributed
|
||||||
|
through that system in reliance on consistent application of that
|
||||||
|
system; it is up to the author/donor to decide if he or she is willing
|
||||||
|
to distribute software through any other system and a licensee cannot
|
||||||
|
impose that choice.
|
||||||
|
|
||||||
|
This section is intended to make thoroughly clear what is believed to
|
||||||
|
be a consequence of the rest of this License.
|
||||||
|
|
||||||
|
8. If the distribution and/or use of the Program is restricted in
|
||||||
|
certain countries either by patents or by copyrighted interfaces, the
|
||||||
|
original copyright holder who places the Program under this License
|
||||||
|
may add an explicit geographical distribution limitation excluding
|
||||||
|
those countries, so that distribution is permitted only in or among
|
||||||
|
countries not thus excluded. In such case, this License incorporates
|
||||||
|
the limitation as if written in the body of this License.
|
||||||
|
|
||||||
|
9. The Free Software Foundation may publish revised and/or new versions
|
||||||
|
of the 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 a version number of this License which applies to it and "any
|
||||||
|
later version", you have the option of following the terms and conditions
|
||||||
|
either of that version or of any later version published by the Free
|
||||||
|
Software Foundation. If the Program does not specify a version number of
|
||||||
|
this License, you may choose any version ever published by the Free Software
|
||||||
|
Foundation.
|
||||||
|
|
||||||
|
10. If you wish to incorporate parts of the Program into other free
|
||||||
|
programs whose distribution conditions are different, write to the author
|
||||||
|
to ask for permission. For software which is copyrighted by the Free
|
||||||
|
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||||
|
make exceptions for this. Our decision will be guided by the two goals
|
||||||
|
of preserving the free status of all derivatives of our free software and
|
||||||
|
of promoting the sharing and reuse of software generally.
|
||||||
|
|
||||||
|
NO WARRANTY
|
||||||
|
|
||||||
|
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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.
|
||||||
|
|
||||||
|
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||||
|
REDISTRIBUTE 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.
|
||||||
|
|
||||||
|
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
|
||||||
|
convey 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) 19yy <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 2 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, write to the Free Software
|
||||||
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
|
|
||||||
|
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
If the program is interactive, make it output a short notice like this
|
||||||
|
when it starts in an interactive mode:
|
||||||
|
|
||||||
|
Gnomovision version 69, Copyright (C) 19yy name of author
|
||||||
|
Gnomovision 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, the commands you use may
|
||||||
|
be called something other than `show w' and `show c'; they could even be
|
||||||
|
mouse-clicks or menu items--whatever suits your program.
|
||||||
|
|
||||||
|
You should also get your employer (if you work as a programmer) or your
|
||||||
|
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||||
|
necessary. Here is a sample; alter the names:
|
||||||
|
|
||||||
|
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
||||||
|
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
||||||
|
|
||||||
|
<signature of Ty Coon>, 1 April 1989
|
||||||
|
Ty Coon, President of Vice
|
||||||
|
|
||||||
|
This 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 Library General
|
||||||
|
Public License instead of this License.
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
|
||||||
|
FXLOAD UTILITY
|
||||||
|
|
||||||
|
This program is conveniently able to download firmware into FX, FX2,
|
||||||
|
and FX2LP EZ-USB devices, as well as the original AnchorChips EZ-USB.
|
||||||
|
It is intended to be invoked by hotplug scripts when the unprogrammed
|
||||||
|
device appears on the bus.
|
||||||
|
|
||||||
|
Primarily as an aid for developers, this can also be used to update
|
||||||
|
firmware on devices which boot from I2C serial EEPROMs. For that
|
||||||
|
use, as well as downloading firmware to all other off-chip memory,
|
||||||
|
a second stage loader must first be downloaded.
|
||||||
|
|
||||||
|
The distribution includes "a3load.hex", which is a simple second stage
|
||||||
|
loader that works with all the EZ-USB products listed above. If you
|
||||||
|
want to write to an EEPROM, you can use the appropriate version of the
|
||||||
|
"Vend_Ax" code provided with the Cypress developer kit.
|
||||||
|
|
||||||
|
|
||||||
|
UPDATES
|
||||||
|
|
||||||
|
See the download page at http://linux-hotplug.sourceforge.net for the
|
||||||
|
latest release. The CVS repository there holds the most current version
|
||||||
|
of this software. The web site shows some ways to use "fxload" in
|
||||||
|
conjunction with USB hotplugging, to load device firmware.
|
||||||
|
|
||||||
|
Post any bug reports to the linux-hotplug-devel or linux-usb-devel lists.
|
||||||
|
|
||||||
|
If you modify the code, the GPL requires that you make your updates
|
||||||
|
generally available (under most circumstances). Providing them in the
|
||||||
|
form of patches against the current CVS ("cvs diff -u"), or the last
|
||||||
|
release ("diff -u old new") is most useful, since otherwise it's awkward
|
||||||
|
to integrate such changes into the standard distribution.
|
||||||
|
|
||||||
|
$Id: README.txt,v 1.5 2008/10/13 21:23:23 dbrownell Exp $
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
#
|
||||||
|
# $Id: a3load.hex,v 1.1 2002/04/12 00:23:28 dbrownell Exp $
|
||||||
|
#
|
||||||
|
# This file contains "a3load" object code, as found in the Cypress
|
||||||
|
# EZ-USB developer kit. It implements a second stage firmware loader
|
||||||
|
# supporting the original EZ-USB parts and the newer FX and FX2 ones,
|
||||||
|
# using the 0xA3 vendor request convention.
|
||||||
|
#
|
||||||
|
# If you want a loader for development use, which can write to the I2C
|
||||||
|
# boot EEPROM using the 0xA2 request, see the "Vend_Ax" code provided
|
||||||
|
# with the developer kit for your microcontroller.
|
||||||
|
#
|
||||||
|
#
|
||||||
|
# Copyright (c) 2001-2002 by Cypress Semiconductor Corporation
|
||||||
|
#
|
||||||
|
# Cypress Semiconductor Corporation hereby grants a copyright license to
|
||||||
|
# use or redistribute this firmware image, in text or binary form as
|
||||||
|
# required, only in conjunction with devices using a Cypress USB
|
||||||
|
# microcontroller. Every copy in any form of the firmware shall include
|
||||||
|
# Cypress copyright legends.
|
||||||
|
#
|
||||||
|
# DISCLAIMERS.
|
||||||
|
# THIS FIRMWARE IS LICENSED "AS-IS." CYPRESS MAKES NO WARRANTIES AS TO
|
||||||
|
# PERFORMANCE, WHETHER EXPRESS, IMPLIED, OR STATUTORY, IN THIS LICENSE
|
||||||
|
# OR COMMUNICATION BETWEEN LICENSEE AND CYPRESS. CYPRESS SPECIFICALLY
|
||||||
|
# DISCLAIMS ALL WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING
|
||||||
|
# BUT NOT LIMITED TO THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS
|
||||||
|
# OF THIS PROGRAM FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE
|
||||||
|
# FIRMWARE, AND THE USE, OPERATION OR SUPPORT OF THE FIRMWARE.
|
||||||
|
# IN NO EVENT SHALL CYPRESS BE LIABLE FOR ANY CONSEQUENTIAL, INDIRECT,
|
||||||
|
# INCIDENTAL, PUNITIVE, OR SPECIAL DAMAGES WHATSOEVER, INCLUDING WITHOUT
|
||||||
|
# LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
|
||||||
|
# INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND THE LIKE, ARISING OUT
|
||||||
|
# OF OR RELATED TO THE FIRMWARE, EVEN IF CYPRESS HAS BEEN ADVISED OF THE
|
||||||
|
# POSSIBILITY OF SUCH DAMAGES.
|
||||||
|
#
|
||||||
|
:1003570090E668E0FF74FFF0E0B40B04EFF0D322FF
|
||||||
|
:0603670090E668EFF0C310
|
||||||
|
:01036D00226D
|
||||||
|
:1001B500907FE9E064A360030202C5A3E07508002F
|
||||||
|
:1001C500F509A3E0FEE4EE4208907FEEE0750A0033
|
||||||
|
:1001D500F50BA3E0FEE4EE420A907FE8E064407090
|
||||||
|
:1001E50064E50B450A70030202D6E4907FC5F090E2
|
||||||
|
:1001F5007FB4E020E3F9907FC5E0750C00F50DE4D0
|
||||||
|
:10020500FCFDC3ED950DEC950C501F74C02DF582CA
|
||||||
|
:10021500E4347EF583E0FFE5092DF582E5083CF53C
|
||||||
|
:1002250083EFF00DBD00010C80D8E50D2509F5091A
|
||||||
|
:10023500E50C3508F508C3E50B950DF50BE50A95B5
|
||||||
|
:100245000CF50A809C907FE8E064C060030202D64A
|
||||||
|
:10025500E50B450A607BC3E50B9440E50A94005025
|
||||||
|
:1002650008850A0C850B0D8006750C00750D40E49C
|
||||||
|
:10027500FCFDC3ED950DEC950C501FE5092DF582A0
|
||||||
|
:10028500E5083CF583E0FF74002DF582E4347FF545
|
||||||
|
:1002950083EFF00DBD00010C80D8907FB5E50DF022
|
||||||
|
:1002A5002509F509E50C3508F508C3E50B950DF5A8
|
||||||
|
:1002B5000BE50A950CF50A907FB4E030E29280F7E1
|
||||||
|
:1002C500907FE9E0B4AC0AE4907F00F0907FB5043C
|
||||||
|
:0802D500F0907FB4E04402F058
|
||||||
|
:0102DD0022FE
|
||||||
|
:1000800090E6B9E064A36003020198A3E07508005C
|
||||||
|
:10009000F509A3E0FEE4EE420890E6BEE0750A0032
|
||||||
|
:1000A000F50BA3E0FEE4EE420A90E6B8E06440708F
|
||||||
|
:1000B00066E50B450A70030201ADE490E68AF0A301
|
||||||
|
:1000C000F090E6A0E020E1F990E68BE0750C00F5F9
|
||||||
|
:1000D0000DE4FCFDC3ED950DEC950C501F74402D07
|
||||||
|
:1000E000F582E434E7F583E0FFE5092DF582E508C4
|
||||||
|
:1000F0003CF583EFF00DBD00010C80D8E50D25091E
|
||||||
|
:10010000F509E50C3508F508C3E50B950DF50BE58C
|
||||||
|
:100110000A950CF50A809A90E6B8E064C060030284
|
||||||
|
:1001200001ADE50B450A70030201ADC3E50B944038
|
||||||
|
:10013000E50A94005008850A0C850B0D8006750CA5
|
||||||
|
:1001400000750D40E4FCFDC3ED950DEC950C501FC2
|
||||||
|
:10015000E5092DF582E5083CF583E0FF74402DF5B7
|
||||||
|
:1001600082E434E7F583EFF00DBD00010C80D8E4A4
|
||||||
|
:1001700090E68AF0A3E50DF02509F509E50C3508B0
|
||||||
|
:10018000F508C3E50B950DF50BE50A950CF50A90FE
|
||||||
|
:10019000E6A0E030E18C80F790E6B9E0B4AC0E90D8
|
||||||
|
:1001A000E7407401F0E490E68AF0A304F090E6A042
|
||||||
|
:0401B000E04480F0B7
|
||||||
|
:0101B4002228
|
||||||
|
:1002DE00C2011203579200907F95E044C0F0D2E81D
|
||||||
|
:1002EE0030000890E6687408F08007907FAFE04415
|
||||||
|
:1002FE0001F030000890E65C7401F08006907FAE4D
|
||||||
|
:10030E007401F0D2AF3001FD300005120080800381
|
||||||
|
:07031E001201B5C20180EEDF
|
||||||
|
:03000300020325D0
|
||||||
|
:10032500C0E0C083C082C085C084C086758600D207
|
||||||
|
:10033500015391EF30000890E65D7401F08006905E
|
||||||
|
:100345007FAB7401F0D086D084D085D082D083D0A5
|
||||||
|
:02035500E03294
|
||||||
|
:03004300020400B4
|
||||||
|
:0404000002032500CE
|
||||||
|
:0300000002036E8A
|
||||||
|
:0C036E00787FE4F6D8FD7581200202DEE5
|
||||||
|
:00000001FF
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
fxload (1.0) bionic; urgency=medium
|
||||||
|
|
||||||
|
* FX3 release.
|
||||||
|
|
||||||
|
-- Jasem Mutlaq <mutlaqja@ikarustech.com> Thu, 07 Jul 2022 20:00:00 +0300
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
10
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
Source: fxload
|
||||||
|
Section: admin
|
||||||
|
Priority: optional
|
||||||
|
Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
|
||||||
|
XSBC-Original-Maintainer: Jasem Mutlaq <mutlaqja@ikarustech.com>
|
||||||
|
Build-Depends: debhelper (>= 7), cdbs, cmake
|
||||||
|
Standards-Version: 3.8.4
|
||||||
|
|
||||||
|
Package: fxload
|
||||||
|
Architecture: any
|
||||||
|
Depends: ${shlibs:Depends}, ${misc:Depends}
|
||||||
|
Conflicts: hotplug-utils
|
||||||
|
Replaces: hotplug-utils
|
||||||
|
Provides: hotplug-utils
|
||||||
|
Enhances: hotplug
|
||||||
|
Description: Firmware download to EZ-USB devices
|
||||||
|
This program is conveniently able to download firmware into FX and FX2
|
||||||
|
ez-usb devices. It is intended to be invoked by hotplug scripts when
|
||||||
|
the unprogrammed device appears on the bus.
|
||||||
@@ -0,0 +1,40 @@
|
|||||||
|
This package was debianized by Fumitoshi UKAI <ukai@debian.or.jp> on
|
||||||
|
Tue, 30 Apr 2002 02:46:12 +0900.
|
||||||
|
|
||||||
|
It was downloaded from http://linux-hotplug.sourceforge.net/
|
||||||
|
|
||||||
|
Upstream Authors:
|
||||||
|
Stephen Williams <steve@icarus.com>
|
||||||
|
David Brownell <dbrownell@users.sourceforge.net>
|
||||||
|
Roger Williams <rawqux@users.sourceforge.net>
|
||||||
|
|
||||||
|
Greg Kroah-Hartman
|
||||||
|
Matthew Dharm
|
||||||
|
Miles Lane
|
||||||
|
Randy Dunlap
|
||||||
|
|
||||||
|
Copyright:
|
||||||
|
Copyright (c) 2001 Stephen Williams (steve@icarus.com)
|
||||||
|
Copyright (c) 2001-2002 David Brownell (dbrownell@users.sourceforge.net)
|
||||||
|
Copyright (c) 2008 Roger Williams (rawqux@users.sourceforge.net)
|
||||||
|
|
||||||
|
License: GPL2+
|
||||||
|
|
||||||
|
This source code is free software; you can redistribute it
|
||||||
|
and/or modify it in source code form under the terms of the GNU
|
||||||
|
General Public License as published by the Free Software
|
||||||
|
Foundation; either version 2 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, write to the Free Software
|
||||||
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||||
|
|
||||||
|
On Debian systems, a copy of the GNU General Public License may be found in
|
||||||
|
/usr/share/common-licenses/GPL.
|
||||||
|
|
||||||
Executable
+6
@@ -0,0 +1,6 @@
|
|||||||
|
#!/usr/bin/make -f
|
||||||
|
|
||||||
|
include /usr/share/cdbs/1/rules/debhelper.mk
|
||||||
|
include /usr/share/cdbs/1/class/cmake.mk
|
||||||
|
|
||||||
|
DEB_DH_SHLIBDEPS_ARGS=-u--ignore-missing-info
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
3.0 (quilt)
|
||||||
+1039
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,80 @@
|
|||||||
|
#ifndef __ezusb_H
|
||||||
|
#define __ezusb_H
|
||||||
|
/*
|
||||||
|
* Copyright (c) 2001 Stephen Williams (steve@icarus.com)
|
||||||
|
* Copyright (c) 2002 David Brownell (dbrownell@users.sourceforge.net)
|
||||||
|
* Copyright (c) 2012 Steve Magnani (steve@digidescorp.com)
|
||||||
|
*
|
||||||
|
* This source code is free software; you can redistribute it
|
||||||
|
* and/or modify it in source code form under the terms of the GNU
|
||||||
|
* General Public License as published by the Free Software
|
||||||
|
* Foundation; either version 2 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, write to the Free Software
|
||||||
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
|
||||||
|
*/
|
||||||
|
#ident "$Id: ezusb.h,v 1.4 2008/10/13 21:25:29 dbrownell Exp $"
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This function loads the firmware from the given file into RAM.
|
||||||
|
* The file is assumed to be in Intel HEX format unless type is fx3.
|
||||||
|
* If type is fx2 or fx2lp, appropriate reset commands are used.
|
||||||
|
* Stage == 0 means this is a single stage load (or the first of two stages).
|
||||||
|
* Otherwise it's the second of two stages; the caller preloaded the second
|
||||||
|
* stage loader.
|
||||||
|
*
|
||||||
|
* The target processor is reset at the end of this download.
|
||||||
|
*/
|
||||||
|
extern int ezusb_load_ram (int dev, const char *path, const char *type,
|
||||||
|
int stage);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This function stores the firmware from the given file into EEPROM.
|
||||||
|
* The file is assumed to be in Intel HEX format. This uses the right
|
||||||
|
* CPUCS address to terminate the EEPROM load with a reset command,
|
||||||
|
* where FX parts behave differently than FX2 ones. The configuration
|
||||||
|
* byte is as provided here (zero for an21xx parts) and the EEPROM
|
||||||
|
* type is set so that the microcontroller will boot from it.
|
||||||
|
*
|
||||||
|
* The caller must have preloaded a second stage loader that knows
|
||||||
|
* how to respond to the EEPROM write request.
|
||||||
|
*/
|
||||||
|
extern int ezusb_load_eeprom (
|
||||||
|
int dev, /* usbfs device handle */
|
||||||
|
const char *path, /* path to hexfile */
|
||||||
|
const char *type, /* fx, fx2, an21 */
|
||||||
|
int config /* config byte for fx/fx2; else zero */
|
||||||
|
);
|
||||||
|
|
||||||
|
|
||||||
|
/* boolean flag, says whether to write extra messages to stderr */
|
||||||
|
extern int verbose;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* $Log: ezusb.h,v $
|
||||||
|
* Revision 1.4 2008/10/13 21:25:29 dbrownell
|
||||||
|
* Whitespace fixes.
|
||||||
|
*
|
||||||
|
* Revision 1.3 2002/04/12 00:28:21 dbrownell
|
||||||
|
* support "-t an21" to program EEPROMs for those microcontrollers
|
||||||
|
*
|
||||||
|
* Revision 1.2 2002/02/26 19:55:05 dbrownell
|
||||||
|
* 2nd stage loader support
|
||||||
|
*
|
||||||
|
* Revision 1.1 2001/06/12 00:00:50 stevewilliams
|
||||||
|
* Added the fxload program.
|
||||||
|
* Rework root makefile and hotplug.spec to install in prefix
|
||||||
|
* location without need of spec file for install.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
Binary file not shown.
+249
@@ -0,0 +1,249 @@
|
|||||||
|
.\" fxload.8
|
||||||
|
.\" Created: Fri Dec 28 2001 by David Brownell
|
||||||
|
.\" Copyright (c) 2001-2002 David Brownell <dbrownell@users.sourceforge.net>
|
||||||
|
.\" Copyright (c) 2008 Roger Williams <rawqux@users.sourceforge.net>
|
||||||
|
.\"
|
||||||
|
.\" Permission is granted to make and distribute verbatim copies of this
|
||||||
|
.\" manual provided the copyright notice and this permission notice are
|
||||||
|
.\" preserved on all copies.
|
||||||
|
.\"
|
||||||
|
.\" Permission is granted to copy and distribute modified versions of this
|
||||||
|
.\" manual under the conditions for verbatim copying, provided that the
|
||||||
|
.\" entire resulting derived work is distributed under the terms of a
|
||||||
|
.\" permission notice identical to this one
|
||||||
|
.\"
|
||||||
|
.\" Since the Linux kernel and libraries are constantly changing, this
|
||||||
|
.\" manual page may be incorrect or out-of-date. The author(s) assume no
|
||||||
|
.\" responsibility for errors or omissions, or for damages resulting from
|
||||||
|
.\" the use of the information contained herein. The author(s) may not
|
||||||
|
.\" have taken the same level of care in the production of this manual,
|
||||||
|
.\" which is licensed free of charge, as they might when working
|
||||||
|
.\" professionally.
|
||||||
|
.\"
|
||||||
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
||||||
|
.\" the source, must acknowledge the copyright and authors of this work.
|
||||||
|
.\"
|
||||||
|
.TH FXLOAD 8 "April 2012" "" "Linux Programmer's Manual"
|
||||||
|
.SH "NAME"
|
||||||
|
fxload \- Firmware download to EZ-USB devices
|
||||||
|
.SH "SYNOPSIS"
|
||||||
|
.B fxload
|
||||||
|
.BI "[ \-v ]"
|
||||||
|
.BI "[ \-l ]"
|
||||||
|
.BI "[ \-D " devpath " ]"
|
||||||
|
.BI "[ \-I " firmware " ]"
|
||||||
|
.BI "[ \-t " type " ]"
|
||||||
|
.BI "[ \-c " config " ]"
|
||||||
|
.BI "[ \-s " loader " ]"
|
||||||
|
.br
|
||||||
|
.B fxload
|
||||||
|
.BI "[ \-D " devpath " ]"
|
||||||
|
.BI "[ \-L " link " ]"
|
||||||
|
.BI "[ \-m " mode " ]"
|
||||||
|
.br
|
||||||
|
.B fxload
|
||||||
|
.BI "[ \-V ]"
|
||||||
|
.SH "DESCRIPTION"
|
||||||
|
.B fxload
|
||||||
|
is a program which downloads firmware to USB devices based on
|
||||||
|
AnchorChips EZ-USB, Cypress EZ-USB FX,
|
||||||
|
or Cypress EZ-USB FX2/FX2LP/FX3 microcontrollers.
|
||||||
|
These have 8-bit 8051 cores with special extensions for USB I/O.
|
||||||
|
The FX2 supports high speed USB 2.0 transfers (480 Mbit/sec)
|
||||||
|
as well as full speed USB 1.1 transfers (12 Mbit/sec),
|
||||||
|
while the earlier parts support only full speed transfers.
|
||||||
|
The FX3 supports super speed USB 3.0 transfers and has a 32-bit
|
||||||
|
ARM core.
|
||||||
|
These controllers have several package options,
|
||||||
|
and can be set up with external memory (on-chip memory is
|
||||||
|
usually 8K or 16K; for FX3, it is 512K), EEPROMs, and ROMs when
|
||||||
|
device costs allow.
|
||||||
|
.PP
|
||||||
|
This uses "usbfs" (older name: "usbdevfs") to access
|
||||||
|
devices, and issues vendor specific control requests
|
||||||
|
to download and reset the EZ-USB devices.
|
||||||
|
Normally, firmware will then "renumerate" by disconnecting from
|
||||||
|
USB and then reconnecting as a new device.
|
||||||
|
It then appears with new device descriptors and functionality,
|
||||||
|
as provided by the firmware which has been downloaded.
|
||||||
|
.PP
|
||||||
|
To support some non-firmware applications, this can also set
|
||||||
|
up symbolic links for those usbfs names.
|
||||||
|
It can also change their access modes.
|
||||||
|
Both of these can help simplify software applications that
|
||||||
|
need to talk to USB devices using user mode drivers,
|
||||||
|
don't want to run with privileges or to examine all of the
|
||||||
|
existing USB devices,
|
||||||
|
and which don't need more kernel drivers.
|
||||||
|
.PP
|
||||||
|
See the
|
||||||
|
.I Linux-Hotplug
|
||||||
|
web site for information about how to use
|
||||||
|
.B fxload
|
||||||
|
to download device firmware when hotplugging USB devices,
|
||||||
|
using driver-specific scripts stored in the
|
||||||
|
.I /etc/hotplug/usb
|
||||||
|
directory.
|
||||||
|
.SH "FUNCTION LETTERS"
|
||||||
|
At least one of the following options must be specified.
|
||||||
|
Note that as usual with UNIX and Linux commands,
|
||||||
|
the order of command option flags does not matter.
|
||||||
|
You may use these in any order.
|
||||||
|
.TP
|
||||||
|
.BI "\-I " firmware
|
||||||
|
Downloads the specified firmware file.
|
||||||
|
For FX3 devices, the format is a Cypress-specific binary image.
|
||||||
|
For other devices, the file has standard Intel hexfile format.
|
||||||
|
(Common naming conventions include
|
||||||
|
.I *.hex
|
||||||
|
,
|
||||||
|
.I *.ihx
|
||||||
|
, and
|
||||||
|
.IR *.img ).
|
||||||
|
Depending on the device and firmware in use, the
|
||||||
|
.B \-s
|
||||||
|
option may also be necessary to specify a second stage loader.
|
||||||
|
Firmware is normally downloaded to RAM and executed, but there
|
||||||
|
is also an option for downloading into bootable I2C EEPROMs.
|
||||||
|
.TP
|
||||||
|
.BI "\-L " link
|
||||||
|
Creates the specified symbolic link to the usbfs device path.
|
||||||
|
This would typically be used to create a name in a directory
|
||||||
|
that would be searched by an application.
|
||||||
|
The symlink would be removed by some other component on device unplug.
|
||||||
|
.TP
|
||||||
|
.BI "\-m " mode
|
||||||
|
Changes permissions on the "usbfs" device node.
|
||||||
|
By default, those nodes are only accessible by privileged
|
||||||
|
users, which doesn't help when the user mode device driver
|
||||||
|
needs to run without root privileges.
|
||||||
|
Note that usbfs mount options like
|
||||||
|
.I devmode=0666
|
||||||
|
are also available.
|
||||||
|
.TP
|
||||||
|
.B "\-V"
|
||||||
|
Identifies the version of fxload being invoked, and exits
|
||||||
|
without performing other actions.
|
||||||
|
.PP
|
||||||
|
Note that when downloading firmware that renumerates,
|
||||||
|
there's no point in changing the device permissions
|
||||||
|
or creating a symbolic link.
|
||||||
|
.SH "OPTIONS"
|
||||||
|
By default,
|
||||||
|
.B fxload
|
||||||
|
assumes the device uses an EZ-USB or EZ-USB FX.
|
||||||
|
It also assumes that the device in question has been specified
|
||||||
|
by USB kernel hotplugging conventions, using the
|
||||||
|
.I DEVICE
|
||||||
|
environment variable to name a "usbfs"
|
||||||
|
file that can be used to talk to the device.
|
||||||
|
.TP
|
||||||
|
.BI "\-c " config
|
||||||
|
Indicates the specified firmware should be downloaded to an
|
||||||
|
I2C boot EEPROM rather than to RAM.
|
||||||
|
The parameter is the EZ-USB FX or FX2 configuration byte,
|
||||||
|
and for AnchorChips devices the value should be zero.
|
||||||
|
This requires a second stage loader (e.g. vend_ax.hex) that knows
|
||||||
|
how to write to I2C EEPROMs specified using the
|
||||||
|
.B \-s
|
||||||
|
option, as well as a device that's provided with an EEPROM
|
||||||
|
large enough to store the boot firmware.
|
||||||
|
After downloading to a device's EEPROM,
|
||||||
|
you should retest it starting from power off.
|
||||||
|
.TP
|
||||||
|
.BI "\-s " loader
|
||||||
|
This identifies the file holding a second stage loader
|
||||||
|
(in the same file format as the firmware itself),
|
||||||
|
which is loaded into internal memory.
|
||||||
|
This loader understands additional vendor control requests,
|
||||||
|
beyond the one built into all EZ-USB hardware,
|
||||||
|
which are needed to write external RAM or EEPROM.
|
||||||
|
As a last step when loading firmware,
|
||||||
|
.B fxload
|
||||||
|
normally overwrites this second stage loader
|
||||||
|
with parts of the firmware residing on-chip.
|
||||||
|
.TP
|
||||||
|
.BI "\-t " type
|
||||||
|
Indicates which type of microcontroller is used in the device;
|
||||||
|
type may be one of
|
||||||
|
.I an21
|
||||||
|
(the original AnchorChips devices),
|
||||||
|
.I fx
|
||||||
|
(Cypress' updated version, the EZ-USB FX),
|
||||||
|
.I fx2
|
||||||
|
(the Cypress EZ-USB FX2, supporting high speed transfers),
|
||||||
|
.I fx2lp
|
||||||
|
(the Cypress EZ-USB FX2LP, with 16KB internal RAM), or
|
||||||
|
.I fx3
|
||||||
|
(the Cypress EZ-USB FX3, supporting USB 3.0).
|
||||||
|
Except when writing to EEPROM, all that normally matters when
|
||||||
|
downloading firmware is whether or not the device uses an FX2
|
||||||
|
or FX3.
|
||||||
|
.TP
|
||||||
|
.B "\-v"
|
||||||
|
Prints some diagnostics, such as download addresses and sizes,
|
||||||
|
to standard error. Repeat the flag
|
||||||
|
.RB ( -vv ", " -vvv )
|
||||||
|
to get more diagnostics.
|
||||||
|
.TP
|
||||||
|
.B "\-l"
|
||||||
|
print error and verbose messages to syslog.
|
||||||
|
.TP
|
||||||
|
.BI "\-D " devpath
|
||||||
|
Specifies the "usbfs" path name for the device in question,
|
||||||
|
such as
|
||||||
|
.IR /proc/bus/usb/004/080 .
|
||||||
|
This takes precedence over any
|
||||||
|
.I DEVICE
|
||||||
|
environment variable that may be set.
|
||||||
|
.SH "NOTES"
|
||||||
|
.PP
|
||||||
|
This program implements one extension to the standard "hex file" format.
|
||||||
|
Lines beginning with a "#" character are ignored, and may be used to
|
||||||
|
hold copyright statements and other information.
|
||||||
|
Other tools may not handle hexfiles using this extension.
|
||||||
|
.PP
|
||||||
|
At this writing, "usbfs" is a kernel configuration option.
|
||||||
|
That means that device drivers relying on user mode firmware
|
||||||
|
downloading may need to depend on that kernel configuration option.
|
||||||
|
A less preferable alternative involves compiling the firmware
|
||||||
|
into the kernel and managing downloads and renumeration there.
|
||||||
|
This is less preferable in part because much device firmware is
|
||||||
|
provided with GPL-incompatible licensing, and in part because
|
||||||
|
storing such firmware firmware wastes kernel memory.
|
||||||
|
.PP
|
||||||
|
For EZ-USB family devices, the hardware's first stage loader
|
||||||
|
(supporting the 0xA0 vendor request) can't write into external memory.
|
||||||
|
Configurations that put firmware into external memory thus need a
|
||||||
|
second stage loader.
|
||||||
|
For typical "flat" memory architectures, a loader supporting the 0xA3
|
||||||
|
vendor request is used to write into that memory.
|
||||||
|
Similarly, a second stage loader that supports the 0xA2 vendor request
|
||||||
|
is needed when writing boot firmware into an I2C EEPROM.
|
||||||
|
These 0xA2 and 0xA3 vendor commands are conventions defined by Cypress.
|
||||||
|
Devices that use bank switching or similar mechanisms to stretch the
|
||||||
|
64KByte address space may need different approaches to loading firmware.
|
||||||
|
.PP
|
||||||
|
Not all devices support EEPROM updates.
|
||||||
|
Some EZ-USB based devices don't have an I2C EEPROM;
|
||||||
|
many such EEPROMs are too small to store firmware;
|
||||||
|
and some firmware can't be placed in bootable I2C EEPROMs.
|
||||||
|
.SH "ENVIRONMENT VARIABLES"
|
||||||
|
.TP
|
||||||
|
.B DEVICE
|
||||||
|
normally names a "usbfs" file that will be used to talk to the device.
|
||||||
|
This is provided by the Linux kernel as part of USB hotplugging.
|
||||||
|
.SH "FILES"
|
||||||
|
.TP
|
||||||
|
.I /usr/share/usb/a3load.hex
|
||||||
|
Second stage loader that works with AnchorChips EZ-USB,
|
||||||
|
Cypress EZ-USB FX, and Cypress EZ-USB FX2.
|
||||||
|
Note that this only supports the 0xA3 vendor command, to
|
||||||
|
write external memory.
|
||||||
|
A loader that also supports the 0xA2 command, to write boot EEPROMs,
|
||||||
|
is included with Cypress developer kits.
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR hotplug "(8) "
|
||||||
|
.SH "AUTHORS"
|
||||||
|
Linux Hotplugging Project
|
||||||
|
.I http://linux-hotplug.sourceforge.net/
|
||||||
@@ -0,0 +1,87 @@
|
|||||||
|
Summary: EZ-USB utility program
|
||||||
|
Name: fxload
|
||||||
|
Version: VERCODE
|
||||||
|
Release: 1
|
||||||
|
Group: Applications/System
|
||||||
|
License: GPL
|
||||||
|
Url: http://linux-hotplug.sourceforge.net/
|
||||||
|
Source0: %{name}-%{version}.tar.gz
|
||||||
|
|
||||||
|
%description
|
||||||
|
This package contains utilities for downloading firmware to EZ-USB devices.
|
||||||
|
EZ-USB devices use 8051-based microcontrollers that have been enhanced with
|
||||||
|
registers, buffers, and other device-side support for USB transactions.
|
||||||
|
|
||||||
|
It currently supports devices based on the Anchorchips EZ-USB, as well as the
|
||||||
|
Cypress EZ-USB FX (which is almost completely source compatible) and EZ-USB FX2
|
||||||
|
(which is not). All of these support full speed (12 Mbit/sec) transfers. The
|
||||||
|
FX2 also supports high speed (480 Mbit/s) transfers, introduced in USB 2.0.
|
||||||
|
|
||||||
|
This version of FXLOAD supports optional use of two-stage loading, where
|
||||||
|
special device firmware is used to support writing into off-chip memory such
|
||||||
|
as RAM (when firmware neeeds more than about 8 KBytes of code and data) or,
|
||||||
|
for firmware development, I2C serial EEPROM.
|
||||||
|
|
||||||
|
%prep
|
||||||
|
%setup -q
|
||||||
|
|
||||||
|
%build
|
||||||
|
# Build any compiled programs in the source tree.
|
||||||
|
make all CFLAGS="%optflags -DFXLOAD_VERSION=\\\"%version\\\""
|
||||||
|
|
||||||
|
%install
|
||||||
|
make prefix=%buildroot install
|
||||||
|
|
||||||
|
# --
|
||||||
|
# The utils package contains utility programs that certain devices
|
||||||
|
# might need along with the core hotplug in order to boot up the
|
||||||
|
# device in question.
|
||||||
|
%files
|
||||||
|
%defattr(-,root,root)
|
||||||
|
/sbin/fxload
|
||||||
|
|
||||||
|
|
||||||
|
%changelog
|
||||||
|
* Mon Apr 01 2002 David Brownell <dbrownell@users.sourceforge.net>
|
||||||
|
- fixed/updated RPM build and Makefile
|
||||||
|
- Makefile automatically embeds version into specfile and binary
|
||||||
|
- fxload handles 2nd stage loader
|
||||||
|
|
||||||
|
* Mon Jan 21 2002 David Brownell <dbrownell@users.sourceforge.net>
|
||||||
|
- update fxload rpm description. also, manpage now installs.
|
||||||
|
|
||||||
|
* Mon Jan 14 2002 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- split fxload specific stuff out of the base hotplug.spec file
|
||||||
|
to keep the hotplug core arch independant
|
||||||
|
|
||||||
|
* Mon Jun 11 2001 Steve Williams <steve@icarus.com>
|
||||||
|
- The install process is now in the comon makefile, so that non-
|
||||||
|
rpm installs can work. This spec file thus invokes that install.
|
||||||
|
|
||||||
|
* Fri Jun 8 2001 Steve Williams <steve@icarus.com>
|
||||||
|
- added the /var/run/usb directory to spec file
|
||||||
|
|
||||||
|
* Tue Apr 24 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- added the hotplug.8 manpage written by Fumitoshi UKAI <ukai@debian.or.jp>
|
||||||
|
|
||||||
|
* Fri Mar 2 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- tweaked the post and preun sections to fix problem of hotplug
|
||||||
|
not starting automatically when the package is upgraded.
|
||||||
|
|
||||||
|
* Wed Feb 28 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- 2001_02_28 release
|
||||||
|
|
||||||
|
* Wed Feb 14 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- 2001_02_14 release
|
||||||
|
|
||||||
|
* Wed Jan 17 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- changed specfile based on Chmouel Boudjnah's <chmouel@mandrakesoft.com> comments.
|
||||||
|
|
||||||
|
* Tue Jan 16 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- tweaked the file locations due to the change in the tarball structure.
|
||||||
|
- 2001_01_16 release
|
||||||
|
|
||||||
|
* Mon Jan 15 2001 Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
- First cut at a spec file for the hotplug scripts.
|
||||||
|
- added patch to usb.rc to allow chkconfig to install and remove it.
|
||||||
|
|
||||||
+311
@@ -0,0 +1,311 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (c) 2001 Stephen Williams (steve@icarus.com)
|
||||||
|
* Copyright (c) 2001-2002 David Brownell (dbrownell@users.sourceforge.net)
|
||||||
|
* Copyright (c) 2008 Roger Williams (rawqux@users.sourceforge.net)
|
||||||
|
* Copyright (c) 2012 Steve Magnani (steve@digidescorp.com)
|
||||||
|
*
|
||||||
|
* This source code is free software; you can redistribute it
|
||||||
|
* and/or modify it in source code form under the terms of the GNU
|
||||||
|
* General Public License as published by the Free Software
|
||||||
|
* Foundation; either version 2 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, write to the Free Software
|
||||||
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
|
||||||
|
*/
|
||||||
|
#ident "$Id: main.c,v 1.10 2008/10/13 21:25:29 dbrownell Exp $"
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This program supports loading firmware into a target USB device
|
||||||
|
* that is discovered and referenced by the hotplug usb agent. It can
|
||||||
|
* also do other useful things, like set the permissions of the device
|
||||||
|
* and create a symbolic link for the benefit of applications that are
|
||||||
|
* looking for the device.
|
||||||
|
*
|
||||||
|
* -I <path> -- Download this firmware (intel hex)
|
||||||
|
* -t <type> -- uController type: an21, fx, fx2, fx2lp, fx3
|
||||||
|
* -s <path> -- use this second stage loader
|
||||||
|
* -c <byte> -- Download to EEPROM, with this config byte
|
||||||
|
*
|
||||||
|
* -L <path> -- Create a symbolic link to the device.
|
||||||
|
* -m <mode> -- Set the permissions on the device after download.
|
||||||
|
* -D <path> -- Use this device, instead of $DEVICE
|
||||||
|
*
|
||||||
|
* -V -- Print version ID for program
|
||||||
|
*
|
||||||
|
* This program is intended to be started by hotplug scripts in
|
||||||
|
* response to a device appearing on the bus. It therefore also
|
||||||
|
* expects these environment variables which are passed by hotplug to
|
||||||
|
* its sub-scripts:
|
||||||
|
*
|
||||||
|
* DEVICE=<path>
|
||||||
|
* This is the path to the device is /proc/bus/usb. It is the
|
||||||
|
* complete path to the device, that I can pass to open and
|
||||||
|
* manipulate as a USB device.
|
||||||
|
*/
|
||||||
|
|
||||||
|
# include <stdlib.h>
|
||||||
|
# include <stdio.h>
|
||||||
|
# include <getopt.h>
|
||||||
|
# include <string.h>
|
||||||
|
|
||||||
|
# include <sys/types.h>
|
||||||
|
# include <sys/stat.h>
|
||||||
|
# include <fcntl.h>
|
||||||
|
# include <unistd.h>
|
||||||
|
|
||||||
|
# include "ezusb.h"
|
||||||
|
|
||||||
|
#ifndef FXLOAD_VERSION
|
||||||
|
# define FXLOAD_VERSION (__DATE__ " (development)")
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#include <errno.h>
|
||||||
|
#include <syslog.h>
|
||||||
|
#include <stdarg.h>
|
||||||
|
|
||||||
|
|
||||||
|
static int dosyslog=0;
|
||||||
|
|
||||||
|
void logerror(const char *format, ...)
|
||||||
|
__attribute__ ((format (__printf__, 1, 2)));
|
||||||
|
|
||||||
|
void logerror(const char *format, ...)
|
||||||
|
{
|
||||||
|
va_list ap;
|
||||||
|
va_start(ap, format);
|
||||||
|
|
||||||
|
if(dosyslog)
|
||||||
|
vsyslog(LOG_ERR, format, ap);
|
||||||
|
else
|
||||||
|
vfprintf(stderr, format, ap);
|
||||||
|
va_end(ap);
|
||||||
|
}
|
||||||
|
|
||||||
|
int main(int argc, char*argv[])
|
||||||
|
{
|
||||||
|
const char *link_path = 0;
|
||||||
|
const char *ihex_path = 0;
|
||||||
|
const char *device_path = getenv("DEVICE");
|
||||||
|
const char *type = 0;
|
||||||
|
const char *stage1 = 0;
|
||||||
|
mode_t mode = 0;
|
||||||
|
int opt;
|
||||||
|
int config = -1;
|
||||||
|
|
||||||
|
while ((opt = getopt (argc, argv, "2vV?D:I:L:c:lm:s:t:")) != EOF)
|
||||||
|
switch (opt) {
|
||||||
|
|
||||||
|
case '2': // original version of "-t fx2"
|
||||||
|
type = "fx2";
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'D':
|
||||||
|
device_path = optarg;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'I':
|
||||||
|
ihex_path = optarg;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'L':
|
||||||
|
link_path = optarg;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'V':
|
||||||
|
puts (FXLOAD_VERSION);
|
||||||
|
return 0;
|
||||||
|
|
||||||
|
case 'c':
|
||||||
|
config = strtoul (optarg, 0, 0);
|
||||||
|
if (config < 0 || config > 255) {
|
||||||
|
logerror("illegal config byte: %s\n", optarg);
|
||||||
|
goto usage;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'l':
|
||||||
|
openlog(argv[0], LOG_CONS|LOG_NOWAIT|LOG_PERROR, LOG_USER);
|
||||||
|
dosyslog=1;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'm':
|
||||||
|
mode = strtoul(optarg,0,0);
|
||||||
|
mode &= 0777;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 's':
|
||||||
|
stage1 = optarg;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 't':
|
||||||
|
if (strcmp (optarg, "an21") // original AnchorChips parts
|
||||||
|
&& strcmp (optarg, "fx") // updated Cypress versions
|
||||||
|
&& strcmp (optarg, "fx2") // Cypress USB 2.0 versions
|
||||||
|
&& strcmp (optarg, "fx2lp") // updated FX2
|
||||||
|
&& strcmp (optarg, "fx3") // Cypress USB 3.0 versions
|
||||||
|
) {
|
||||||
|
logerror("illegal microcontroller type: %s\n", optarg);
|
||||||
|
goto usage;
|
||||||
|
}
|
||||||
|
type = optarg;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case 'v':
|
||||||
|
verbose++;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case '?':
|
||||||
|
default:
|
||||||
|
goto usage;
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
if (config >= 0) {
|
||||||
|
if (type == 0) {
|
||||||
|
logerror("must specify microcontroller type %s",
|
||||||
|
"to write EEPROM!\n");
|
||||||
|
goto usage;
|
||||||
|
}
|
||||||
|
if (!stage1 || !ihex_path) {
|
||||||
|
logerror("need 2nd stage loader and firmware %s",
|
||||||
|
"to write EEPROM!\n");
|
||||||
|
goto usage;
|
||||||
|
}
|
||||||
|
if (link_path || mode) {
|
||||||
|
logerror("links and modes not set up when writing EEPROM\n");
|
||||||
|
goto usage;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!device_path) {
|
||||||
|
logerror("no device specified!\n");
|
||||||
|
usage:
|
||||||
|
fputs ("usage: ", stderr);
|
||||||
|
fputs (argv [0], stderr);
|
||||||
|
fputs (" [-vV] [-l] [-t type] [-D devpath]\n", stderr);
|
||||||
|
fputs ("\t\t[-I firmware_hexfile] ", stderr);
|
||||||
|
fputs ("[-s loader] [-c config_byte]\n", stderr);
|
||||||
|
fputs ("\t\t[-L link] [-m mode]\n", stderr);
|
||||||
|
fputs ("... [-D devpath] overrides DEVICE= in env\n", stderr);
|
||||||
|
fputs ("... device types: one of an21, fx, fx2, fx2lp, fx3\n", stderr);
|
||||||
|
fputs ("... at least one of -I, -L, -m is required\n", stderr);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (ihex_path) {
|
||||||
|
int fd = open(device_path, O_RDWR);
|
||||||
|
int status;
|
||||||
|
|
||||||
|
if (fd == -1) {
|
||||||
|
logerror("%s : %s\n", strerror(errno), device_path);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (type == 0) {
|
||||||
|
type = "fx"; /* an21-compatible for most purposes */
|
||||||
|
}
|
||||||
|
|
||||||
|
if (verbose)
|
||||||
|
logerror("microcontroller type: %s\n", type);
|
||||||
|
|
||||||
|
if (stage1) {
|
||||||
|
/* first stage: put loader into internal memory */
|
||||||
|
if (verbose)
|
||||||
|
logerror("1st stage: load 2nd stage loader\n");
|
||||||
|
status = ezusb_load_ram (fd, stage1, type, 0);
|
||||||
|
if (status != 0)
|
||||||
|
return status;
|
||||||
|
|
||||||
|
/* second stage ... write either EEPROM, or RAM. */
|
||||||
|
if (config >= 0)
|
||||||
|
status = ezusb_load_eeprom (fd, ihex_path, type, config);
|
||||||
|
else
|
||||||
|
status = ezusb_load_ram (fd, ihex_path, type, 1);
|
||||||
|
if (status != 0)
|
||||||
|
return status;
|
||||||
|
} else {
|
||||||
|
/* single stage, put into internal memory */
|
||||||
|
if (verbose)
|
||||||
|
logerror("single stage: load on-chip memory\n");
|
||||||
|
status = ezusb_load_ram (fd, ihex_path, type, 0);
|
||||||
|
if (status != 0)
|
||||||
|
return status;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* some firmware won't renumerate, but typically it will.
|
||||||
|
* link and chmod only make sense without renumeration...
|
||||||
|
*/
|
||||||
|
}
|
||||||
|
|
||||||
|
if (link_path) {
|
||||||
|
int rc = unlink(link_path);
|
||||||
|
rc = symlink(device_path, link_path);
|
||||||
|
if (rc == -1) {
|
||||||
|
logerror("%s : %s\n", strerror(errno), link_path);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (mode != 0) {
|
||||||
|
int rc = chmod(device_path, mode);
|
||||||
|
if (rc == -1) {
|
||||||
|
logerror("%s : %s\n", strerror(errno), link_path);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!ihex_path && !link_path && !mode) {
|
||||||
|
logerror("missing request! (firmware, link, or mode)\n");
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* $Log: main.c,v $
|
||||||
|
* Revision 1.10 2008/10/13 21:25:29 dbrownell
|
||||||
|
* Whitespace fixes.
|
||||||
|
*
|
||||||
|
* Revision 1.9 2008/10/13 21:23:23 dbrownell
|
||||||
|
* From Roger Williams <roger@qux.com>: FX2LP support
|
||||||
|
*
|
||||||
|
* Revision 1.8 2005/01/11 03:58:02 dbrownell
|
||||||
|
* From Dirk Jagdmann <doj@cubic.org>: optionally output messages to
|
||||||
|
* syslog instead of stderr.
|
||||||
|
*
|
||||||
|
* Revision 1.7 2002/04/12 00:28:22 dbrownell
|
||||||
|
* support "-t an21" to program EEPROMs for those microcontrollers
|
||||||
|
*
|
||||||
|
* Revision 1.6 2002/04/02 05:26:15 dbrownell
|
||||||
|
* version display now noiseless (-V);
|
||||||
|
* '-?' (usage info) convention now explicit
|
||||||
|
*
|
||||||
|
* Revision 1.5 2002/02/26 20:10:28 dbrownell
|
||||||
|
* - "-s loader" option for 2nd stage loader
|
||||||
|
* - "-c byte" option to write EEPROM with 2nd stage
|
||||||
|
* - "-V" option to dump version code
|
||||||
|
*
|
||||||
|
* Revision 1.4 2002/01/17 14:19:28 dbrownell
|
||||||
|
* fix warnings
|
||||||
|
*
|
||||||
|
* Revision 1.3 2001/12/27 17:54:04 dbrownell
|
||||||
|
* forgot an important character :)
|
||||||
|
*
|
||||||
|
* Revision 1.2 2001/12/27 17:43:29 dbrownell
|
||||||
|
* fail on firmware download errors; add "-v" flag
|
||||||
|
*
|
||||||
|
* Revision 1.1 2001/06/12 00:00:50 stevewilliams
|
||||||
|
* Added the fxload program.
|
||||||
|
* Rework root makefile and hotplug.spec to install in prefix
|
||||||
|
* location without need of spec file for install.
|
||||||
|
*
|
||||||
|
*/
|
||||||
Reference in New Issue
Block a user