annotate doc/Sniffing-hw-setup @ 52:cbfcc480d61b

fpga build: migrate to yosys-tee wrapper
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 03 Oct 2023 18:17:58 +0000
parents 8a3003860cf8
children 95ed46b5f8f1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
48
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
1 The hardware setup for SIM interface sniffing with FC SIMsniff consists of the
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
2 following components:
36
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 * The same SIMtrace FPC cables (going from a SIM socket to the 6-pin FPC
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 connector) that were originally developed for SIMtrace1/2 and are sold by
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 Sysmocom;
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 * An off-the-shelf Lattice Icestick FPGA board (sold by Digi-Key, for example)
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 that has been outfitted with header pins: the board ships with empty PTHs
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 (plated through holes) at J1, hence a small soldering job is required to
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 populate this header;
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 * Some in-between components described below.
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 For the in-between components of the last bullet point above, there are 3
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 possibilities, each described in its own section below.
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 HW setup version 0
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 ==================
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 (works today)
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 The piece between the SIMtrace FPC cable from Sysmocom and the Icestick FPGA
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 board is the "SIMtrace FPC passive connection" adapter (design files in
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 boards/sim-fpc-pasv directory) from the fall of 2022. The electrical connection
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 from the ME/ID SIM socket to the physical SIM is direct and physically
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 continuous (no switches, no Heisenbugs), and a trio of FPGA I/O pins (configured
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 as inputs) are connected directly to this SIM bus with jumper wires.
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 This hw setup is intended only as a very temporary prototype until we get hw
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 setup version 1 described below. The present hw setup version 0 works ONLY if
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 the ME/ID operates with class B voltage levels: if you try class A (5V), you'll
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 instantly damage the FPGA by grossly exceeding its Absolute Maximum Ratings
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 (don't do it!), and if you try class C (1.8V), the high level will fall right
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 between Vil_max and Vih_min, causing the FPGA to receive garbage. However, this
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 otherwise-unusable hw setup was good enough to prove the FPGA logic working,
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 using an FCDEV3B as the ME/ID, manually forced into class B operation.
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 HW setup version 1
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 ==================
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 (coming very soon)
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 Compared to hw setup version 0, one extra component is added between the
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 sim-fpc-pasv adapter and the Icestick board: another little adapter board called
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 "SIMtrace-ice multivolt sniffer", design files in boards/mv-sniffer directory.
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 The only active component on the mv-sniffer board is a Nexperia 74LVC4T3144 dual
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 supply logic voltage level translator IC, powered from SIM_VCC on its A side
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 and from Icestick board +3.3V rail on its B side.
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50
48
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
51 The mv-sniffer PCB has been fabricated and received at FreeCalypso HQ, but we
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
52 still need to get it assembled, which will require at least one trip to
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
53 Technotronix, or maybe even two trips. Once we have this board assembled, we
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
54 should have a working SIM sniffing path that is fully compatible with all 3
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
55 voltage classes, per the original intent of FC SIMsniff project.
36
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56
51
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
57 Wire assignments for this HW setup
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
58 ----------------------------------
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
59
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
60 A 6-wire ribbon cable, cut from a standard multicolor ribbon cable spool and
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
61 outfitted with custom crimped connectors, will be used to make the connection
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
62 between sim-fpc-pasv and mv-sniffer boards. Wire color assignments in this
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
63 ad hoc connection cable are:
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
64
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
65 Wire SIM interface pin
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
66 ---------------------------------
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
67 brown VCC
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
68 red RST
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
69 orange CLK
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
70 yellow GND
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
71 green GND
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
72 blue I/O
8a3003860cf8 doc/Sniffing-hw-setup: wire assignments for mv-sniffer setup
Mychaela Falconia <falcon@freecalypso.org>
parents: 48
diff changeset
73
36
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
74 HW setup version 2
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
75 ==================
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
76
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
77 (a little more distant, but will be needed before wider spread)
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
78
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79 The solution with separate sim-fpc-pasv and mv-sniffer boards is expected to be
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 quite inconvenient because of the number of pieces required - clutter on the lab
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81 bench - plus poor electrical design with jumper wires between the two boards
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
82 extending the electrical length of the SIM bus before the LVC buffer. In the
48
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
83 fully polished version of FC SIMsniff, these two adapter boards will need to be
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
84 combined into one. The final FreeCalypso SIMsniff pod is expected to be a
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
85 single board (still very simple and low cost) featuring the following
1068f9fd41d5 doc: project rename
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
86 components:
36
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
87
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
88 1) SIMtrace FPC connector
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89 2) SIM socket
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
90 3) 74LVC4T3144 buffer IC
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91 4) SIM bus solidly connected between components 1, 2 and 3
f1c3dd2173d3 doc/Sniffing-hw-setup: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
92 5) A header for FPGA board connection, wired to the 'B' side of component 3