[prev in list] [next in list] [prev in thread] [next in thread]
List: flashrom
Subject: [flashrom] Re: Release preparations
From: Martin L Roth <gaumless () gmail ! com>
Date: 2022-03-16 19:38:36
Message-ID: CA+e+Ov7LmC5gQatj8mBL=A+eRQTk9eWgHLMgU7Fvc71J4WeqCw () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
On Sun, Mar 13, 2022 at 9:49 AM Nico Huber <nico.h@gmx.de> wrote:
> On 13.03.22 08:28, Anastasia Klimchuk wrote:
>
...
> >> ad08aef6 Undocumented programmer. disable? drop from realease branch?
> >
> > I looked that is about raiden debug programmer. If it is undocumented,
> can
> > we document?
>
> Hopefully. IMO, the minimum for a new programmer to be accepted upstream
> is a section in the manpage, including documentation about programmer
> parameters. With such documentation at hand, we could even start to re-
> view the code ;)
>
> I had a look at the comment on top of `raiden_debug_spi.c` right now.
> I knew it was attached over USB, but it seems that the other end goes
> directly to the target device (not any kind of dongle between two
> computers). If that is the case, it would be important to know what
> Chromebook (I guess) models support it.
The raiden driver works with a number of different ChromeOS debug methods,
not just chromebooks directly:
1) ChromeOS devices that support case closed debug (CCD) using the
SuzyQable.
- Make your own: https://www.youtube.com/watch?v=WGsyXlgSxFk
- Was sold by sparkfun, but due to the chip shortages, it's out of stock.
2) ChromeOS devices that support CCD, using the Servo-V4 device.
- This device and the two below are only available from google, because we
haven't found a reseller that will partner with us to manufacture and
sell it.
- Both of these are documented on the CCD page at chromium.org:
https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/ccd.md
3) New ChromeOS devices that use the C2D2 debugger & 8-pin connector.
- Somewhat documented at chromum.org:
https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/using_em100_with_c2d2.md
4) Old ChromeoOS devices that use the older style servo connector, debugged
with the uServo debugger.
- Documented at chromium.org:
https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/servo_micro.md
The raiden driver is actually just a basic USB to serial driver that
expects the Google UBS VIDs & DIDs. The flashrom interface
sets up the packets in the way that the debugger on the other end
of the device expects.
As Nico mentioned, there's good documentation in the flashrom code
already, and the entire rest of the interface is in the ChromeOS EC
codebase, so it shouldn't be difficult to get the documentation done.
I can work on that unless someone else wants the task.
Martin
[Attachment #5 (text/html)]
<div dir="ltr"><div dir="ltr"></div><br><div class="gmail_quote"><div dir="ltr" \
class="gmail_attr">On Sun, Mar 13, 2022 at 9:49 AM Nico Huber <<a \
href="mailto:nico.h@gmx.de">nico.h@gmx.de</a>> wrote:<br></div><blockquote \
class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid \
rgb(204,204,204);padding-left:1ex">On 13.03.22 08:28, Anastasia Klimchuk \
wrote:<br></blockquote><div>... </div><blockquote class="gmail_quote" \
style="margin:0px 0px 0px 0.8ex;border-left:1px solid \
rgb(204,204,204);padding-left:1ex"> >> ad08aef6 Undocumented programmer. \
disable? drop from realease branch?<br> ><br>
> I looked that is about raiden debug programmer. If it is undocumented, can<br>
> we document?<br>
<br>
Hopefully. IMO, the minimum for a new programmer to be accepted upstream<br>
is a section in the manpage, including documentation about programmer<br>
parameters. With such documentation at hand, we could even start to re-<br>
view the code ;)<br>
<br>
I had a look at the comment on top of `raiden_debug_spi.c` right now.<br>
I knew it was attached over USB, but it seems that the other end goes<br>
directly to the target device (not any kind of dongle between two<br>
computers). If that is the case, it would be important to know what<br>
Chromebook (I guess) models support it.</blockquote><div><br></div><div>The raiden \
driver works with a number of different ChromeOS debug methods,</div><div> not just \
chromebooks directly:</div><div>1) ChromeOS devices that support case closed debug \
(CCD) using the SuzyQable.</div><div> - Make your own: <a \
href="https://www.youtube.com/watch?v=WGsyXlgSxFk">https://www.youtube.com/watch?v=WGsyXlgSxFk</a></div><div> \
- Was sold by sparkfun, but due to the chip shortages, it's out of \
stock.</div><div><br></div><div>2) ChromeOS devices that support CCD, using the \
Servo-V4 device.</div><div> - This device and the two below are only available from \
google, because we</div><div> haven't found a reseller that will partner \
with us to manufacture and sell it.</div><div> - Both of these are documented on the \
CCD page at <a href="http://chromium.org">chromium.org</a>:</div><div> <a \
href="https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/cc \
d.md">https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/ccd.md</a></div><div><br></div><div>3) \
New ChromeOS devices that use the C2D2 debugger & 8-pin connector.<br></div><div> \
- Somewhat documented at <a href="http://chromum.org">chromum.org</a>:</div><div> \
<a href="https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs \
/using_em100_with_c2d2.md">https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/using_em100_with_c2d2.md</a></div><div><br></div><div>4) \
Old ChromeoOS devices that use the older style servo connector, \
debugged</div><div>with the uServo debugger.</div><div> - Documented at <a \
href="http://chromium.org">chromium.org</a>:</div><div> <a \
href="https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/se \
rvo_micro.md">https://chromium.googlesource.com/chromiumos/third_party/hdctools/+/HEAD/docs/servo_micro.md</a></div><div><br></div><div>The \
raiden driver is actually just a basic USB to serial driver that</div><div>expects \
the Google UBS VIDs & DIDs. The flashrom interface</div><div>sets up the \
packets in the way that the debugger on the other end</div><div>of the device \
expects.<br></div><div><br></div><div>As Nico mentioned, there's good \
documentation in the flashrom code</div><div>already, and the entire rest of the \
interface is in the ChromeOS EC</div><div>codebase, so it shouldn't be difficult \
to get the documentation done.</div><div><br></div><div>I can work on that unless \
someone else wants the task.</div><div><br></div><div>Martin</div></div></div>
_______________________________________________
flashrom mailing list -- flashrom@flashrom.org
To unsubscribe send an email to flashrom-leave@flashrom.org
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic