dasharo/docs
0
0
Fork 0
mirror of https://github.com/Dasharo/docs.git synced 2026-06-13 10:16:57 -07:00
Code Issues Packages Projects Releases Wiki Activity

mkdocs.yml: add openness score for NC; drop unused docs

Browse Source 
Signed-off-by: Maciej Pijanowski <maciej.pijanowski@3mdeb.com>
This commit is contained in:
Maciej Pijanowski
2023-10-27 14:15:56 +02:00
parent ffe4cf5f65
commit d925b71377
3 changed files with 4 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/variants/novacustom_ns5x_adl/post_install.md
-94
View File
@@ -1,94 +0,0 @@
# Post-installation setup
This document contains extra steps to perform after installing Dasharo in order
to enable full functionality.
## Touchpad hotkey enablement (Linux)
The touchpad hotkey needs extra setup to function correctly under Linux. To
enable the touchpad hotkey to work under Linux, follow the steps below:
1. Create a file `/etc/udev/hwdb.d/60-keyboard.hwdb` with the following contents:
```bash
evdev:atkbd:dmi:bvn*:bvr*:svnNotebook:pnNS5x_NS7xPU:*
KEYBOARD_KEY_f7=191
KEYBOARD_KEY_f8=191
```
1. Execute the following commands:
```bash
sudo systemd-hwdb update
sudo udevadm trigger
```
After executing these steps, it should be possible to enable and disable the
touchpad using the touchpad hotkey (Fn+F1) on the keyboard when using GNOME.
## Touchpad multi-touch support (NS7x / 17-inch model, Linux)
On NS7x an additional fix is necessary to enable multi-touch on Linux. Create
a file `/etc/modprobe.d/blacklist-psmouse.conf` with the following contents:
```bash
blacklist psmouse
```
and then run the following commands:
```bash
sudo depmod -a
sudo update-initramfs -u
```
Now reboot your computer to apply the changes.
## Installing updates and drivers (Windows 11)
Several features on Windows 11 (i. e. suspending the device) may not work or
work unexpectedly without installing all of the updates and drivers.
To install all of them, log into system, connect the device to the mains
and Internet, then follow the steps below:
1. Press the `Windows` button on the keypad.
1. Type `Windows Update Settings` in the search and press `Enter`.
1. Select the `Check for updates` bar to start installing available updates and
drivers. During this process previously selected bar might be changed to
`Restart now` or `Retry`, so click them if something hasn't been installed
yet, something has gone wrong or restart is just required. The entire
process may take up to 30 minutes.
1. Select the `Advanced options` option in the `Windows Update Settings` window.
1. Locate the `Optional updates` option and click on it.
1. Select all displayed updates and drivers.
1. Select the `Download & Install` bar to start installing additional updates
and drivers. During this process previously selected bar might be changed
to `Restart now` or `Retry`, so click them if something hasn't been
installed yet, something has gone wrong or restart is just required.
The entire process may take up to 30 minutes.
1. Repeat all steps until all updates have been installed.
## Suspend fix for SATA disks (Windows and Linux)
Only affects laptops with M.2 SATA disks experiencing sleep issues (the power
LED not blinking while the laptop is suspended).
Windows and certain Linux distros such as Ubuntu do not enable the necessary
power saving tweaks to enable sleep mode while a SATA disk is installed. To
apply the fix, run the following scripts
### Windows
- Download the script: [link](https://cloud.3mdeb.com/index.php/s/nNQwDEKryCHGJ5n)
- Double click on the script to install the tweak
### Linux
- Download the script: [link](https://cloud.3mdeb.com/index.php/s/ms9Dd7NtcXTj8KL)
- Execute as root:
```bash
chmod +x install_dipm_service.sh
sudo ./install_dipm_service.sh
```
docs/variants/novacustom_nv4x_tgl/openness_analysis.md
-72
View File
@@ -1,72 +0,0 @@
# Intro
This document aims to compare the openness of Dasharo Firmware and Insyde BIOS.
There is an
[ongoing discussion](https://github.com/Dasharo/dasharo-issues/issues/43)
about the methodology of the openness metric.
## BIOS versions used in the analysis
* [Dasharo coreboot v0.5.0](https://cloud.3mdeb.com/index.php/s/xM8FcCsMc8kfmKB)
* [Insyde BIOS](https://cloud.3mdeb.com/index.php/s/6Pte9F9nefxQEMN)
## Insyde BIOS
In the case of the Insyde bios, the entire image should be considered
proprietary. There are several parts of the image that have a well-known
structure or make use of a public standard. However, to decode these structures,
one needs to employ reverse-engineering tools and techniques to know what
structures are present.
## Dasharo BIOS
### CBFS
| image | size (bytes) | Is it open-source? |
| --- | ---: | --- |
| cbfs master header | 20h | Yes |
| fallback/romstage | 14770h | Yes |
| cpu_microcode_blob.bin | 31C00h | No |
| intel_fit | 50h | Yes |
| fallback/ramstage | 1E626h | Yes |
| config | 579h | Yes |
| revision | 351h | Yes |
| build_info | 5Dh | Yes |
| fallback/dsdt.aml | 6233h | Yes |
| vbt.bin | 51Ch | Yes |
| (empty) | 1E4h | N/A |
| fspm.bin | 9F000h | No |
| cmos_layout.bin | 22Ch | Yes |
| (empty) | D24h | N/A |
| fsps.bin | 43676h | No |
| fallback/postcar | 8F24h | Yes |
| fallback/payload | 1771C5h | Yes |
| fallback/verstage | 12C80h | Yes |
| (empty) | 10E5E4h | N/A |
| bootblock | 74C0h | Yes |
| **Summary** | 3F7A33h | **In 62.9%** |
Open and closed source images are in the table below.
| type | summarised size | Percent |
| --- | ---: | ---: |
| open-source | 1D42D1h | 62.9% |
| closed-source | 114276h | 37.1% |
| empty (not included) | 10F4ECh | |
### Whole flash image
| region | size | open-source percent (bytes) |
| --- | ---: | ---: |
| descriptor | 1000h | 0% |
| ME | 4FF000h | 0% |
| BIOS | B00000h | 62.9% |
| **Summary** | 1000000h | **43.2%** |
## Summary
| image | open-source percent (bytes) |
| --- | ---: |
| Insyde | 0% |
| Dasharo | 43.2% |
mkdocs.yml
+4 -2
View File
@@ -117,22 +117,24 @@ nav:
- 'Releases': variants/novacustom_nv4x_adl/releases.md
- 'Hardware Configuration Matrix': variants/novacustom_nv4x_adl/hardware-matrix.md
- 'Test matrix': variants/novacustom_nv4x_adl/test-matrix.md
- 'Openness score': variants/novacustom_nv4x_adl/openness-score.md
- 'NV4x 11th Gen':
- 'Releases': variants/novacustom_nv4x_tgl/releases.md
- 'Hardware Configuration Matrix': variants/novacustom_nv4x_tgl/hardware-matrix.md
- 'Test matrix': variants/novacustom_nv4x_tgl/test-matrix.md
- 'Openness score': variants/novacustom_nv4x_tgl/openness_analysis.md
- 'Openness score': variants/novacustom_nv4x_tgl/openness-score.md
- 'LVFS report': variants/novacustom_nv4x_tgl/lvfs_report.md
- 'Checbox results': variants/novacustom_nv4x_tgl/compatibility-check-results-ubuntu.md
- 'NS5x/7x 12th Gen':
- 'Releases': variants/novacustom_ns5x_adl/releases.md
- 'Hardware Configuration Matrix': variants/novacustom_ns5x_adl/hardware-matrix.md
- 'Post-installation setup': variants/novacustom_ns5x_adl/post_install.md
- 'Test matrix': variants/novacustom_ns5x_adl/test-matrix.md
- 'Openness score': variants/novacustom_ns5x_adl/openness-score.md
- 'NS5x/7x 11th Gen':
- 'Releases': variants/novacustom_ns5x_tgl/releases.md
- 'Hardware Configuration Matrix': variants/novacustom_ns5x_tgl/hardware-matrix.md
- 'Test matrix': variants/novacustom_ns5x_tgl/test-matrix.md
- 'Openness score': variants/novacustom_ns5x_tgl/openness-score.md
- 'Dell OptiPlex':
- 'Overview': variants/dell_optiplex/overview.md
- 'Releases': variants/dell_optiplex/releases.md