v0.10.0 release.

README.md

@@ -1,87 +1,6 @@
-# teamredminer v0.9.4.7
+# teamredminer v0.10.0
 This is an optimized miner for AMD GPUs and Xilinx FPGAs created by todxx and kerney666.
 
-## This is a public beta release and only available through the download links below
-
-We've chosen to release v0.9.4.7 and the previous v0.9.4.6 as public betas to gather more user feedback without triggering automatic updates in mining distros. With the v0.9.4.7 release, we believe we've solved the issue with some Navi gpus simply not responding well to R-mode, rather dropping to e.g. 48-50 MH/s instead of expected 55-56 MH/s for a 5700/5700XT. We're expecting to push this version in a proper public release shortly unless we hear about any additional issues. If you don't use the new R-mode, or you're a Windows miner, you still have an upside running this new version for the "smooth power" rewrite described below. 
-
-This rewrite is targeting ethash family algorithms. There are two distinct parts:
-
-1) Smooth power transitions. This affects all gpus, and both windows and linux. This is mainly a (theoretical) stability feature that improves power draw on a very small scale level, making sure the gpu activity and resulting power draw is as smooth as possible, avoiding psu slew rate spikes. The nice side effect is that it in most cases also improves hashrate slightly, on all gpus.
-
-2) R-mode. This is our most advanced mode work so far. It is linux only, like the previous C-mode for Radeon VIIs. R-mode is applicable for all non-Polaris gpus. It also needs special linux kernel boot parameters set, like the Radeon VII C-mode. R-mode will be used by default when the necessary linux kernel parameters are set. A huge difference between the new R-mode and previous B/C-modes is that the R-mode does not degrade over time as the dag grows. The efficiency improvements on many gpus are significant. Biggest winners are 5700XT/5700/5600XT. Please(!) read the [R-mode tuning guide](https://github.com/todxx/teamredminer/blob/master/doc/ETHASH_TUNING_GUIDE_RMODE.txt) for more details and before switching to R-mode.
-
-Download links:
-
-- Linux: https://dl.teamredminer.com/beta/teamredminer-v0.9.4.7-linux.tgz
-- Windows: https://dl.teamredminer.com/beta/teamredminer-v0.9.4.7-win.zip
-- HiveOS custom miner package: https://dl.teamredminer.com/beta/trm_beta-0.9.4.7.tgz
-
-
-HiveOS test instructions
-------------------------
-You need a modern Hive image to run the new version in R-mode. Running on older linux kernels will not end well, we experienced hard crashes in early testing. Our testing was mainly performed on reimaged installations of 0.6-212, 0.6-216, and 0.6-217. You're free to test whatever version you're currently running, but be prepared for hard hangs potentially requiring power cycling. Older kernel versions might also _seem_ to run ok but then result in a higher-than-usual amount of stale pool shares.
-
-To simplify miner upgrade, we've taken the time to build a custom miner package for Hive. Set up a new flight sheet as follows:
-
-1) Create new flight sheet.
-2) Select ETH and your wallet of choice, then some dummy pool.
-3) In the miner search textbox, type "custom", then click "Show all", and select "Custom".
-4) Copy/paste https://dl.teamredminer.com/beta/trm_beta-0.9.4.7.tgz as the installation url. The miner name will be derived automatically.
-5) Depending on your pool, choose a Wallet and worker template. %WAL%.%WORKER_NAME% is usually a good choice.
-6) Type your pool url(s) in the "Pool URL" field. This must be done - the pool you selected in step 2 will not be used.
-7) In "Extra config arguments", add "--kernel_vm_mode=RR" and any other TRM arguments you want to add.
-
-The --kernel_vm_mode=RR argument runs the miner's integrated support for setting the necessary kernel boot parameters using a bundled script. The argument value "RR" means "(R)eboot if necessary and set (R)-mode". You can keep the argument in the flight sheet. This way the R-mode arguments will be restored automatically after a Hive update.
-
-
-MMP OS test instructions
-------------------------
-For MMP, simply download the miner package and overwrite the existing teamredminer binary. MMP should run with the amd opencl driver 21.40.2 or 21.50.2, 20.40 has not worked well in our tests. Procedure:
-
-Step 1: upgrade miner binary
-1) Set up TRM 0.9.4.2 (or some other version) running on the rig.
-2) Open up a shell on your MMP rig using the remote console or a ssh session.
-3) Type or copy/paste the following commands:
-```
-sudo su -
-cd /opt/mmp/miners/teamredminer
-wget https://dl.teamredminer.com/beta/teamredminer-v0.9.4.7-linux.tgz
-tar xvzf teamredminer-v0.9.4.7-linux.tgz
-mv teamredminer teamredminer.old
-mv teamredminer-v0.9.4.7-linux/teamredminer teamredminer
-rm -rf teamredminer-v0.9.4.7-linux
-```
-4) Optional: restart the miner, check logs to verify the version running is 0.9.4.7.
-
-Step 2: enable R-mode support
-1) Disable the "System watchdog" for your rig.
-2) Open up a shell on your MMP rig using the remote console or a ssh session.
-3) Run "mmp update".
-4) Run "mmp upgrade" (necessary to get the enable-trm-boost command).
-5) Let the system reboot.
-6) After reboot, open a new shell.
-7) Run "enable-trm-boost". Confirm that you see "ENABLE_VMSIZE[TRM BOOST] is set to enabled but its currently disabled - enabling! [WARN]", **if not rerun "enable-trm-boost" _again_**.
-8) Reboot with the "srb" command or "sudo reboot".
-9) R-mode should now be available and used by default on supported gpus.
-
-
-Other distros
--------------
-We might include more distro-specific descriptions here further on, but the general way of testing the new version is to loosely follow the MMP OS manual upgrade path:
-
-1) Set up an older version of TRM mining, for example v0.9.4.2.
-2) Drop to a shell/terminal on your rig and locate the directory where the TRM binary is stored.
-3) Download the beta version using `wget https://dl.teamredminer.com/beta/teamredminer-v0.9.4.7-linux.tgz`
-4) Unpack the downloaded file: `tar xvzf teamredminer-v0.9.4.7-linux.tgz`
-5) Move the current TRM binary out of the way: `mv teamredminer teamredminer.old`
-6) Move the downloaded binary: `mv teamredminer-v0.9.4.7-linux/teamredminer teamredminer`
-7) Manually edit `/etc/default/grub` and add the necessary kernel boot parameters (see the [R-mode tuning guide](https://github.com/todxx/teamredminer/blob/master/doc/ETHASH_TUNING_GUIDE_RMODE.txt)).
-8) Change your tuning before rebooting. We recommend lowering core clk -200 MHz on all gpus except the Radeon VII family.
-9) Reboot. You should now be mining in R-mode. Increase core clk slowly again until you hit your old hashrate.
-
----------------------------------------
-
 **Download is available in the [github releases section](https://github.com/todxx/teamredminer/releases).**
 
 TRM official website: https://www.teamredminer.com
@@ -212,11 +131,19 @@ For command line options see the [USAGE.txt](USAGE.txt) file that comes with the
 
 ## Release Notes
 
-### v0.9.4.7 (public beta)
+### v0.10.0 (R-mode public release)
+#### Changes
+- GPU:  R-mode introduced. See separate documentation. Applicable for Vegas/VIIs/Navi10/Big Navi.
+- GPU:  Smooth power transitions for ethash family algos.
+- GPU:  Added support for multiple --api_listen and --api_listen2 endpoints (up to 8 total).
+- FPGA: Fixed crash bug with > 16 fpgas running in a single miner instance.
+- GPU:  Added argument --gpu_sdma=on|off for special situations. For example, BC-250 needs --gpu_sdma=off. 
+
+### v0.9.4.7 (R-mode public beta)
 #### Changes
 - GPU:  Hopefully fixed R-mode low hashrate issues on random Navi gpus.
 
-### v0.9.4.6 (public beta)
+### v0.9.4.6 (R-mode public beta)
 #### Changes
 - GPU:  R-mode introduced. See separate documentation. Applicable for Vegas/VIIs/Navi10/Big Navi.
 - GPU:  Smooth power transitions for ethash family algos.

USAGE.txt

@@ -1,4 +1,4 @@
-          Team Red Miner version 0.9.4.6
+          Team Red Miner version 0.10.0
 Usage: teamredminer [OPTIONS]
 Options:
   -a, --algo=ALGORITHM      Selects the mining algorithm.  Currently available:
@@ -120,6 +120,11 @@ Options:
       --kernel_vm_mode_script=X  (Linux only).  Specifies the script to call for setting new kernel mode parameters.
                               The script must act like the default TRM script included in the miner distribution package,
                               called ubuntu_mode_script.sh.  This argument should normally not be necessary.
+      --gpu_sdma=on|off     Controls whether direct sdma operations are used by the driver to copy memory from/to
+                              the gpu. This argument is only needed in very special situations. For example, the AMD BC-250
+                              does not support sdma and needs --gpu_sdma=off. If you experience hangs directly at gpu
+                              initialization, but other miners or older TRM versions work fine, try --gpu_sdma=off.
+                              This setting is an environment setting and controls all gpus.
 
 Pool config options:
   -o, --url=URL             Sets the pool URL.  Currently stratum+tcp and stratum+ssl URLs are supported.

doc/ETHASH_TUNING_GUIDE_RMODE.txt

@@ -2,6 +2,7 @@ TeamRedMiner Ethash R-mode Tuning Guide
 =======================================
 
 History:
+v1.1 2022-05-18 (v0.10.0 public release)
 v1.0 2022-05-03 (v0.9.4.6 public beta release)
 
 General Overview
@@ -55,7 +56,7 @@ The effect of R-mode on different gpus can be summarized as follows:
 - 5700XT/5700: big winner. Core clk 1050-1075 MHz is now enough to
   sustain 56 MH/s. Can almost always run at sub-700mV core voltage.
 
-- 5600XT: big winner. Core clk 950 MHz supports 42 MH/s, core voltage
+- 5600XT: decent winner. Core clk 950 MHz supports 42 MH/s, core voltage
   can be dropped low.
 
 - Radeon VII family: solid win, hashrate restored to original C-mode
@@ -115,9 +116,10 @@ reboot automatically the first time it's executed.
 Enabling R-mode using integrated mining distro support
 ------------------------------------------------------
 If your mining distro has integrated support for TRM R-mode, you
-should use that instead. At the time of writing, only MMP OS has
-support with its "enable-trm-boost" argument. Please refer to MMP
-specific documentation for more details.
+should use that instead. At the time of writing, MMP OS and RaveOS
+have support with the "enable-trm-boost" (MMP) and "trm-mode" (RaveOS)
+commands. Please refer to documentation for your specific distro for
+more details.
 
 
 Enabling R-mode manually
@@ -200,7 +202,7 @@ culprit and typically needs its tuning adjusted.
 
 Dual mining TON in R-mode
 =========================
-R-mode dual mining is only interesting if you're looking for a power
+R-mode dual mining is mostly interesting if you're looking for a power
 efficient setup. With summer and high temperatures approaching, it's
 also a way to control heat. If you run a dual mining setup with a high
 core clk to maximize the dual mining algo, you should keep mining in