Merge pull request #248 from printfinn/update-debian-soft-doc

Add a backup doc for Rockchip products.

docs/source/PCs/ARM/PX30/AIO/Manuals/Software/Buildroot_Linux_Qt_5_14.rst

@@ -0,0 +1,48 @@
+.. include:: /PCs/Shared/pdf_options_software
+
+.. |systemType| replace:: Buildroot Linux Qt 5.14
+.. |chip| replace:: PX30
+.. |ipc| replace:: Chipsee industrial PC
+
+.. |rootfs_blk| replace:: **/dev/mmcblk2p8**
+
+.. |sdx| replace:: /dev/sdb8
+
+.. |git_branch| replace:: px30
+
+.. |os_down_path| replace:: :ref:`Chipsee prebuilt image <PX30_OSDownloads>`
+
+.. include:: Resources/backup_note
+
+.. _px30_os_linuxqt_514:
+
+.. |OS_Backup_img| image:: /Media/ARM/A35/AIO/Software/PX30_OS_Backup_Debian10_1.png
+                  :align: middle
+                  :width: 720
+
+|systemType| OS
+###############
+
+.. rst-class:: fs-3 fw-bold text-center
+
+  |systemType| OS on |chip| User Manual
+
+
+.. image:: /Media/Chipsee_Logo_Full.png
+   :align: center
+   :width: 320
+   :alt: chipsee-logo
+
+This is the software manual for |chip| Chipsee industrial PC. If you've never developed on this hardware with a |systemType| OS, this manual can get you started quickly.
+
+
+FAQ
+===
+
+:pagebreak:`True`
+
+.. include:: /PCs/ARM/Shared/Rockchip/Software/Backup_OS
+
+:pagebreak:`True`
+
+.. include:: /PCs/Shared/support

docs/source/PCs/ARM/PX30/AIO/Manuals/Software/Debian_10.rst

@@ -0,0 +1,48 @@
+.. include:: /PCs/Shared/pdf_options_software
+
+.. |systemType| replace:: Debian 10
+.. |chip| replace:: PX30
+.. |ipc| replace:: Chipsee industrial PC
+
+.. |rootfs_blk| replace:: **/dev/mmcblk2p8**
+
+.. |sdx| replace:: /dev/sdb8
+
+.. |git_branch| replace:: px30
+
+.. |os_down_path| replace:: :ref:`Chipsee prebuilt image <PX30_OSDownloads>`
+
+.. include:: Resources/backup_note
+
+.. _px30_os_debian10:
+
+.. |OS_Backup_img| image:: /Media/ARM/A35/AIO/Software/PX30_OS_Backup_Debian10_1.png
+                  :align: middle
+                  :width: 720
+
+|systemType| OS
+###############
+
+.. rst-class:: fs-3 fw-bold text-center
+
+  |systemType| OS on |chip| User Manual
+
+
+.. image:: /Media/Chipsee_Logo_Full.png
+   :align: center
+   :width: 320
+   :alt: chipsee-logo
+
+This is the software manual for |chip| Chipsee industrial PC. If you've never developed on this hardware with a |systemType| OS, this manual can get you started quickly.
+
+
+FAQ
+===
+
+:pagebreak:`True`
+
+.. include:: /PCs/ARM/Shared/Rockchip/Software/Backup_OS
+
+:pagebreak:`True`
+
+.. include:: /PCs/Shared/support

docs/source/PCs/ARM/PX30/AIO/Manuals/Software/Resources/backup_note

@@ -0,0 +1,5 @@
+.. |note1| replace:: More on the prebuilt image: the core idea of backup is to "swap" your data and the prebuilt data. So we will need to download a prebuilt image that you're developing your software on (the OS image that you're currently using on the Chipsee PC), unpack that image, swap the data, then repack the image (imagine the old time people use a WinPE USB stick to boot and backup Windows!).
+
+.. |note2| replace:: We will use the prebuilt-xxx-emmc-xx.img (eMMC firmware) to boot the device from an SD card, but the image for eMMC has one known bug: it will need reboot a few times to get the SD partition to be mounted on “/”. We will released one new image for SD called prebuilt-xxx-sd-xx.img in the future. But at the moment we can still get by with the eMMC image in an SD card.
+
+.. |backup_reboot| replace:: Insert this SD card into the SD slot of the Chipsee PC and power it on, the Chipsee PC will boot into the system on the SD card (may need to reboot multiple times to boot from SD card, because of a known bug in the eMMC firmware, we will release a firmware for SD card in the future), we can use this system to backup the whole contents on eMMC rootfs partitions.

docs/source/PCs/ARM/PX30/AIO/Manuals/Software/index

@@ -20,6 +20,46 @@ Firmware
 
 :ref:`OS Downloads <PX30_OSDownloads>`
 
