Skip to content

Commit e6c52e0

Browse files
abertschiabertschi
authored
Merge pull request #1 from hoseinyavarzadeh/patch-1
Enhance hardware.md with US links
2 parents b452104 + d8ee286 commit e6c52e0

1 file changed

Lines changed: 43 additions & 41 deletions

File tree

‎content/docs/guides/hardware.md‎

Lines changed: 43 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ seo:
1717
<style>
1818
.table-compact-col2 table td:nth-child(2),
1919
.table-compact-col2 table th:nth-child(2) {
20-
/* font-size: 0.82rem; /* smaller text in column 2 */
20+
/* font-size: 0.82rem; /* smaller text in column 2 */
2121
/* line-height: 1.2; */ */
2222
}
2323

@@ -35,7 +35,7 @@ seo:
3535

3636
>
3737
> _This page is still work in progress. Improve the site by [filing a pull request on GitHub.](https://github.com/opencca/opencca.github.io/blob/opencca/main/content/docs/guides/hardware.md)_
38-
> _Only Switzerland purchase links so far; please add international links (Amazon/AliExpress/etc.) via a PR._
38+
> _Switzerland and US purchase links are listed below; please add other international links via a PR._
3939
4040

4141
This page lists hardware for two common setups:
@@ -49,13 +49,13 @@ A small lab setup that supports remote UART access, automated flashing, and powe
4949
To get started with OpenCCA, you need the parts below.
5050
<div class="table-compact-col2 table-parts">
5151

52-
| Product | Link | Comment |
53-
| --- | --- | --- |
54-
| Radxa ROCK 5B (RK3588) | [AliExpress](https://de.aliexpress.com/item/1005007507141308.html) | Recommended: 16 GB RAM |
55-
| eMMC (16 GB+) <br /> Radxa eMMC | [AliExpress](https://de.aliexpress.com/item/1005007003959424.html) | The microSD slot is multiplexed with SWD, so eMMC is recommended. See: [Info on SD card](https://github.com/opencca/opencca-flash/issues/1) |
56-
| Power supply <br /> Anker Nano II 65W | [Amazon (DE)](https://www.amazon.de/dp/B094QKV6S8) | Not every USB-C power supply works reliably. See: [Radxa power supply discussion](https://wiki2.radxa.com/Rock5/5b/power_supply) |
57-
| USB to TTL adapter (3.3 V) | [AliExpress](https://de.aliexpress.com/item/32668866076.html?spm=a2g0o.order_list.order_list_main.203.60565c5fXlMcqC&gatewayAdapt=glo2deu) | A CH340G (3.3 V) (Baudrate 1.5 Mbps) See: [Connect to UART](/docs/reference/rk3588/connect-to-uart)|
58-
| USB-C cable| generic | Cable for power to RK3588 |
52+
| Product | Link | US Link | Comment |
53+
| --- | --- | --- | --- |
54+
| Radxa ROCK 5B (RK3588) | [AliExpress](https://de.aliexpress.com/item/1005007507141308.html) | [Amazon](https://a.co/d/71oIe5l) | Recommended: 16 GB RAM |
55+
| eMMC (16 GB+) <br /> Radxa eMMC | [AliExpress](https://de.aliexpress.com/item/1005007003959424.html) | [Amazon](https://a.co/d/c1uCrou) | The microSD slot is multiplexed with SWD, so eMMC is recommended. See: [Info on SD card](https://github.com/opencca/opencca-flash/issues/1) |
56+
| Power supply <br /> Anker Nano II 65W | [Amazon (DE)](https://www.amazon.de/dp/B094QKV6S8) | [Amazon](https://a.co/d/dtg3po5) | Not every USB-C power supply works reliably. See: [Radxa power supply discussion](https://wiki2.radxa.com/Rock5/5b/power_supply) |
57+
| USB to TTL adapter (3.3 V) | [AliExpress](https://de.aliexpress.com/item/32668866076.html?spm=a2g0o.order_list.order_list_main.203.60565c5fXlMcqC&gatewayAdapt=glo2deu) | [Amazon](https://a.co/d/bzAH2Bm) | A CH340G (3.3 V) (Baudrate 1.5 Mbps) See: [Connect to UART](/docs/reference/rk3588/connect-to-uart)|
58+
| USB-C cable| generic | [Amazon](https://a.co/d/9qni6GJ) | Cable for power to RK3588 |
5959

6060
</div>
6161

@@ -84,15 +84,15 @@ You find a docker container with all scripts for the management node in [opencca
8484

8585
<div class="table-compact-col2 table-parts">
8686

87-
| Product | Link | Comment |
88-
| --- | --- | --- |
89-
| Raspberry Pi 5 | [Digitec (CH)](https://www.digitec.ch/en/s1/product/raspberry-pi-new-5-8gb-development-boards-kits-38955607) | We recommend model 5. Install Raspberry Pi OS. |
90-
| Raspberry Pi Power Supply <br /> (27 W) | [Digitec (CH)](https://www.digitec.ch/en/s1/product/raspberry-pi-official-5-power-supply-27w-usb-c-development-board-accessories-39631602) | |
91-
| MicroSD card (for Raspberry Pi) | [Digitec (CH)](https://www.digitec.ch/en/s1/product/sandisk-ultra-a1-32-gb-microsdhc-u1-uhs-i-memory-card-14102757) | Storage for the Raspberry Pi. |
92-
| Ethernet switch | [Digitec (CH)](https://www.digitec.ch/en/s1/product/cudy-gs105d-network-switch-gigabit-ethernet-101001000-black-5-ports-network-switches-23907099) | Optional |
93-
| 2 short patch cables | [Digitec (CH)](https://www.digitec.ch/en/s1/product/value-utp-patch-cable-conf-cat-6-gray-05-m-uutp-cat6-050-m-network-cables-14200133) | Connect Pi + ROCK 5B to the switch. |
94-
| 1 longer patch cable | [Digitec (CH)](https://www.digitec.ch/en/s1/product/digitus-network-cable-uutp-cat6-2-m-network-cables-10255016) | Uplink to your network. |
95-
| USB-C -> USB-A adapter | [AliExpress](https://de.aliexpress.com/item/1005006596688387.html) | Connect USB-C dock to Pi USB-A port |
87+
| Product | Link | US Link | Comment |
88+
| --- | --- | --- | --- |
89+
| Raspberry Pi 5 | [Digitec (CH)](https://www.digitec.ch/en/s1/product/raspberry-pi-new-5-8gb-development-boards-kits-38955607) | [Amazon](https://a.co/d/hrj4x2w) | We recommend model 5. Install Raspberry Pi OS. |
90+
| Raspberry Pi Power Supply <br /> (27 W) | [Digitec (CH)](https://www.digitec.ch/en/s1/product/raspberry-pi-official-5-power-supply-27w-usb-c-development-board-accessories-39631602) | [Amazon](https://a.co/d/a7tRyPy) | |
91+
| MicroSD card (for Raspberry Pi) | [Digitec (CH)](https://www.digitec.ch/en/s1/product/sandisk-ultra-a1-32-gb-microsdhc-u1-uhs-i-memory-card-14102757) | [Amazon](https://a.co/d/7p2nYBE) | Storage for the Raspberry Pi. |
92+
| Ethernet switch | [Digitec (CH)](https://www.digitec.ch/en/s1/product/cudy-gs105d-network-switch-gigabit-ethernet-101001000-black-5-ports-network-switches-23907099) | [Amazon](https://a.co/d/jaDPUaA) | Optional |
93+
| 2 short patch cables | [Digitec (CH)](https://www.digitec.ch/en/s1/product/value-utp-patch-cable-conf-cat-6-gray-05-m-uutp-cat6-050-m-network-cables-14200133) | [Amazon](https://a.co/d/eHbjbSP) | Connect Pi + ROCK 5B to the switch. |
94+
| 1 longer patch cable | [Digitec (CH)](https://www.digitec.ch/en/s1/product/digitus-network-cable-uutp-cat6-2-m-network-cables-10255016) | [Amazon](https://a.co/d/alIhtaI) | Uplink to your network. |
95+
| USB-C -> USB-A adapter | [AliExpress](https://de.aliexpress.com/item/1005006596688387.html) | [Amazon](https://a.co/d/1cLrjoC) | Connect USB-C dock to Pi USB-A port |
9696
</div>
9797

9898
### USB-C Dock
@@ -101,10 +101,10 @@ Connect the USB-C dock to the Raspberry Pi. Connect the RK3588 to the dock as a
101101

102102
<div class="table-compact-col2 table-parts">
103103

104-
| Product | Link | Comment |
105-
| --- | --- | --- |
106-
| Anker PowerExpand 6-in-1 USB-C | [Amazon (DE)](https://www.amazon.de/dp/B08CKXNJZS) | The ROCK 5B multiplexes power + data on one USB-C port. A dock helps you power the board and flash firmware without cable juggling. See: [Radxa power supply discussion](https://wiki2.radxa.com/Rock5/5b/power_supply) |
107-
| USB-C cable | generic | Cable for power to RK3588 |
104+
| Product | Link | US Link | Comment |
105+
| --- | --- | --- | --- |
106+
| Anker PowerExpand 6-in-1 USB-C | [Amazon (DE)](https://www.amazon.de/dp/B08CKXNJZS) | [Amazon](https://a.co/d/7Bthnd5) | The ROCK 5B multiplexes power + data on one USB-C port. A dock helps you power the board and flash firmware without cable juggling. See: [Radxa power supply discussion](https://wiki2.radxa.com/Rock5/5b/power_supply) |
107+
| USB-C cable | generic | [Amazon](https://a.co/d/9qni6GJ) | Cable for power to RK3588 |
108108
</div>
109109

110110

@@ -122,11 +122,11 @@ With both power sources removed, the RK3588 performs a reliable hard reset.
122122

123123
<div class="table-compact-col2 table-parts">
124124

125-
| Product | Link | Comment |
126-
| --- | --- | --- |
127-
| Smart plug | [Athom (EU)](https://www.athom.tech/blank-1/EU-plug) | Remote power cycling for reflashing. Any smartplug will work that exposes HTTP API. We used Tasmota Firmware.|
125+
| Product | Link | US Link | Comment |
126+
| --- | --- | --- | --- |
127+
| Smart plug | [Athom (EU)](https://www.athom.tech/blank-1/EU-plug) | [Amazon](https://a.co/d/f09thut) | Remote power cycling for reflashing. Any smartplug will work that exposes HTTP API. We used Tasmota Firmware.|
128128

129-
</dvid>
129+
</div>
130130

131131

132132

@@ -138,22 +138,23 @@ Optional enclosure parts to house the setup, including a power strip and fans.
138138

139139
{{< img src="images/opencca1.png" class="hugo-image-500" width="100" alt="Optional Box Enclosure" >}}
140140

141+
<div class="table-compact-col2 table-parts">
141142

142-
| Product | Link | Comment |
143-
| --- | --- | --- |
144-
| Power strip | [Digitec (CH)](https://www.digitec.ch/en/s1/product/max-hauri-basic-line-5-x-type-13-5-m-socket-strips-14100119) | |
145-
| Plastic box | [Digitec (CH)](https://www.digitec.ch/en/s1/product/kis-w-375-x-25-x-23-cm-15-l-storage-boxes-13405854) | Optional enclosure. 37.5 x 25 x 23 cm, 15 l or larger. |
146-
| Step-up converter (optional) | [AliExpress](https://de.aliexpress.com/item/1005008374772473.html) | Optional, e.g. for quieter fan control. |
147-
| 12 V or 5 V fan (optional) | generic | Optional cooling. |
148-
| Glue, tape, wood or cardboard and rubber bands | generic | For assembly, [see pictures](https://github.com/opencca/opencca-box) |
143+
| Product | Link | US Link | Comment |
144+
| --- | --- | --- | --- |
145+
| Power strip | [Digitec (CH)](https://www.digitec.ch/en/s1/product/max-hauri-basic-line-5-x-type-13-5-m-socket-strips-14100119) | [Amazon](https://a.co/d/3ZCavI1) | |
146+
| Plastic box | [Digitec (CH)](https://www.digitec.ch/en/s1/product/kis-w-375-x-25-x-23-cm-15-l-storage-boxes-13405854) | Walmart/Target | Optional enclosure. 37.5 x 25 x 23 cm, 15 l or larger. |
147+
| Step-up converter (optional) | [AliExpress](https://de.aliexpress.com/item/1005008374772473.html) | - | Optional, e.g. for quieter fan control. |
148+
| 12 V or 5 V fan (optional) | generic | generic | Optional cooling. |
149+
| Glue, tape, wood or cardboard and rubber bands | generic | generic | For assembly, [see pictures](https://github.com/opencca/opencca-box) |
149150

150151
</div>
151152

152153
- [See 3D models](#3d-print-models)
153154

154155
### Maskrom MOSFET
155156

156-
The MOSFET circuit is not strictly necessary. You can flash the firmware manually by pressing the gphysical button on the SoC. However, if you plan to do this thousands of times (like we did during the initial bring up), it may be worth automating this. We soldered a simple circuit to the board to bypass the physical button, using a MOSFET as a programmable switch controlled via a Raspberry Pi GPIO pin.
157+
The MOSFET circuit is not strictly necessary. You can flash the firmware manually by pressing the physical button on the SoC. However, if you plan to do this thousands of times (like we did during the initial bring up), it may be worth automating this. We soldered a simple circuit to the board to bypass the physical button, using a MOSFET as a programmable switch controlled via a Raspberry Pi GPIO pin.
157158

158159
**Wiring (example GPIO17):**
159160
- GPIO17 → **220Ω** → MOSFET **Gate (G)**
@@ -163,12 +164,14 @@ The MOSFET circuit is not strictly necessary. You can flash the firmware manuall
163164

164165
<div class="table-compact-col2 table-parts">
165166

166-
| Product | Link | Comment |
167-
| --- | --- | --- |
168-
| Circuit board | [AliExpress](https://de.aliexpress.com/item/1005007204340724.html?spm=a2g0o.order_list.order_list_main.58.3e151802BGaqce&gatewayAdapt=glo2deu) | For a Maskrom automation circuit. |
169-
| MOSFET IRLZ44N | [AliExpress](https://de.aliexpress.com/item/1005007084578589.html?spm=a2g0o.order_list.order_list_main.365.5db418020aPOaU&gatewayAdapt=glo2deu) | |
170-
| 10kΩ resistor + 220Ω resistor | | |
171-
| Cables | [AliExpress](https://de.aliexpress.com/item/1005003252824475.html?spm=a2g0o.order_list.order_list_main.113.3e151802BGaqce&gatewayAdapt=glo2deu) |
167+
| Product | Link | US Purchase Link | Comment |
168+
| --- | --- | --- | --- |
169+
| Circuit board | [AliExpress](https://de.aliexpress.com/item/1005007204340724.html?spm=a2g0o.order_list.order_list_main.58.3e151802BGaqce&gatewayAdapt=glo2deu) | [Amazon](https://a.co/d/ciaqs2W) | For a Maskrom automation circuit. |
170+
| Soldering Toolkit | - | [Amazon](https://a.co/d/hAcUCru) | Recommended for assembly. |
171+
| MOSFET IRLZ44N | [AliExpress](https://de.aliexpress.com/item/1005007084578589.html?spm=a2g0o.order_list.order_list_main.365.5db418020aPOaU&gatewayAdapt=glo2deu) | [Amazon](https://a.co/d/9UDknNw) | |
172+
| 10kΩ resistor + 220Ω resistor | - | [Amazon](https://a.co/d/egUQ9CD) | |
173+
| Cables | [AliExpress](https://de.aliexpress.com/item/1005003252824475.html?spm=a2g0o.order_list.order_list_main.113.3e151802BGaqce&gatewayAdapt=glo2deu) | [Amazon](https://a.co/d/iTy9K27) | Breadboard jumpers. |
174+
| LED | - | [Amazon](https://a.co/d/2z4iQa8) | Optional status indicator. |
172175

173176
- See scripts in [opencca-flash/board/maskrom](https://github.com/opencca/opencca-flash/tree/opencca/main/board/maskrom)
174177
- [Entering Maskrom Mode (Radxa)](https://docs.radxa.com/en/rock5/rock5b/low-level-dev/install-os/rkdevtool_maskrom)
@@ -180,4 +183,3 @@ The MOSFET circuit is not strictly necessary. You can flash the firmware manuall
180183
You find instructions on how to obtain and print the 3D models in the
181184
[opencca-box](https://github.com/opencca/opencca-box) repository.
182185

183-

0 commit comments

Comments
 (0)