Skip to content

Commit

Permalink
Figure shortcode in preparation for md convert
Browse files Browse the repository at this point in the history
  • Loading branch information
@x1y
x1y committed Oct 9, 2024
1 parent 33f3c7a commit 1d6b9c7
Show file tree
Hide file tree
Showing 148 changed files with 522 additions and 520 deletions.
4 changes: 2 additions & 2 deletions content/documentation/Accessories/Cases/Model_A_Acrylic_Open_Enclosure.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ menu:

The *"Model A" Acrylic Open Enclosure* is a case for "Model A" sized single-board computers (Pine A64, ROCKPro64, Quartz64 Model A) sold by PINE64, available from https://pine64.com/product/pine-a64-rockpro64-acrylic-open-enclosure/[the official store].

image:/documentation/images/Model_a_acrylic_case_with_pine_a64.jpg[A Pine A64 mounted in the "Model A" Acrylic Open Enclosure. The text on the top is "PINE64" nowadays.,title="A Pine A64 mounted in the "Model A" Acrylic Open Enclosure. The text on the top is "PINE64" nowadays."]
{{< figure src="/documentation/images/Model_a_acrylic_case_with_pine_a64.jpg" title="A Pine A64 mounted in the &quot;Model A&quot; Acrylic Open Enclosure. The text on the top is &quot;PINE64&quot; nowadays." >}}

== Installation

Expand All @@ -23,7 +23,7 @@ For the Quartz64 Model A, you may need to file down the inner corner of one of t

=== 3D-Printable Top With Fan and PCIe Cutout