+.. raw:: html
+
+     </div>
+   </div>
+
+.. raw:: html
+
+   <div class="col">
+      <div class="index-item">
+
+Doc
+
+.. raw:: html
+
+         <a href="/PCs/ARM/PX30/AIO/Manuals/Software/Debian_10.html">
+            <img src="/_static/images/os_logo_debian.png" class="img-fluid text-center" width="100px">
+         </a>
+
+:ref:`Debian 10<px30_os_debian10>`
+
+.. raw:: html
+
+     </div>
+   </div>
+
+.. raw:: html
+
+   <div class="col">
+      <div class="index-item">
+
+Doc
+
+.. raw:: html
+
+         <a href="/PCs/ARM/PX30/AIO/Manuals/Software/Buildroot_Linux_qt_5_14.html">
+            <img src="/_static/images/os_logo_linux.png" class="img-fluid text-center" width="100px">
+         </a>
+
+:ref:`Buildroot Linux Qt 5.14<px30_os_linuxqt_514>`
+
 .. raw:: html
 
      </div>
@@ -35,3 +75,6 @@ Firmware
    :hidden:
 
    AIO-PX30-101 OS Downloads </PCs/ARM/PX30/AIO/OS_Downloads/index>
+   Debian 10 </PCs/ARM/PX30/AIO/Manuals/Software/Debian_10>
+   Buildroot Linux Qt 5.14 </PCs/ARM/PX30/AIO/Manuals/Software/Buildroot_Linux_Qt_5_14>
+

docs/source/PCs/ARM/RK3399/Manuals/Software/Buildroot_Linux_Qt_5_14.rst

@@ -0,0 +1,44 @@
+.. include:: /PCs/Shared/pdf_options_software
+
+.. |systemType| replace:: Buildroot Linux Qt 5.14
+.. |chip| replace:: RK3399
+.. |ipc| replace:: Chipsee industrial PC
+
+.. |rootfs_blk| replace:: **/dev/mmcblk2p8**
+
+.. |sdx| replace:: /dev/sdb8
+
+.. |git_branch| replace:: master
+
+.. |os_down_path| replace:: :ref:`Chipsee prebuilt image <RK3399_OSDownloads>`
+
+.. include:: Resources/Shared/backup_note
+
+.. _rk3399_os_linuxqt514:
+
+.. |OS_Backup_img| image:: /Media/ARM/A72/Software/RK3399_OS_Backup_Debian10_1.png
+                  :align: middle
+                  :width: 720
+
+|systemType| OS
+###############
+
+.. rst-class:: fs-3 fw-bold text-center
+
+  |systemType| OS on |chip| User Manual
+
+
+.. image:: /Media/Chipsee_Logo_Full.png
+   :align: center
+   :width: 320
+   :alt: chipsee-logo
+
+This is the software manual for |chip| Chipsee industrial PC. If you've never developed on this hardware with a |systemType| OS, this manual can get you started quickly.
+
+:pagebreak:`True`
+
+.. include:: /PCs/ARM/Shared/Rockchip/Software/Backup_OS
+
+:pagebreak:`True`
+
+.. include:: /PCs/Shared/support

docs/source/PCs/ARM/RK3399/Manuals/Software/Debian_10.rst

@@ -0,0 +1,44 @@
+.. include:: /PCs/Shared/pdf_options_software
+
+.. |systemType| replace:: Debian 10
+.. |chip| replace:: RK3399
+.. |ipc| replace:: Chipsee industrial PC
+
+.. |rootfs_blk| replace:: **/dev/mmcblk2p8**
+
+.. |sdx| replace:: /dev/sdb8
+
+.. |git_branch| replace:: master
+
+.. |os_down_path| replace:: :ref:`Chipsee prebuilt image <RK3399_OSDownloads>`
+
+.. include:: Resources/Shared/backup_note
+
+.. _rk3399_os_debian10:
+
+.. |OS_Backup_img| image:: /Media/ARM/A72/Software/RK3399_OS_Backup_Debian10_1.png
+                  :align: middle
+                  :width: 720
+
+|systemType| OS
+###############
+
+.. rst-class:: fs-3 fw-bold text-center
+
+  |systemType| OS on |chip| User Manual
+
+
+.. image:: /Media/Chipsee_Logo_Full.png
+   :align: center
+   :width: 320
+   :alt: chipsee-logo
+
+This is the software manual for |chip| Chipsee industrial PC. If you've never developed on this hardware with a |systemType| OS, this manual can get you started quickly.
+
+:pagebreak:`True`
+
+.. include:: /PCs/ARM/Shared/Rockchip/Software/Backup_OS
+
+:pagebreak:`True`
+
+.. include:: /PCs/Shared/support

docs/source/PCs/ARM/RK3399/Manuals/Software/Debian_11.rst

