Skip to content

Single generic testing stand setup guide #753

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Mar 4, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/images/bad_cable.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/cable_connectors.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/flash_chip.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/flash_headers.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/good_cable.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/pomona_clip_with_cables.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/pomona_clip_with_rte.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/rte-rpi-testing.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/rte-rpi.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/vp46xx_location_of_CMOS_header.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/vp46xx_location_of_flash_chip.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 3 additions & 17 deletions docs/transparent-validation/msi-z690/laboratory-assembly-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@

## Introduction

This document describes the assembly procedure dedicated to the MSI PRO Z690-A
testing stand.
This document describes platform-specific details for assembling an MSI PRO
Z690-A testing stand. Use this document as reference while going through
[Generic Testing Stand Setup](../../unified-test-documentation/generic-testing-stand-setup.md)

## Prerequisites

Expand All @@ -18,27 +19,12 @@ create the testing stand.
* USB-UART converter with 4-wire cable
* 4-pin header 2.54 mm raster

## Pre-setup activities

The following subsections describe the method of preparing all the
components of the laboratory stand.

### MSI PRO Z690-A

MSI PRO Z690-A platform should be prepared in accordance with the
[Motherboard assembly](presale-assembly-and-validation.md#motherboard-assembly-only)
documentation.

### RTE

RTE (acronym: Remote Testing Environment) should be prepared in accordance with
[Quick start guide](../rte/v1.1.0/quick-start-guide.md) documentation dedicated
to the device.

### Sonoff

Prepare Sonoff according to [Sonoff preparation instructions](../sonoff/sonoff_preparation.md)

## Connections

The following sections describe how to enable all of the following features:
Expand Down
15 changes: 0 additions & 15 deletions docs/transparent-validation/msi-z790/laboratory-assembly-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,27 +18,12 @@ create the testing stand.
* USB-UART converter with 4-wire cable
* 4-pin header 2.54 mm raster

## Pre-setup activities

The following subsections describe the method of preparing all the
components of the laboratory stand.

### MSI PRO Z790-P

MSI PRO Z790-P platform should be prepared in accordance with the
[Motherboard assembly](../msi-z690/presale-assembly-and-validation.md#motherboard-assembly-only)
documentation.

### RTE

RTE (acronym: Remote Testing Environment) should be prepared in accordance with
[Quick start guide](../rte/v1.1.0/quick-start-guide.md) documentation dedicated
to the device.

### Sonoff

Prepare Sonoff according to [Sonoff preparation instructions](../sonoff/sonoff_preparation.md)

## Connections

The following sections describe how to enable all of the following features:
Expand Down
2 changes: 1 addition & 1 deletion docs/transparent-validation/muxpi/basic-validation.md
Original file line number Diff line number Diff line change
Expand Up @@ -250,4 +250,4 @@ Minicom quick guide:

---

_Images source: [Wiki Tizen](https://wiki.tizen.org/MuxPi)_
_Images source: [Wiki Tizen](http://web.archive.org/web/20230702190152/https://wiki.tizen.org/MuxPi)_
4 changes: 2 additions & 2 deletions docs/transparent-validation/muxpi/theory-of-operations.md
Original file line number Diff line number Diff line change
Expand Up @@ -565,10 +565,10 @@ uart --- Get current value of UART voltage or set if new value is given [in mill

---

_Images source: [Wiki Tizen](https://wiki.tizen.org/MuxPi)_
_Images source: [Wiki Tizen](http://web.archive.org/web/20230702190152/https://wiki.tizen.org/MuxPi)_

[nanopi-image]: https://cloud.3mdeb.com/index.php/s/MENgScifExeeo6P/download
[nanopi-image2]: https://cloud.3mdeb.com/index.php/s/n42rLcAQ5cWcxgW/download
[cortex-binary]: https://cloud.3mdeb.com/index.php/s/adnEZLgo2diXkdw/download
[etcher]: https://www.balena.io/etcher/
[usb-m]: https://wiki.tizen.org/MuxPi#USB-M
[usb-m]: http://web.archive.org/web/20230702190152/https://wiki.tizen.org/MuxPi#USB-M
146 changes: 6 additions & 140 deletions docs/transparent-validation/protectli/laboratory-assembly-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,15 @@

## Introduction

This document describes the assembly procedure dedicated to the Protectli
platforms (VP2410, VP2420, VP4630/VP4650/VP4670, V1210/V1410/V1610) testing
stand.
This document describes platform-specific details for assembling Protectli
VP2410, VP2420, VP4630/VP4650/VP4670, V1210/V1410/V1610 testing stands.
Use this document as reference while going through
[Generic Testing Stand Setup](../../unified-test-documentation/generic-testing-stand-setup.md)

## Prerequisites

The below table contains information about all elements which are needed to
create the testing stand.
The below table contains platform-specific information about all elements which
are needed to create testing stands for Protectli machines.

* [RTE v1.1.0](https://shop.3mdeb.com/shop/open-source-hardware/open-source-hardware-3mdeb/rte/)
* RTE power supply 5V 2A Micro-USB
Expand Down Expand Up @@ -47,131 +48,6 @@ create the testing stand.
* Power supply for the platform: 12V 4A
* USB-C to USB-A male-male cable for console

## Pre-setup activities

The following subsections describe the method of preparing all the
components of the laboratory stand.

### Platform

The bottom cover has to be removed to connect wires and clips to the platform.

### RTE

RTE (acronym: Remote Testing Environment) should be prepared in accordance with
[Quick start guide](../rte/v1.1.0/quick-start-guide.md) documentation dedicated
to the device.

### Sonoff

Prepare Sonoff according to [Sonoff preparation
instructions](../sonoff/sonoff_preparation.md) for platforms that require
Sonoff for power control (see [Prerequisites](#prerequisites)).

## Connections

The following sections describe how to enable all of the following features:

* serial connection to the platform,
* controlling power supply,
* enabling basic power actions with the platform (power off/power on/reset),
* external flashing with the RTE,
* CMOS reset circuit.

### Serial connection

Depending on platform connect the USB-C or MicroUSB to the platform console
port and the USB-A end to one of the RTE USB-A ports.

### Power supply controlling

=== "VP2410"

Connect 12V power supply to RTE J13 connector, then RTE J12 connector to
DC connector. Do not use any DC jack adapters as these seem to introduce
power losses and noises, making the power connection unstable.

Picture of the improper cable:

![](images/bad_cable.jpg)

Picture of the proper cable:

![](images/good_cable.jpg)

One has to solder the good cable with the half of bad cable to form a full
cable. Cut the bad cable in half and strip the isolation. Take the red wire
and solder it to the proper cables' white striped wire, this is the hot
wire with positive voltage. Isolate the connection with a tape. Take the
second black wire from the improper cable and solder it to the unstriped
wire of the proper cable. Use tape to isolate and strengthen the whole
connection. The cable is ready. Be sure to use plugs in the following way:

![](images/cable_connectors.jpg)

=== "VP2420"

Connect 12V power supply to RTE J13 connector, then RTE J12 connector to
DC connector. Do not use any DC jack adapters as these seem to introduce
power losses and noises, making the power connection unstable.

Picture of the improper cable:

![](images/bad_cable.jpg)

Picture of the proper cable:

![](images/good_cable.jpg)

One has to solder the good cable with the half of bad cable to form a full
cable. Cut the bad cable in half and strip the isolation. Take the red wire
and solder it to the proper cables' white striped wire, this is the hot
wire with positive voltage. Isolate the connection with a tape. Take the
second black wire from the improper cable and solder it to the unstriped
wire of the proper cable. Use tape to isolate and strengthen the whole
connection. The cable is ready. Be sure to use plugs in the following way:

![](images/cable_connectors.jpg)

=== "VP4630/VP4650/VP4670"

Connect platform power supply EU plug to Sonoff.

=== "V1210/V1410/V1610"

Connect 12V power supply to RTE J13 connector, then RTE J12 connector to
DC connector. Do not use any DC jack adapters as these seem to introduce
power losses and noises, making the power connection unstable.

Picture of the improper cable:

![](images/bad_cable.jpg)

Picture of the proper cable:

![](images/good_cable.jpg)

One has to solder the good cable with the half of bad cable to form a full
cable. Cut the bad cable in half and strip the isolation. Take the red wire
and solder it to the proper cables' white striped wire, this is the hot
wire with positive voltage. Isolate the connection with a tape. Take the
second black wire from the improper cable and solder it to the unstriped
wire of the proper cable. Use tape to isolate and strengthen the whole
connection. The cable is ready. Be sure to use plugs in the following way:

![](images/cable_connectors.jpg)

### Basic power operations enabling

Connect the RTE J11 header to the platform FP1/F_PANEL1 header using 2.54mm to
2mm wires as described in the table:

| RTE | Protectli |
|:---------:|:-----------------------------:|
| J11 pin 5 | FP1/F_PANEL1 pin 6 (PWR_ON#) |
| J11 pin 6 | FP1/F_PANEL1 pin 7 (RST#) |
| J15 pin 1 | FP1/F_PANEL1 pin 9 (GND) |

### External flashing enabling

=== "VP2410"
Expand Down Expand Up @@ -254,16 +130,6 @@ Connect the RTE J11 header to the platform FP1/F_PANEL1 header using 2.54mm to

Resetting CMOS is required for proper external flashing.

### Complete Setup

After preparing all of the connections also three activities should be
performed to enable all of the test stand features:

1. Connect Sonoff to the mains (VP4630/VP4650/VP4670 only). For other
platforms, connect the platform power supply to the mains.
2. Connect the RTE to the Internet by using the Ethernet cable.
3. Connect the RTE to the mains by using the microUSB 5 V/2 A power supply.

## Theory of operation

The following sections describe how to use all of the enabled features:
Expand Down
2 changes: 1 addition & 1 deletion docs/transparent-validation/sd-wire/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ remote DSLR camera.
For additional details please refer to the official documentation:

* [Dasharo Universe](https://docs.dasharo.com/transparent-validation/sd-wire/getting-started/)
* [Tizen Wiki](https://wiki.tizen.org/SDWire)
* [Tizen Wiki](http://web.archive.org/web/20240121081917/https://wiki.tizen.org/SDWire)

These resources will provide you with comprehensive guidance on how to make the
most of the product for your specific needs.
Expand Down
8 changes: 5 additions & 3 deletions docs/transparent-validation/sd-wire/specification.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Hardware design

Design of this board is based on [SD MUX](https://wiki.tizen.org/SD_MUX). SDWire
Design of this board is based on
[SD MUX](http://web.archive.org/web/20220812002642/https://wiki.tizen.org/SD_MUX)
. SDWire
does not have power switch or USB switch but has built in USB SD card reader. SD
card multiplexer itself is exactly the same in both devices.

Expand All @@ -20,7 +22,7 @@ LED positions are showed in the image below.

![](./../../images/SD-wire_leds.jpg)

<center>Source: [wiki.tizen.org](https://wiki.tizen.org/File:SDWire-leds.png)</center>
<center>Source: [wiki.tizen.org](http://web.archive.org/web/20210831025540/https://wiki.tizen.org/File:SDWire-leds.png)</center>

## PCB elements and scheme

Expand All @@ -30,4 +32,4 @@ LED positions are showed in the image below.

![](./../../images/SD-wire_scheme-1.png)

<center>Source: [wiki.tizen.org](https://wiki.tizen.org/images/c/cb/SDWire-v1.4-sch.pdf)</center>
<center>Source: [wiki.tizen.org](http://web.archive.org/web/20210831025540/https://wiki.tizen.org/images/c/cb/SDWire-v1.4-sch.pdf)</center>
2 changes: 1 addition & 1 deletion docs/transparent-validation/sd-wire/usage-validation.md
Original file line number Diff line number Diff line change
Expand Up @@ -276,7 +276,7 @@ Using SDWire there is no need to disconnect SD card from DUT.

References & Projects:

* [https://wiki.tizen.org/SDWire](https://wiki.tizen.org/SDWire)
* [Tizen Wiki](http://web.archive.org/web/20240121081917/https://wiki.tizen.org/SDWire)
* [Ethernet camera module build – Automated flashing](https://www.kurokesu.com/main/2022/08/02/ethernet-camera-module-build-log-5-automated-flashing/)
* [SD Wire & 3d Printer Usage](https://github.com/arekm/OctoPrint-Sdwire)

Expand Down
Loading