############# Configuración ############# .. contents:: :local: :depth: 2 ************************* Argumentos de Instalación ************************* El script de instalación usa dos tipos de argumentos: * argumentos posicionales - requerido para completar la instalación; * argumentos opcionales - opcional (ej: no requerido) para completar la instalación. La sintaxis del script de instalación es la siguiente: :: uso: upgrade2bos.py [-h] [--no-backup] [--no-nand-backup] [--no-keep-network] [--keep-hostname] [--no-wait] hostname **Argumentos posicionales:** .. code-block:: none hostname [hostname ...] Nombre host o dirección IP del minero seleccionado **Argumentos opcionales:** .. code-block:: none -h, --help muestra este mensaje de ayuda y sale --no-backup salta hacer respaldo al minero antes de actualizar --no-nand-backup salta respaldo completo NAND (la configuración sigue siendo respaldada) --no-keep-network no conservar la configuración de red del minero (usa DHCP) --keep-hostname mantener nombre host del minero --no-wait no esperar hasta que el sistema esté completamente actualizado **************** Ajustes del Pool **************** Los usuarios pueden especificar múltiples pool. Todos los pool en un grupo usan la estrategia multi-pool con respaldo, lo que significa que BOSminer cambiará automáticamente al segundo pool si el primer pool muere. La configuración está disponible a través de la web GUI (*Miner -> Configuration*) o en el archivo de configuración ``/etc/bosminer.toml``. La sintaxis es la siguiente: :: [[group]] name = 'Default' quota = 1 [[group.pool]] enabled = true url = 'stratum2+tcp://v2.stratum.slushpool.com/u95GEReVMjK6k5YqiSFNqqTnKU4ypU2Wm8awa6tmbmDmk1bWt' user = 'username.workername' password = 'secret' * *name* - Nombre del grupo de pool (explicado en la sección *Grupos de Pool* abajo) * *quota* - Cuota fijada por el usuario para el grupo (explicado en la sección *Grupos de Pool* abajo) * *enabled* - Estado inicial del pool luego de la inicializar BOSminer (por defecto=true (verdadero)) * *url* - Argumento obligatorio para el URL del servidor especificado en el formato ``scheme://HOSTNAME:PORT/POOL_PUBLIC_KEY``. No se necesita especificar un puerto explicito para *Stratum V2* en Slush Pool. La razón es que el protocolo está todavía en desarrollo y nosotros alternamos entre dos puertos por defecto (**3336** y **3337**) a través de actualizaciones al protocolo. Los mineros que no actualicen podrán seguir usando la versión previa del protocolo. Los mineros que actualicen no tendrán que preocuparse en actualizar su URL de minado con un puerto nuevo. Hay un *nuevo* elemento requerido en la ruta del URL que es la llave pública anunciada por el pool que el software de minado usa para verificar la autenticidad del punto final de minado al cual se conecta. Esto previene ataques de intermediarios que intenten robar tasa de hash. Cualquier intento de ello resultará en verificación fallida y el software rechazará usar el pool dado. * *user* - Argumento obligatorio para el nombre de usuario especificado en el formato ``USERNAME.WORKERNAME`` * *password* - Ajustes opcionales en password Grupos de Pool ============== Los usuarios pueden crear distintos grupos de pool múltiples. Todos los pool dentro de un grupo usarán la estrategia de respaldo multi-pool descrita arriba. Cuando se crean grupos de pool múltiples, el trabajo es distribuido para cada grupo con la estrategia de balanceo de carga, bien sea a base de Cuotas o por una Tasa Compartida Fija. Ejemplo: Grupo 1 tiene dos pool especificados y una Cuota asignada de "1". Grupo 2 tiene solo un pool especificado y una Cuota asignada de "2". - El trabajo es asignado a los grupos con una tasa 1:2 - Grupo 2 recibirá el doble de cantidad de trabajo asignado que grupo 1. - Si el primer pool en Grupo 1 muere, BOSminer cambiará al segundo pool en Grupo 1. Es posible usar una Tasa Compartida Fija en lugar de una Cuota, lo que dividiría el trabajo en un porcentaje especificado. Una Cuota de 1:1 es equivalente a una Tasa Compartida Fija de 0.5 (50%) - ambos ajustes dividirán el trabajo por la mitad y lo enviarán a los dos grupos. La configuración está disponible a través de la web GUI (*Miner -> Configuration*) o en el archivo de configuración ``/etc/bosminer.toml``. Ejemplo de dos grupos y pools multiples: :: [[group]] name = 'MiGrupo1' quota = 1 [[group.pool]] enabled = true url = 'stratum2+tcp://v2.stratum.slushpool.com/u95GEReVMjK6k5YqiSFNqqTnKU4ypU2Wm8awa6tmbmDmk1bWt' user = 'userA.worker' [[group.pool]] enabled = true url = 'stratum+tcp://stratum.slushpool.com:3333' user = 'userA.worker' [[group]] name = 'MiGrupo2' quota = 2 [[group.pool]] url = 'stratum+tcp://stratum.slushpool.com:3333' user = 'userB.worker' Con esta disposición, el trabajo será dividido entre los dos grupos, a una tasa 1:2. Por defecto, el minero estará minando en el primer pool del grupo "MiGrupo1" y en un pool definido en el grupo "MiGrupo2". Si el primer pool en "MiGrupo1" muere, el minero estará minando en el segundo pool del grupo "MiGrupo1". Ya que un segundo pool url no está especificado para "MiGrupo2", nada se hará si el pool en "MiGrupo2" falla. ******************* Ajustes Cadena Hash ******************* Configuración opcional para anular los ajustes predeterminados de todas las cadenas hash. Esto permite a los usuarios controlar la frecuencia y voltaje de cada cadena hash y les permite activar o desactivar AsicBoost. Cuando el autoajuste está activado, estos ajustes son ignorados. Los ajustes de cadena hash globales pueden también ser anulados en ajustes por-cadena. La configuración esta disponible también a través de la web GUI (*Miner -> Configuration*) o en el archivo de configuración ``/etc/bosminer.toml``. La sintaxis es la siguiente: :: [hash_chain_global] asic_boost = true frequency = 650.0 voltage = 8.8 * *asic_boost* - Activa o desactiva soporte AsicBoost (por defecto=true(verdad)) * *frequency* - Fija la frecuencia por defecto del chip en MHz para todas las cadenas hash (por defecto=650.0) * *voltage* - Fija el voltaje por defecto en V para todas las cadenas hash (por defecto=8.8) La sintaxis de ajuste por-cadena es la siguiente: :: [hash_chain.6] frequency = 650.0 voltage = 8.8 * *[hash_chain.6]* - Anula los ajustes globales para la cadena hash '6' * *frequency* - Anula la frecuencia de chip global en MHz para la cadena hash '6' (por defecto='hash_chain_global.frequency') * *voltage* - Anula el voltaje global en V para la cadena hash '6' (por defecto='hash_chain_global.voltage') *********************************** Control de Temperatura y ventilador *********************************** Modo Control de Temperatura =========================== Braiins OS soporta control automático de temperatura (utilizando el `controlador PID `__). El controlador puede operar en uno de tres modos: - **Automatic** - El software del minero intenta regular la velocidad del ventilador para que la temperatura sea aproximadamente la target temperature (que puede ser configurada). El rango de temperatura permitido es 0-200 grados Celsius. - **Manual** - Los ventiladores se mantienen a una velocidad fija, definida por el usuario, sin importar la temperatura. Esto es útil si se tiene una forma propia de enfriar el minero o si los sensores de temperatura no funcionan. La velocidad permitida es entre 0%-100%. La unidad de control monitorea solo temperaturas hot (caliente) y dangerous (peligrosa). - **Disabled** - **ADVERTENCIA**: ¡esto podría dañar el dispositivo porque no se hace ningún control! El modo control de temperatura puede cambiarse en la página *Miner -> Configuration* o en el archivo de configuración ``/etc/bosminer.toml``. **Advertencia**: mal ajustar los ventiladores (bien sea por apagarlos o por usar un nivel muy lento, o colocar una target temperature muy alta) podría **DAÑAR** de forma irreversible su minero. Limites de temperatura por defecto ================================== Los limites de temperatura por defecto están ajustados para prevenir que el minero se sobre-caliente y se dañe. * **Target temperature** es una temperatura que el minero intentará mantener (*por defecto es* **89°C**). * **Hot temperature** es un límite en la cual los ventiladores comenzarán a girar al 100% (*por defecto es* **100°C**). * **Dangerous temperature** es un límite en el cual BOSminer se apagará para prevenir sobre-calentar y dañar el minero (*por defecto es* **110°C**). Los límites por defecto de temperatura pueden ajustarse en la página *Miner -> Configuration* o en el archivo de configuración``/etc/bosminer.toml``. Configuración de Control de Temperatura y ventilador en ``bosminer.toml`` ========================================================================= Los valores por defecto pueden anularse al editar las líneas correspondientes en el archivo de configuración, ubicado en ``/etc/bosminer.toml``. La sintaxis es la siguiente: :: [temp_control] mode = 'auto' target_temp = 85 hot_temp = 95 dangerous_temp = 105 * *mode* - Ajusta el modo de control (por defecto='auto') * *target_temp* - Ajusta la temperatura en Celsius (por defecto=89.0). ¡Esta opción SOLO se usa cuando 'temp_control.mode' está en 'auto'! * *hot_temp* - Ajusta la temperatura caliente en Celsius (por defecto=100.0). Cuando se alcanza esta temperatura, la velocidad del ventilador se pone a 100%. * *dangerous_temp* - Ajusta la temperatura peligrosa en Celsius (por defecto=110.0). Cuando se alcanza esta temperatura, ¡el minado se apaga! **ADVERTENCIA:** ¡fijar muy alto este valor puede dañar el dispositivo! :: [fan_control] speed = 100 min_fans = 1 * *speed* - Ajusta una velocidad de ventilador fija en % (por defecto=70). ¡Esta opción NO se usa cuando *temp_control.mode* está 'auto'! * *min_fans* - Ajusta el número mínimo de ventiladores requeridos para que corra BOSminer (por defecto=1). * Para completamente **deshabilitar control de ventilador**, coloque 'speed' y 'min_fans' en 0. Operación de ventilador ======================= 1. Al iniciarse los sensores de temperatura, se activa el control de ventilador. Si los sensores de temperatura no están funcionando o leen una temperatura 0, los ventiladores se ponen automáticamente a máxima velocidad. 2. Si el modo actual es "velocidad fija de ventilador", el ventilador se pone a la velocidad dada. 3. Si el modo actual es "control de ventilador automático", la velocidad de ventilador es regulada por la temperatura. 4. En caso de que la temperatura del minero esté por encima de *HOT temperature*, los ventiladores se ponen a 100% (incluso en el modo de velocidad fija de ventilador). 5. En caso de que la temperatura del minero esté por encima de *DANGEROUS temperature*, BOSminer se apagará (incluso en el modo de velocidad fija de ventilador). ************ Password SSH ************ Puede poner el password del minero via SSH desde un host remoto al correr el comando de abajo y reemplazar *[passwordnuevo]* con su propio password. * Nota: Braiins OS **no*** mantiene el historial de los comandos ejecutados. .. code:: bash ssh root@[minero-hostname-o-ip] 'echo -e "[passwordnuevo]\n[passwordnuevo]" | passwd' Para hacer eso en muchos hosts en paralelo podría usar `p-ssh `__. ****************** Dirección MAC e IP ****************** Por defecto, la dirección MAC del dispositivo se mantiene igual y es heredada del firmware (de serie o Braiins OS) almacenada en el dispositivo (NAND). De esta forma, una vez que el dispositivo inicie con Braiins OS, tendrá la misma dirección IP que tenía con el firmware de fábrica. By default, the device’s MAC address stays the same as it is inherited Alternativamente, puede especificar una dirección MAC de su selección al modificar el parametro ``ethaddr=`` en el archivo ``uEnv.txt`` (ubicado en la primera partición FAT de la tarjeta SD).