@@ -0,0 +1,44 @@
+.. include:: /PCs/Shared/pdf_options_software
+
+.. |systemType| replace:: Debian 11
+.. |chip| replace:: RK3399
+.. |ipc| replace:: Chipsee industrial PC
+
+.. |rootfs_blk| replace:: **/dev/mmcblk0p7**
+
+.. |sdx| replace:: /dev/sdb7
+
+.. |git_branch| replace:: r510-rk3399
+
+.. |os_down_path| replace:: :ref:`Chipsee prebuilt image <RK3399_OSDownloads>`
+
+.. include:: Resources/Shared/backup_note
+
+.. _rk3399_os_debian11:
+
+.. |OS_Backup_img| image:: /Media/ARM/A72/Software/RK3399_OS_Backup_Debian11_1.png
+                  :align: middle
+                  :width: 720
+
+|systemType| OS
+###############
+
+.. rst-class:: fs-3 fw-bold text-center
+
+  |systemType| OS on |chip| User Manual
+
+
+.. image:: /Media/Chipsee_Logo_Full.png
+   :align: center
+   :width: 320
+   :alt: chipsee-logo
+
+This is the software manual for |chip| Chipsee industrial PC. If you've never developed on this hardware with a |systemType| OS, this manual can get you started quickly.
+
+:pagebreak:`True`
+
+.. include:: /PCs/ARM/Shared/Rockchip/Software/Backup_OS
+
+:pagebreak:`True`
+
+.. include:: /PCs/Shared/support

docs/source/PCs/ARM/RK3399/Manuals/Software/Resources/Shared/backup_note

@@ -0,0 +1,5 @@
+.. |note1| replace:: More on the prebuilt image: the core idea of backup is to "swap" your data and the prebuilt data. So we will need to download a prebuilt image that you're developing your software on (the OS image that you're currently using on the Chipsee PC), unpack that image, swap the data, then repack the image (imagine the old time people use a WinPE USB stick to boot and backup Windows!).
+
+.. |note2| replace:: We will use the prebuilt-xxx-emmc-xx.img (eMMC firmware) to boot the device from an SD card, but the image for eMMC has one known bug: it will need reboot a few times to get the SD partition to be mounted on “/”. We will released one new image for SD called prebuilt-xxx-sd-xx.img in the future. But at the moment we can still get by with the eMMC image in an SD card. (For *7 inch RK3399(EPC/PPC-A72-070-C)* user, you can select prebuilt-xxx-sd-xx.img now.)
+
+.. |backup_reboot| replace:: Insert this SD card into the SD slot of the Chipsee PC and power it on, the Chipsee PC will boot into the system on the SD card (may need to reboot multiple times to boot from SD card, because of a known bug in the eMMC firmware, we will release a firmware for SD card in the future), we can use this system to backup the whole contents on eMMC rootfs partitions.

docs/source/PCs/ARM/RK3399/Manuals/Software/index

@@ -20,6 +20,66 @@ Firmware
 
 :ref:`OS Downloads <RK3399_OSDownloads>`
 
+.. raw:: html
+
+     </div>
+   </div>
+
+.. raw:: html
+
+   <div class="col">
+      <div class="index-item">
+
+Doc
+
+.. raw:: html
+
+         <a href="/PCs/ARM/RK3399/Manuals/Software/Debian_10.html">
+            <img src="/_static/images/os_logo_debian.png" class="img-fluid text-center" width="100px">
+         </a>
+
+:ref:`Debian 10<rk3399_os_debian10>`
+
+.. raw:: html
+
+     </div>
+   </div>
+
+.. raw:: html
+
+   <div class="col">
+      <div class="index-item">
+
+Doc
+
+.. raw:: html
+
+         <a href="/PCs/ARM/RK3399/Manuals/Software/Debian_11.html">
+            <img src="/_static/images/os_logo_debian.png" class="img-fluid text-center" width="100px">
+         </a>
+
+:ref:`Debian 11<rk3399_os_debian11>`
+
+.. raw:: html
+
+     </div>
+   </div>
+
+.. raw:: html
+
+   <div class="col">
+      <div class="index-item">
+
+Doc
+
+.. raw:: html
+
+         <a href="/PCs/ARM/RK3399/Manuals/Software/Buildroot_Linux_Qt_5_14.html">
+            <img src="/_static/images/os_logo_linux.png" class="img-fluid text-center" width="100px">
+         </a>
+
+:ref:`Buildroot Linux Qt 5.14 <rk3399_os_linuxqt514>`
+
 .. raw:: html
 
      </div>
@@ -34,4 +94,7 @@ Firmware
    :titlesonly:
    :hidden:
 
-   RK3399 OS Downloads </PCs/ARM/RK3399/OS_Downloads/index>
+   RK3399 OS Downloads </PCs/ARM/RK3399/OS_Downloads/index>
+   Debian 10 </PCs/ARM/RK3399/Manuals/Software/Debian_10>
+   Debian 11 </PCs/ARM/RK3399/Manuals/Software/Debian_11>
+   Buildroot Linux Qt 5.14 </PCs/ARM/RK3399/Manuals/Software/Buildroot_Linux_Qt_5_14>