image:/documentation/images/Model_a_top_render.png[Non-artist's impression of the replacement top plate,title="Non-artist's impression of the replacement top plate"]
{{< figure src="/documentation/images/Model_a_top_render.png" title="Non-artist's impression of the replacement top plate" >}}

User:CounterPillow has created an alternate 3D-printable top plate which allows for the mounting of a 40mmx40mmx10mm fan, as well as allowing for PCIe cards to be mounted while the case is assembled. The STL and STEP files are available under https://wiki.pine64.org/wiki/File:Model_A_acrylic_case_top_plate_with_fan_cutout.zip[] free of charge, licensed as CC-BY 4.0.

Expand Down
8 changes: 4 additions & 4 deletions content/documentation/Accessories/Cases/Model_B_Acrylic_Open_Enclosure.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ menu:

The *"Model B" Acrylic Open Enclosure* is a case for "Model B" sized single-board computers sold by PINE64, available from https://pine64.com/product/model-b-acrylic-open-enclosure/[the official store].

image:/documentation/ROCK64/images/ROCK64_acrylic_open_enclosure.jpg[A_ROCK64_mounted_in_the_case,_the_correct_way.,title="A_ROCK64_mounted_in_the_case,_the correct way."]
{{< figure src="/documentation/ROCK64/images/ROCK64_acrylic_open_enclosure.jpg" title="A_ROCK64_mounted_in_the_case,_the_correct_way." >}}

== Installation

Expand All @@ -21,8 +21,8 @@ To install the SBC inside the case, stick the long screws into the SBC mounting

=== 3D-Printable Top With Fan Cutout

image:/documentation/images/Model_b_open_enclosure_top_cad.png[Top_view_of_the_plate,title="Top_view_of_the_plate"]
image:/documentation/images/Model_B_Open_Enclosure_Top_Fan_Mount.jpeg[The assembled modified case with a Noctua NF-A4x10 5V PWM mounted to it. The SBC is mounted in the enclosure upside-down.,title="The assembled modified case with a Noctua NF-A4x10 5V PWM mounted to it. The SBC is mounted in the enclosure upside-down."]
{{< figure src="/documentation/images/Model_b_open_enclosure_top_cad.png" title="Top_view_of_the_plate" >}}
{{< figure src="/documentation/images/Model_B_Open_Enclosure_Top_Fan_Mount.jpeg" title="The assembled modified case with a Noctua NF-A4x10 5V PWM mounted to it. The SBC is mounted in the enclosure upside-down." >}}

User:CounterPillow has created an alternate 3D-printable top plate which allows for the mounting of a 40mmx40mmx10mm fan. The STL and STEP files are available free of charge under https://wiki.pine64.org/wiki/File:Model_B_acrylic_case_top_plate_with_fan_cutout.zip[], licensed as CC-BY 4.0.

Expand All @@ -34,7 +34,7 @@ The print will take approximately 7.8 metres of filament, and take in the order

The cooling performance with a Noctua NF-A4x10 5V PWM is enough to no longer throttle after a few minutes of cpuburn, but comfortably sitting at below 75°C instead. The memory has no temperature sensor, but will likely be cooled quite a bit as well.

image:/documentation/images/Arduino_pwm_thing.png[Rough wiring diagram of how to PWM control the fan from a ROCK64 with a helper Arduino,title="Rough wiring diagram of how to PWM control the fan from a ROCK64 with a helper Arduino"]
{{< figure src="/documentation/images/Arduino_pwm_thing.png" title="Rough wiring diagram of how to PWM control the fan from a ROCK64 with a helper Arduino" >}}

Since the link:/documentation/ROCK64[ROCK64] has no PWM pins available to control the fan, a slight workaround can be done; with the `gpio-fan` device tree binding, an Arduino can be controlled to soft-PWM a suitable 25 kHz signal for the fan. The ROCK64 uses 3.3V on the GPIO pins, so you'll need to logic level convert it to 5V if you're using a 5V Arduino, and if you're using a 3.3V microcontroller, you'll need to logic level shift the output PWM signal as the 5V fan will be expecting 5V PWM on the PWM pin.

Expand Down
26 changes: 14 additions & 12 deletions content/documentation/Accessories/Cases/NASCase.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,11 @@ The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or D

An exploded view of the NAS Case, illustrating how all the components come together, can be found http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf[here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.

image:/documentation/images/NASCaseMain.png[Front View of the PINE64 NAS Case for the ROCKPro64,title="Front View of the PINE64 NAS Case for the ROCKPro64",width=400]
{{< figure src="/documentation/images/NASCaseMain.png" title="Front View of the PINE64 NAS Case for the ROCKPro64" width="400" >}}

== What does the NAS Case house?

image:/documentation/images/NAS_Case_internals.jpg[Internal Layout of the NAS Case,title="Internal Layout of the NAS Case",width=200]
{{< figure src="/documentation/images/NAS_Case_internals.jpg" title="Internal Layout of the NAS Case" width="200" >}}

The NAS Case can house the following components:

Expand All @@ -38,7 +38,9 @@ When you purchase the NAS Case from the PINE store the following items are shipp

== What other bare-minimum things do I need for a NAS build?

image:/documentation/images/PCIetoSATA.png[You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your ROCKPro64 board. \https://forum.pine64.org/showthread.php?tid=6932. WARNING: this adapter does not work well with two HDDs, https://forum.pine64.org/showthread.php?tid=6511,width=200]
You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your ROCKPro64 board. \https://forum.pine64.org/showthread.php?tid=6932. WARNING: this adapter does not work well with two HDDs, see https://forum.pine64.org/showthread.php?tid=6511:

{{< figure src="/documentation/images/PCIetoSATA.png" width="200" >}}

To assemble a functional NAS in the NAS Case you will require a number of additional parts.

Expand All @@ -65,7 +67,7 @@ There are a few other things which you may wish to consider purchasing for your

== Which software should I use?

image:/documentation/images/OMVGUI.png[The OMV WebGUI is easy to understand but also very robust. It offers easy installation of plugins, system administration and overview of available services,title="The OMV WebGUI is easy to understand but also very robust. It offers easy installation of plugins, system administration and overview of available services",width=200]
{{< figure src="/documentation/images/OMVGUI.png" title="The OMV WebGUI is easy to understand but also very robust. It offers easy installation of plugins, system administration and overview of available services" width="200" >}}

If you are intending to build a home or small company NAS, then we strongly recommend you use link:/documentation/ROCKPro64/Software#openmediavault[Open Media Vault (OMV)]. OMV is an open source NAS solution that makes setting up user accounts, network shares and services a breeze. It also simplifies installing additional features (called plugins), such as: PLEX media server; Remote Desktop; Encryption; RSync; etc.

Expand All @@ -90,9 +92,9 @@ You should now be left with a bare case ready for installation of the necessary

=== Step 2. Installing the ROCKPro64 into the NAS Case

image:/documentation/images/ROCKPro64inNASCase.jpg[Correct Placement of the ROCKPro64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case,title="Correct Placement of the ROCKPro64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case",width=300]
{{< figure src="/documentation/images/ROCKPro64inNASCase.jpg" title="Correct Placement of the ROCKPro64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case" width="300" >}}

image:/documentation/images/FrontIO.png[Front IO with IR and LED relay installed,title="Front IO with IR and LED relay installed",width=300]
{{< figure src="/documentation/images/FrontIO.png" title="Front IO with IR and LED relay installed" width="300" >}}

Make sure nothing is plugged into your ROCKPro64 - including a micro SD card.
If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.
Expand All @@ -107,9 +109,9 @@ If you wish to install an IRx receiver into your case then you should also place

=== Step 3 PCIe to SATA adapter and Cabling

image:/documentation/images/DC_Location.jpg[DC header on the ROCKPro64 for the power cable,title="DC header on the ROCKPro64 for the power cable",width=200]
{{< figure src="/documentation/images/DC_Location.jpg" title="DC header on the ROCKPro64 for the power cable" width="200" >}}

image:/documentation/images/PCIeFittedSATAsockets.png[PCIe to SATA installed. Note the SATA connection orientation,title="PCIe to SATA installed. Note the SATA connection orientation",width=200]
{{< figure src="/documentation/images/PCIeFittedSATAsockets.png" title="PCIe to SATA installed. Note the SATA connection orientation" width="200" >}}

With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Expand All @@ -124,7 +126,7 @@ Have the cables hang outside the case or to the side for now so that they do not

=== Step 4. Installing HDDs / SSDs into the Holding Bracket

image:/documentation/images/Bracket_Orientation.png[Bracket Orientation in the NAS Case,title="Bracket Orientation in the NAS Case",width=300]
{{< figure src="/documentation/images/Bracket_Orientation.png" title="Bracket Orientation in the NAS Case" width="300" >}}

The next step is to install HDDs/ SSDs into their holding bracket; 2.5 inches drives need to be installed at the very bottom of the bracket whi inchese 3.5 inches drives are at the top of the the bracket.

Expand All @@ -138,7 +140,7 @@ Once the holding bracket is assembled and you have your drives mounted, please s

=== Step 5. Installing Extras (eMMC; WiFi BT module + SMA Antennas; 80mm Fan)

image:/documentation/images/80mmfan.png[The 80mm fan is a worthwhile addition to the NAS Case build,title="The 80mm fan is a worthwhile addition to the NAS Case build",width=200]
{{< figure src="/documentation/images/80mmfan.png" title="The 80mm fan is a worthwhile addition to the NAS Case build" width="200" >}}

If you have additional peripherals, such as an eMMC or WiFi/BT module as well as the 80mm fan, then now is the right time to install them. If you have *none of the above*, please *proceed to step 6* of this guide.

Expand All @@ -152,9 +154,9 @@ Plug in the fan at this stage of the installation and route the cable at the bot

=== Step 6. Installing the HDD / SSD Bracket and Routing Cables

image:/documentation/images/NASCAsewithdrives.jpg[Complete assembly of the NAS Case,title="Complete assembly of the NAS Case",width=300]
{{< figure src="/documentation/images/NASCAsewithdrives.jpg" title="Complete assembly of the NAS Case" width="300" >}}

image:/documentation/images/TopViewAssembly.png[Top view of a complete NAS Case Assembly,title="Top view of a complete NAS Case Assembly",width=300]
{{< figure src="/documentation/images/TopViewAssembly.png" title="Top view of a complete NAS Case Assembly" width="300" >}}

Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Expand Down
64 changes: 32 additions & 32 deletions content/documentation/Accessories/POT.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Peripheral On Top (POT)

== USB/UART Programming/Console Adapter (PMPROG01)

image:/documentation/images/USB_Prog.JPG[]
{{< figure src="/documentation/images/USB_Prog.JPG" >}}

=== Feature

Expand All @@ -43,17 +43,17 @@ https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx[Virtual

https://www.silabs.com/products/mcu/Pages/USBXpress.aspx[USBXpress Driver]

image:/documentation/images/PMPROG01_Rev2_USB_Serial_Programmer-4.jpg[]
{{< figure src="/documentation/images/PMPROG01_Rev2_USB_Serial_Programmer-4.jpg" >}}

image:/documentation/images/PMPROG01_Rev2_USB_Serial_Programmer-1.jpg[]
{{< figure src="/documentation/images/PMPROG01_Rev2_USB_Serial_Programmer-1.jpg" >}}

image:/documentation/images/PMPROG01_Rev2_USB_Serial_Programmer-3.jpg[]
{{< figure src="/documentation/images/PMPROG01_Rev2_USB_Serial_Programmer-3.jpg" >}}

image:/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-1.jpg[]
{{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-1.jpg" >}}

== POT: Veroboard (PMVRB01)

image:/documentation/images/PMVRB01_board_layout.JPG[]
{{< figure src="/documentation/images/PMVRB01_board_layout.JPG" >}}

=== Feature

Expand All @@ -66,17 +66,17 @@ On board 4pcs of Tact switch
On board XH5 2.54mm pitch connector for UART0 allow easy connection to USB/UART adapter for console access
```

image:/documentation/images/PMVRB01_POT_Veroboard_Rev1-5.jpg[]
{{< figure src="/documentation/images/PMVRB01_POT_Veroboard_Rev1-5.jpg" >}}

image:/documentation/images/PMVRB01_POT_Veroboard_Rev1-3B.png[]
{{< figure src="/documentation/images/PMVRB01_POT_Veroboard_Rev1-3B.png" >}}

image:/documentation/images/PMVRB01_POT_Veroboard_Rev1-2B.png[] POT Veroboard on Pine A64
{{< figure src="/documentation/images/PMVRB01_POT_Veroboard_Rev1-2B.png" >}} POT Veroboard on Pine A64

image:/documentation/images/PMVRB01_POT_Veroboard_Rev1-1B.png[] POT Veroboard 2 board stack on top of Pine A64
{{< figure src="/documentation/images/PMVRB01_POT_Veroboard_Rev1-1B.png" >}} POT Veroboard 2 board stack on top of Pine A64

== POT: Multi I2C Bus (PMI2C01)

image:/documentation/images/PMI2C01_Board_Layout.JPG[]
{{< figure src="/documentation/images/PMI2C01_Board_Layout.JPG" >}}

=== Feature

Expand Down Expand Up @@ -108,19 +108,19 @@ https://wiki.pine64.org/images/d/d8/EnableI2cPullup.tar.gz[Program to Enable I2c

https://pine.myggns.com/bozon/index.php?f=157836a20d7b7e[Multi I2c Bus Schematic]

image:/documentation/images/PMI2C01_I2C_Board_Rev1-1.jpg[]
{{< figure src="/documentation/images/PMI2C01_I2C_Board_Rev1-1.jpg" >}}

image:/documentation/images/PMI2C01_I2C_Board_Rev1-2.jpg[]
{{< figure src="/documentation/images/PMI2C01_I2C_Board_Rev1-2.jpg" >}}

image:/documentation/images/PMI2C01_I2C_Board_Rev1-3.jpg[]
{{< figure src="/documentation/images/PMI2C01_I2C_Board_Rev1-3.jpg" >}}

image:/documentation/images/PMVRB01_POT_Veroboard_Rev1-4.jpg[]
{{< figure src="/documentation/images/PMVRB01_POT_Veroboard_Rev1-4.jpg" >}}

== POT: Shield Adapter (PMARD01)

image:/documentation/images/PMARD01_Shield_Adpater_POT.JPG[]
{{< figure src="/documentation/images/PMARD01_Shield_Adpater_POT.JPG" >}}

image:/documentation/images/PMARD01_Arduino_Pin_Mapping.JPG[]
{{< figure src="/documentation/images/PMARD01_Arduino_Pin_Mapping.JPG" >}}

```
Adapter for Arduino Shield
Expand All @@ -135,7 +135,7 @@ https:/ / https://www.maximintegrated.com/en/products/analog/data-converters/ana

== I2C Device: Humidity and Temperature Sensor (PMSDP01)

image:/documentation/images/PMSDO01_Dew_Point_Sensor.JPG[]
{{< figure src="/documentation/images/PMSDO01_Dew_Point_Sensor.JPG" >}}

=== Feature

Expand All @@ -152,11 +152,11 @@ On board 3.3V regulator

https://www.silabs.com/Support%20Documents/TechnicalDocs/Si7021-A20.pdf[Si7021-A20 Datasheet]

image:/documentation/images/PMSDO01_Dew_Point_Sensor_Rev1-1.jpg[]
{{< figure src="/documentation/images/PMSDO01_Dew_Point_Sensor_Rev1-1.jpg" >}}

== I2C Device: Ambient Light Sensor (PMSAL01)

image:/documentation/images/PMSAL01_Light_Sensor.JPG[]
{{< figure src="/documentation/images/PMSAL01_Light_Sensor.JPG" >}}

=== Feature

Expand All @@ -175,13 +175,13 @@ On board 3.3V regulator

https://ams.com/eng/content/download/250094/975485/file/TSL2560_Datasheet_EN_v1.pdf[TSL2561T Datasheet]

image:/documentation/images/PMSAL01_Light_Sensor_Rev1-1.jpg[]
{{< figure src="/documentation/images/PMSAL01_Light_Sensor_Rev1-1.jpg" >}}

image:/documentation/images/PMSAL01_Light_Sensor_Rev1-2.jpg[]
{{< figure src="/documentation/images/PMSAL01_Light_Sensor_Rev1-2.jpg" >}}

== WiFi Remote I2C (PMWF01A)

image:/documentation/images/PMWF01A.JPG[]
{{< figure src="/documentation/images/PMWF01A.JPG" >}}

=== Feature

Expand All @@ -208,23 +208,23 @@ https://drive.google.com/file/d/0B0cEs0lxTtL3SDdCcWd0LVI2bk0/view?usp=sharing[ES

https://bbs.espressif.com/[ESP8266 forum]

image:/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-2.jpg[]
{{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-2.jpg" >}}

image:/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-3.jpg[]
{{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-3.jpg" >}}

image:/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-4.jpg[]
{{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-4.jpg" >}}

image:/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-5.jpg[]
{{< figure src="/documentation/images/PMWF01A_Wifi_Remote_IO_Rev3-5.jpg" >}}

== Inter Connection Wire

image:/documentation/images/I2c_Cable_Connection.JPG[]
{{< figure src="/documentation/images/I2c_Cable_Connection.JPG" >}}

image:/documentation/images/W5T4-01-15_UART_Programming_Console_Cable.JPG[]
{{< figure src="/documentation/images/W5T4-01-15_UART_Programming_Console_Cable.JPG" >}}

image:/documentation/images/W5T4-02-15_5Way_to_4Way_I2C_Cable.JPG[]
{{< figure src="/documentation/images/W5T4-02-15_5Way_to_4Way_I2C_Cable.JPG" >}}

image:/documentation/images/W4T4-03-15_4Way_I2C_Cable.JPG[]
{{< figure src="/documentation/images/W4T4-03-15_4Way_I2C_Cable.JPG" >}}

image:/documentation/images/W5T5-04-15_5Way_I2C_Cable.JPG[]
{{< figure src="/documentation/images/W5T5-04-15_5Way_I2C_Cable.JPG" >}}

Loading

0 comments on commit 1d6b9c7

Please sign in to comment.