DEV Community: Nicolás Avila

Introducción a los teclados mecánicos: Modificando el Keychron K6

Nicolás Avila — Sat, 17 Jul 2021 19:52:54 +0000

Disclaimer 1: Las técnicas y materiales descritos perfectamente pueden funcionar en otros modelos de teclados mecánicos. Procura que tus switches sean hot-swappables (no sean soldados a la placa base, es decir, se puedan desmontar sin necesidad de desoldar) 👀

Disclaimer 2: Todo el proceso toma aproximadamente 4hrs. Te recomiendo hacerlo con tiempo, acompañado de un rico ☕ o 🍺.

Disclaimer 3: No estoy afiliado a ninguna tienda en particular. Comparto solo los lugares donde encontré los materiales para hacer mas expedito el proceso de modding.

Disclaimer 4: Un teclado mecánico no te hará ser un mejor programador. Solo la práctica, estudiar, compartir con tus seres queridos y descansar lo suficiente lo harán 😄

Disclaimer 5: El proceso de modificación de tu teclado Keychron K6 puede inhabilitar su garantía ⚠️. Procura modificarlo bajo tu propio riesgo. devsChile no se responsabiliza por la ejecución inadecuada del proceso de modificación.

Introducción

Teclados mecánicos: el tema candente del momento ⌨️.
No todos buscan un teclado mecánico movidos por un mismo objetivo. Algunos buscan un teclado para jugar, otros para ensamblar y dar rienda suelta a su creatividad (visiten el channel #diy de devChile si es así), otros para coleccionar y otros solo para diversión. Cualquiera sea el motivo: seas bienvenido a este hobbie 🎉.
Hace algunos años buscaba acceder a un teclado mecánico para recordar ese sonido que tenían los teclados de la época dorada de la computación (ese sonido característico de los 90s). Finalmente decidí ir por un Keychron K6 y no me arrepiento de nada. El teclado se siente bastante sólido y no me ha dado problemas hasta el momento. Incluso compré un set de teclas personalizadas para cambiar las que trae por defecto (muy motivado! 💪).
En ocasiones los materiales y configuraciones de fábrica de los teclados no son los óptimos. Esto hace que suenen más de lo normal o se sientan más "huecos".
El objetivo de esta guía es enseñar paso a paso la modificación de un teclado Keychron K6, partiendo por la modificación de su cuerpo al añadir espuma acústica, para así finalizar con la modificación de los switches.

Si tienes alguna consulta del proceso, no dudes en dejar tu pregunta en la sección de comentarios.

Partes del teclado

Para los que estamos partiendo en los teclados mecánicos (y me incluyo) este es un problema, ya que hay una cantidad importante de conceptos que manejar primero. Pero no desesperen! Recopilé los más importantes que nos permitirán trabajar con nuestro teclado sin problemas 😄

Switch mecánico

Los switches son una de las partes más importantes de nuestro teclado, ya que determinarán como será la experiencia al momento de escribir.
Los hay de varios tipos marcas y calidad, pero su objetivo primario es solo uno: cerrar un circuito. Mandar la señal eléctrica correspondiente a la tecla que queremos activar.
Existen distintos tipos de switches, pero todos caen en la misma categoría con ligeras variaciones.
A continuación revisaremos los tipos generales así como sus partes.

Tipos

Rojos (lineales): No poseen feedback ni resistencia alguna al presionarlos. No poseen un sonido click característico. Ideal para gamers.
Cafés (táctiles): Poseen un ligero feedback al momento de presionarlos. No poseen un sonido click característico. Ideal para personas que escriben mucho en el teclado.
Azules (clicky): Poseen un feedback bastante notorio al momento de presionarlos. Adicionalmente, poseen un sonido click característico. Ideal para personas que quieren escuchar un click audible al momento de presionar las teclas.

Y los otros switches de colores que salen en la imagen? Son del la misma clasificación previamente descrita, pero con ligeras diferencias (lineales, táctiles y clicky). Si deseas conocer más sobre los detalles técnicos de cada uno te recomiendo leer esta guía en el blog oficial de Keychron

Partes

Tecla (keycap): En estricto rigor esto no es parte de un switch, pero si es una pieza que interactúa directamente con él. Las hay de varios tipos de materiales y calidad. Las que vienen en el K6 son muy buenas 😄
Rama (stem): Es el lugar donde descansa la tecla. Esta parte descansa a su vez sobre un resorte, que permite volver la rama (y por ende a la tecla) a su estado original.
Carcasa superior (upper housing): Corresponde a la tapa superior de un switch. Mantiene todas las piezas en su lugar.
Resorte (coil spring): Permite devolver la rama del switch a su posición original una vez se ha presionado. Los hay de distintos tipos de resistencia, lo que influye mucho en la experiencia de escritura al momento de presionar un switch.
Carcasa inferior (bottom housing): Corresponde a la tapa inferior del switch. Posee lugares por donde se desliza la rama, así como una prolongación interna para poner el resorte y los puntos de contacto
Puntos de contacto: Corresponde al lugar que hace contacto con la PCB y que permite cerrar el circuito eléctrico para activar una tecla en particular.

El teclado

El cuerpo del teclado posee partes que son estándar en la gran mayoría de las marcas y modelos.
A continuación listo las partes más frecuentes:

Marco: Presente en algunos teclados. De diferentes materiales y calidad, pero su objetivo es estético la gran mayoría de las veces.
Placa de montaje de switches: Como su nombre lo indica, permite montar los switches en los agujeros de las PCB. Los hay de muchos materiales (plásticos, aluminio, bronce, policarbonato, etc). Entrega cierto rango de flexibilidad al presionar las teclas.
Estabilizadores: Los estabilizadores permiten evitar el traqueteo en teclas más largas (como Caps Lock o el Space Bar). Están compuestos por una pieza de alambre, unida a dos switches especiales (no poseen las mismas partes que un switch). Estos componentes también requieren lubricación. Sin embargo, no abordaremos el procedimiento en esta guía (yo dejé los míos con la lubricación por defecto).
PCB: Corresponde al corazón del teclado. Permite montar los contactos de los switches para así cerrar los circuitos y activar una tecla deseada. Poseen normalmente una interfaz USB (A, micro USB o C). Algunas placas también soportan Bluetooth. Existen modelos de placas que tienen LEDs, que entregan bonita iluminación con distintos efectos y frecuencias de animación (normalmente programable).
Carcasa inferior: Permite mantener todas las piezas en su lugar. En esta parte descansa la PCB y en los teclados con soporte Bluetooth, también almacena la batería.

El esquema utilizado para mostrar las partes del teclado no corresponde a un Keychron K6. Sin embargo, es una buena ilustración para mostrar las partes mas importantes.

Materiales y herramientas

Manos a la obra! Ahora es tiempo de juntar todos los materiales y herramientas necesarios para comenzar el proceso.
A continuación detallo una lista de cada uno, así como las herramientas que utilizaremos:

Materiales

Espuma de aislación acústica adhesiva (aquí)
Krytox 105G (aquí)
G-Lube (aquí)
Filme de switches (aquí)
Tapa de refresco
Papel secante
Plasticina (si, really)

Herramientas

Superficie para cortar
Abridor de switches (aquí)
Plumón permanente
Bisturí para maquetas
Tijeras
Extractor de switches (aquí. Se puede utilizar el que viene con el K6)
Pincel fino (aquí)
Extractor de Keycaps (aquí. Se puede utilizar el que viene con el K6)
Pinzas de precisión (aquí)
Destornilladores (aquí)

Paso 1: Preparación

Lo primero es contar con un lugar cómodo donde trabajar. El proceso total dura alrededor de 4 horas, por lo que estar bien ubicado es parte esencial. Lo segundo es contar con una superficie que se pueda ensuciar y limpiar fácilmente. Las manchas dejadas por lubricantes de teclados mecánicos cuesta eliminarlas, por lo que te recomiendo tener una superficie que puedas ensuciar sin culpa (así como la ropa adecuada en caso que ocurra algún accidente).

Paso 2: Remover los keycaps

Los Keychron K6 traen un extractor de keycaps incorporado. Es bastante bueno, por lo que pueden utilizar el que viene de fábrica. Como mis herramientas las adquirí por Amazon, utilicé ambos removedores de Keycap.

Personalmente no uso los keycaps que trae por defecto el Keychron K6. Si te interesa el modelo que utilizo (YMDK ANSI Dye Sub Carbon Keyset), puedes revisar el siguiente link.

Paso 3: Remover los switches

Los K6 también traen un extractor de switches, aunque este no es de muy buena calidad, ya que es pequeño y difícil de manipular. Acá recomiendo utilizar uno similar al de la imagen anterior, dado que es mucho más fácil poder extraer un switch con una herramienta más larga.

Paso 4: Desarmar los switches

Para poder desarmar un switch puedes hacerlo de dos maneras:

Manualmente: Es la forma mas complicada, dado que debes abrir con mucho cuidado cada una de las patas de la carcasa inferior de un switch para así desarmarlo.
Abridor de switches: Esta es la forma más fácil. Es una herramienta dedicada para abrir switches. Los hay de varios tipos, materiales y calidades. El proceso para desarmar un switch utilizando la herramienta dedicada es muy fácil. A continuación detallo el proceso:

Alinear las patas de la carcasa superior

Se deben alinear las patas de la carcasa superior con las patas del abridor de switches tal como muestra el área demarcada en verde.

Presionar

Sobre una superficie estable, presiona tu dedo sobre la rama del switch con fuerza moderada. Esto ocasionará que la carcasa superior del switch se desprenda, permitiendo extraer cada una de sus partes.

Paso 5: Clasificar las partes

Dado que vamos a trabajar con muchas partes pequeñas lo más recomendable es utilizar bolsas plásticas para separar cada una de las partes y así no perderlas. Para ello he utilizado bolsas sellables.

Paso 6: Abrir el marco externo

Una vez que tenemos clasificadas las partes de nuestros switches es hora de modificar el cuerpo de nuestro Keychron K6. Para ello debemos acceder a la parte interna de la carcasa inferior.
Utilizaremos un destornillador hexagonal para sacar los tornillos de las secciones laterales del cuerpo de nuestro teclado. Ello nos permitirá sacar y deslizar hacia un costado las partes de aluminio del teclado.

Paso 7: Desatornillar la placa de montaje

Cuando se han sacado los marcos externos, es hora de ir por el marco interno o placa de montaje. La placa de montaje de los switches del Keychron K6 es metálica y de buena calidad.
Debemos identificar cada uno de los tornillos y extraerlos con mucho cuidado.

No está de más decir que es muy importante que almacenen los tornillos del teclado en un lugar seguro durante el proceso de modificación 😬.

Paso 8: Desconectar el cable de la batería

Cuando hemos extraído la placa de montaje se puede acceder a la PCB del teclado.
En la parte inferior de la placa encontraremos un conector a la batería el cual debemos extraer con mucho cuidado con unas pinzas de precisión.
Se debe dejar la PCB del teclado a un lado para solo quedar con la carcasa inferior y la batería en ella. La batería viene pegada a la carcasa inferior.

Paso 9: Preparar y cortar la espuma

Este paso es ensayo y error! Pero es posible acercarse mucho al resultado deseado con algunas medidas previas.
Según leí en los foros y comunidades, la mayoría de las personas utiliza espuma de embalaje de unos 3mm de espesor. En este punto quise improvisar un poco y encargué por Amazon una espuma de aislación acústica autoadhesiva SilverStone Technology EPDM usada para insonorizar gabinetes de PC. Debo decir que me gustó mucho usar este material, ya que la espuma es de muy fácil manipulación y es capaz de comprimirse ante la fuerza ejercida. Esto facilita otorgar cierta flexibilidad a la placa de montaje al momento de escribir. En el paquete vienen 2 pliegos, que podrán utilizar para modificar muchos teclados!.

Se debe cortar un rectángulo de 30cm ancho x 10cm de alto, el cual servirá de base para ir modificando de acuerdo a sus necesidades.

La carcasa inferior posee unas ramas donde los tornillos de la placa de montaje de switches quedan encajados, por lo que es necesario considerar estos cilindros al momento de cortar la espuma. Para ello recomiendo utilizar pequeñas bolitas de plasticina que se deben colocar sobre cada rama de tornillo. Luego, con un plumón permanente, se debe marcar un pequeño punto sobre cada bolita. Inmediatamente y antes que se seque por completo la tinta se debe presionar el rectángulo de espuma previamente cortado sobre las bolitas de plasticina, para que así estas actúen de estampa sobre la superficie autoadhesiva de la espuma acústica. De esta manera se puede saber donde cortar un cuadrado, para que las ramas de los tornillos pasen a través de la espuma sin inconvenientes.

Paso 10: Pegar la espuma

La ventaja de la espuma Silverstone es que posee una película autoadhesiva. Es muy fácil pegarla en el teclado una vez haya sido cortada.
Es necesario procurar no dejar espuma sobre la batería, ya que esto puede traernos problemas al momento de armar nuevamente el teclado.

Paso 11: Volver a armar el teclado y encenderlo

Ya hemos terminado con el proceso de modificación del cuerpo del teclado. Ahora debemos conectar nuevamente la batería, poner la PCB en su lugar y volver a atornillar la placa de montaje de los switches sobre la PCB para poder continuar.
Si todo sale bien, el teclado debiese encender sin problemas 💚.

Paso 12: Lubricar los resortes

La lubricación de los resortes de nuestros switches se lleva a cabo con el lubricante Krytox 105G. El proceso es bastante sencillo: simplemente se deben verter de 10 a 15 gotas de lubricante dentro de la bolsa utilizada para separar los resortes. Se debe sellar la bolsa para evitar fugas. Una vez listo el proceso se debe agitar vigorosamente hasta que el lubricante quede uniformemente aplicado a cada resorte.

Paso 13: Lubricar los switches

Esta es la parte más importante de todo el proceso, ya que determinará el sonido final que va a tener nuestro teclado. Te recomiendo seguir las recomendaciones al pie de la letra, para que así no te encuentres con resultados acústicos no deseados.

Importante: En la búsqueda de información de lubricantes para switches leí que la mezcla óptima para switches lineales era utilizar Krytox 205G + Krytox 105G. Sin embargo yo compré G-Lube de Gloriuous Gaming y, adicionalmente, utilizo switches táctiles 😓. En la preparación de la mezcla sinceramente improvisé mucho. Sin embargo, estoy muy contento con los resultados, aunque la mezcla no se vea muy "bonita" de aplicar.

Preparación de la mezcla

En una tapa de refresco, vierte una pequeña cantidad de G-Lube (un cuarto del tamaño de una arveja), seguido por un par de gotas de Krytox 105G (unas 5 - 6 gotas). Mezcla ambos lubricantes con el pincel hasta que la textura sea similar a la de la imagen.
La aplicación de lubricante sobre las partes del switch se debe hacer con una película delgada, evitando dejar grandes cantidades y evitar la formación de grumos.

Lubricar la rama

Con una herramienta de sujeción o pinza, toma la rama por la parte donde hace contacto con la tecla. Luego procede a aplicar una fina película de lubricante por el área coloreada de rojo. Evita a toda costa lubricar la extensión inferior de la rama que hace contacto con la carcasa inferior del switch, dado que puedes ocasionar que se escuche un sonido no deseado al presionarlo.

Lubricar la carcasa inferior

Con una herramienta de sujeción o pinza, toma la carcasa inferior por uno de sus bordes. Luego procede a aplicar una fina película por los patines donde se desliza la rama, tal como muestra el área coloreada de rojo. Procura también lubricar con el restante de material que queda en el pincel el cono que recibe la extensión de la rama solo por la parte exterior (tal como muestra el área demarcada en rojo). No apliques lubricante por el área interior, dado que esto puede provocar un sonido no deseado al momento de presionar el switch.

Paso 14: Agregar el filme a cada switch y cerrarlo

El paso final de modificación del switch es agregar un filme de switch entre la carcasa superior e inferior.
Se debe agregar cuidadosamente con una pinza de precisión en el lugar indicado por la imagen. El filme debe quedar alineado correctamente entre la carcasa superior e inferior

Paso 15: Volver a armar el switch

Para volver a armar un switch con sus partes ya lubricadas se deben realizar los siguientes pasos:

Dejar la carcasa inferior del switch sobre el abridor de switches con el filme de switch en su posición final.
Con una pinza de precisión, poner el resorte lubricado sobre el cilindro en la carcasa inferior del switch.
Con una pinza de precisión, poner la rama del switch sobre el resorte. Se deben alinear las paredes laterales de la rama con los patines de la carcasa inferior, donde se deslizan (recordar que ambas superficies deben estar lubricadas). Procura que las prolongaciones de la rama (las que interactúan con los contactos) miren a la parte posterior.
En la mano, posiciona las patas de la carcasa superior sobre la carcasa inferior y aplica presión para cerrar el switch. Debes cerciorarte que el filme quede alineado entre ambas partes.

Una superficie de lubricación de switches es una herramienta que puede facilitar mucho este proceso. Pueden encontrar de varias marcas y calidades en Amazon o Aliexpress.

Paso 16: Volver a montar los switches y probar

Los switches ya lubricados se dejarán en una bolsa con cierre hermético para almacenarlos temporalmente.
Una vez termines de lubricar cada uno, el siguiente paso es montarlos en la PCB.
En este paso se debe tener extremo cuidado en no doblar los puntos de contacto con los socket hot-swapables, sino el switch no cerrará el circuito y no enviará la señal eléctrica. Tu tecla quedará inutilizada :sad:.
Si esto te llegase a ocurrir, con mucho cuidado, endereza la pata del punto de contacto con una pinza de precisión.

Es muy importante que se tenga mucho cuidado al volver a montar los switches en los sockets de la PCB, dado que en ocasiones los pines pueden doblarse si no encajan bien. Asegúrense de probar el funcionamiento de todas las teclas una vez terminado este proceso.

Como saber más

Hay muchas comunidades en torno a los teclados mecánicos. Personalmente me uní a dos en Reddit en donde publican información constante: /r/MechanicalKeyboards/ y r/Keychron/.

Conclusiones

Aun me falta mucho por aprender de teclados mecánicos. Todo lo necesario para poder modificar mi teclado lo leí de foros o vi en YouTube. Pero como dicen en Chile "otra cosa es con guitarra".
Creo que mi mayor error fue la elección del lubricante, dado que el Krytox 105 y el G-Lube no se mezclan muy bien. En los videos que revisé, la mezcla la realizaban con 105G y 205G era mucho menos viscosa y grumosa... Pero bueno!, a mi me gustó como quedaron lubricados mis switches 😄.
Hubiese sido genial poder contar con una superficie de lubricación de switches durante este proceso. Creo que me hubiese facilitado mucho más la manipulación de las partes. Sin embargo, es un deseable, ya que perfectamente se puede completar el proceso sin esta herramienta.
El siguiente desafío será armar un teclado desde cero. Para eso comenzaré a comprar todas las piezas y kits por separados y tratar de armar uno por mi cuenta 😄.
Espero que esta guía te haya servido y que te motive a modificar tu teclado mecánico para ajustarse a tus necesidades!
Si encuentras un concepto errado o mal descrito, házmelo saber para así poder corregirlo.

Dual WAN: Cómo configurar failover de internet y no morir en el intento

Nicolás Avila — Wed, 02 Jun 2021 15:22:47 +0000

Importante: Este post está escrito teniendo en consideración Internet Service Providers (ISP) Chilenos. Sin embargo, el principio aplica para cualquier compañía de cualquier país.

Disclaimer: No estoy afiliado con ninguna marca ni retailer. Solo publico los modelos y dónde compré todo con el fin de hacer el proceso más rápido si quieren implementar una solución similar en sus hogares.

Introducción

Una de las ventajas de trabajar como programador/programadora es tener la posibilidad (en la gran mayoría de los casos) de realizar nuestras labores desde la comodidad de nuestro hogar. Para algunos esto puede ser mejor o peor, pero sin duda requerimos de algo muy importante: que no falle nuestro internet cuando más se requiere.
La pandemia ha puesto a prueba a los proveedores de internet y ha evidenciado, en la gran mayoría de los casos, que la infraestructura necesaria para brindar un buen servicio es muy precaria (si: a ti te estoy mirando VTR 👀).
Es por ello que, sin mucho conocimiento en redes (nunca he sido muy bueno para ello sinceramente. Me manejo en lo necesario para poder trabajar), decidí emprender el hermoso viaje de configurar una conexión redundante de internet en mi hogar. Lo que no sabía, era que no todo era llegar y conectar. Para alguien con muy pocos conocimientos en redes, esto puede ser desafiante, pero el objetivo es poder compartir mi experiencia y disminuir la brecha para que puedan lograr lo mismo por su cuenta.
En este post compartiré mis hallazgos, materiales necesarios, así como consejos para hacer este camino menos tortuoso para otras personas. Si ves que algún concepto no está correctamente explicado o errado, por favor házmelo saber para poder corregirlo 😄.

¿Qué es el Internet Failover?

Básicamente es un método que nos permite levantar una conexión secundaria de internet (de forma automática) en caso de fallo de una conexión primaria. Como su descripción lo indica, esto requiere tener de dos conexiones contratadas. En mi caso particular tengo lo siguiente:

Un plan con VTR: Lamentablemente es la única compañía que tiene factibilidad técnica en mi edificio. Si bien, tengo el plan más alto (no es fibra óptica), la experiencia normalmente no es muy buena.
Un plan con WOM: Este plan que contraté es de "Banda Ancha Móvil". Me pasaron un dispositivo pequeño, que sirve como "WiFi Hot Spot". Lamentablemente este dispositivo no tiene ningún puerto RJ45, por lo que tendría que arreglármelas para poder dejarlo como mi conexión secundaria de internet.

Problemas y planificación

Los problemas que tenía eran los siguientes:

La conexión de internet en mi hogar era muy inestable. Tenía muchos problemas de continuidad de internet: mis reuniones se caían frecuentemente 😠, las clases de mis hijos se interrumpían y venían reclamando cuando estaban en medio de sus partidas de Fortnite en los tiempos libres (tragedia)😅.
La pieza de mis hijos tenía muy mala cobertura de señal WiFi, por lo que normalmente los veía jugando cerca del dintel de la puerta para agarrar mejor señal. Intentamos con un repetidor, pero sin muy buenos resultados.

Para poder abordar ambos problemas, decidí ir por una solución que me permitiese tener un enlace redundante de internet y mejor calidad de Wi-Fi (así como lo hacen las empresas, pero en escala infinitamente más pequeña).
Eso si me di cuenta que no sabía mucho del tema. Siempre he utilizado routers inalámbricos de nivel usuario, pero configurar una conexión failover de internet requería que estudiase más de
algunas cosas (WAN, LAN, Balanceo de carga, DHCP, etc). Literalmente estaba como el perrito del popular meme:

Para poder nivelar un poco los conocimientos, decidí ver algunos videos en Youtube. El canal de NetworkChuck me sirvió mucho (y aparte explica de forma muy entretenida).
Luego de adquirir algo de bagaje técnico, hice un plano de lo que tenía en mente:

La conexión primaria de internet (VTR) viene por un cable UTP de varios metros al segundo piso, donde toda la familia habita.
La conexión secundaria de internet (WOM, inalámbrica) se debe utilizar solo en caso de falla de la conexión primaria
Un dispositivo debe poder determinar cuando una conexión falla, para así activar una u otra.
Se necesita conectar mi PC mediante LAN y un Access Point para dar Wi-Fi a todo el piso.

Paso 1: Adquirir el equipo necesario

Me di cuenta que para poder continuar con mi proyecto, necesitaba adquirir algo de equipamiento. Luego de investigar y cotizar un poco, di con los dispositivos que necesitaba adquirir.

1 Router LTE: Este router permitirá utilizar una SIM Card que tiene contratado el plan de Internet Móvil. Tiene antenas que utilizará para captar la señal LTE. El dispositivo que me entregó la compañía lamentablemente no tenía un puerto RJ45 para poder utilizarlo de una mejor forma. Elegí el modelo D-Link 4G N300 LTE. Lo adquirí en el siguiente vínculo.
1 Router / Load Balancer: Este router permitirá balancear las conexiones de internet. No tiene antenas, solo puertos para conectar otros cables, por lo que no me sirve para darle WiFi a la casa. Elegí el modelo TP-Link TL-R470T. Lo adquirí en el siguiente vínculo.
1 Switch: Este equipo permitirá conectar mi computador, el access point y cualquier otro equipo que requiera conexión por cable. Decidí ir por uno auto-administrado. Elegí el modelo TP-Link TL-SF1005P. Lo adquirí en el siguiente vínculo.
1 Access Point: Este equipo permitirá conectar todos mis dispositivos Wi-Fi y entregar internet inalámbrico a los computadores de la casa y dispositivos de la casa (tablets y smart devices). Elegí el modelo TP-Link EAP225. Lo adquirí en el siguiente vínculo.

Paso 2: Cables

Me fui por lo básico: construir mis propios cables 😅. Nunca antes había construido cables UTP, por lo que fue toda una experiencia aprender a hacerlo (ni les digo cuantos metros de cable hice mal, pero después le agarré el ritmo 💪). Necesitaba construir varios de diferentes longitudes, por lo que decidí comprar un cable pre-armado de 20 metros y ese usarlo para construir cables más cortos. También pueden adquirirlos ustedes si no quieren construir los suyos.

Existen varias categorías de cables. Particularmente utilicé un Cat5 el cual corté en varios cables mas pequeños y agregué los conectores RJ45 en cada extremo utilizando una herramienta para crimpear (es como un alicate especial que permite armar los cables).

Si van a armar sus propios cables recuerden siempre probarlos!. Para ello pueden adquirir un tester de cables UTP y ver que todas las luces enciendan en el orden correcto. La siguiente imagen muestra como no deben quedar los cables:

Paso 3: Configuración y conexión

Ya era hora de la parte entretenida: empezar a conectar cables a los dispositivos y ver las luces parpadear.
Luego de leer muy poco las instrucciones, lógicamente nada funcionaba, así que decidí partir de 0 y empezar a configurar dispositivo por dispositivo

Configurando el Router 4G LTE: D-Link 4G N300 LTE

Lo primero que hice fue configurar mi conexión secundaria de internet. Saqué el chip del dispositivo que me entregó la compañía WOM y lo agregué en este dispositivo. La siguiente imagen muestra como debiese quedar.

Una vez puesto el chip, era hora de prender el dispositivo. Para poder ingresar al panel de administración, conecté mediante cable de red mi computador y este router. Abrí una consola, revisé cual era la puerta de enlace predeterminada e ingresé al panel de configuración.

Si están en Windows, lo que deben escribir en una terminal es ipconfig /all

Lo primero será cambiar el segmento de IP de este router, para así evitar cualquier posible conflicto de IP. Esto se logra en "Settings > LAN", donde debemos ingresar lo siguiente:

IP Address: Ingresar "192.168.1.254"
Subnet Mask: Ingresar "255.255.255.0"

Hacemos click en "Save and Apply". La siguiente imagen muestra como debiese quedar:

Tendremos que ingresar nuevamente al panel de administración del router, ya que le acabamos de cambiar su dirección IP. En el navegador se debe ingresar a la dirección "192.168.1.254" para así entrar nuevamente.
El siguiente paso es la configuración de la conexión a internet móvil, para ello se debe ingresar a
Para poder conectarse al internet móvil WOM utilicé la siguiente configuración:

APN: ingresar "datacard"
IP Version: seleccionar "IPV4"
Marcar: "Manual APN"
Marcar: "NAT"

Es muy importante aquí utilizar los datos entregados, sobre todo el nombre de la APN, dado que la información de los APN disponibles en internet para WOM hacen referencia a su uso en celulares, más no en BAMs.

No quiero que este dispositivo emita señal Wi-Fi (para eso tenemos el access point 😄), por lo que apagaré las antenas. Con esto solo se podrá acceder a router vía ethernet. Para ello, debemos dirigirnos a "Settings > Wi-Fi"

Si todo sale bien, finalmente tendremos algo similar a esto:

Esquema de conexión:

La siguiente imagen muestra cual debe ser el esquema de conexión de nuestro Router 4G LTE:

Instrucciones: Conectar con un cable ethernet el puerto LAN1 del Router 4G LTE al puerto WAN2 del balanceador de carga.

Resumen y comentarios de la configuración de este dispositivo:

Cambiar la IP por defecto del router para evitar así conflictos de IP futuros.
Para que funcione bien el internet móvil se debe utilizar el APN "datacard".
Se ha deshabilitado el acceso por Wi-Fi. Solo es posible acceder conectando un cable Ethernet a uno de los puertos del router. Las antenas cumplirán la función de captar la señal 4G.
Es importante cambiar la contraseña de administrador por motivos de seguridad. Nada es más fácil y propicio a los ataques que tener un usuario y contraseña por defecto admin / admin.

Importante: Configurando este dispositivo me di cuenta que posee un modo de Failover para internet. Sin embargo no se si funciona de la misma manera (en cuanto a performance) que mi método. Si alguien se anima a probarlo, estaré atento 👀

Configurando el Balanceador de Carga: TP-Link TL-R470T

Este dispositivo es el más importante, ya que es el corazón de todo el proyecto, por lo que pondremos especial cuidado en realizar todas las configuraciones en orden.
El primer paso será cambiar la IP por defecto del dispositivo, para así evitar cualquier posible conflicto de IP. Nos dirigimos a la sección "Network > LAN", en el campo "IP Address" ingresaremos "192.168.2.1" y presionaremos el botón "Save". Tendremos que volver a ingresar al dispositivo, pero ahora bajo la nueva dirección que acabamos de configurar.

Luego, veremos la parte más importante que es configurar las dos conexiones de internet. Para ello nos dirigimos a "Network > WAN". En esa vista, dejaremos la opción "WAN Mode" en 2 y presionaremos el botón "Save".

Nos dirigiremos a la pestaña "WAN2" presionaremos el botón "Connect". Si todo sale bien, veremos algo similar a esto:

Ahora necesitaremos conectar nuestra conexión primaria de internet y configurarla. Para ello se debe conectar un cable Ethernet entre el modem (VTR en mi caso) y el puerto "WAN1" del balanceador de carga. El siguiente esquema muestra como debe quedar:

Volveremos a la sección anterior y esta vez nos dirigiremos a la pestaña "WAN1". Presionamos el botón "Connect". Si todo sale bien, veremos algo similar a esta imagen:

Importante: Es necesario que ambas WANs estén en segmentos de red distintos, sino no va a funcionar (o al menos a mi no me funcionó). Por ejemplo: VTR en segmento 192.168.0.XXX y WOM en segmento 192.168.1.XXX.

Ya tenemos configuradas las dos conexiones a internet 🎉. Ahora solo nos falta configurar el failover, es decir, cuando la conexión primaria no esté disponible, debe automáticamente subir la segunda. Para ello nos dirigimos al menu "Transmission > Load Balancing". En esta pestaña haremos click sobre la opción "Enable Load Balancing" y presionaremos el botón "Save"

Luego en la pestaña "Link Backup" haremos click sobre el botón "Add". En los campos nuevos ingresaremos:

Primary WAN: WAN1
Seconday WAN: WAN2
Mode: Failover (Enable backup link when any primary WAN fails).
Status: Enable

Está listo el failover! 🎉. Hagamos una prueba! En la terminal de sistema escriban ping -t devschile.cl y esperen un par de pings. Luego, desconecten el cable desde el puerto WAN1 y TA-DA! Mágicamente comenzarán a tener nuevamente internet automáticamente después de un par de pings perdidos. Por qué sucede esto? Porque recuerden que hemos configurado el link failover en nuestro dispositivo: si la conexión primaria cae, inmediatamente sube la segunda.

Resumen y comentarios de la configuración de este dispositivo:

Cambiar la IP por defecto del balanceador de carga para evitar así conflictos de IP futuros.
Cambiar la contraseña por defecto de administración.
Se debe configurar previamente los WANs 1 y 2 antes de configurar el Link Backup.

Conectando el switch: TP-Link TL-SF1005P

Aun no hemos terminado con todos los objetivos propuestos inicialmente. Recuerden que aun mis hijos tienen muy mala señal Wi-Fi y toda la instalación hasta el momento considera cables LAN. Necesitamos poder configurar un switch que nos permita:

Conectar el access point.
Conectar mi PC del trabajo (objetivo reciente 😄).

Para ello debemos seguir el siguiente esquema de conexión:

Conectar un cable desde el puerto WAN3 del balanceador al puerto LAN5 del switch
Conectar un cable desde el puerto LAN1 del switch al puerto principal del access point.
Conectar un cable desde el puerto LAN2 del switch al puerto principal del PC.

Importante: Hemos utilizado el puerto WAN3 del balanceador de carga porque el WAN Mode del balanceador está en 2. Esto quiere decir que solo los primeros dos puertos están en modo WAN, el resto se puede utilizar como LAN.

Configurando el Access Point: TP-Link EAP225

Este es último paso de la configuración. Debemos conectar el cable de red desde el puerto LAN1 al puerto principal de este dispositivo. Se va a prender automáticamente. Por qué ocurre esto? Porque este dispositivo obtiene corriente mediante el mismo cable de red (Power Over Ethernet o PoE)

La configuración del access point es bastante sencilla. Básicamente se debe configurar la(s) SSID(s) para que los dispositivos puedan conectarse mediante Wi-Fi. Para ello nos dirigimos a "Wireless > Wireless Settings" y configuramos una nueva red. Se debe elegir el tipo (1. 2.4Ghz o 5Ghz), luego presionar sobre el botón "Add" (2) y finalmente llenar los campos necesarios para la nueva red (3).

A modo de ejemplo, la siguiente imagen muestra la creación de una red llamada HUEMUL.

Esquema final de la topología de red

Ya hemos configurado todo lo necesario. Ahora ya tendremos conexión redundante de internet y no tendremos que preocuparnos más por los problemas de conexión. La siguiente imagen muestra como debiese quedar todo conectado.

Conclusiones

Este proyecto ha sido de gran ayuda para mejorar la calidad de internet en casa y un gran aprendizaje personal. Nunca he tenido muy buenos cimientos de redes y esto me obligó a estudiar un poco más al respecto.
Configurar internet failover no es del todo complejo, pero si requiere estar atento a algunos detalles.
Espero que esta guía les haya sido de utilidad y les guste tanto como a mi me gustó redactarla 🎉

How to validate your Jenkinsfile locally before committing

Nicolás Avila — Sat, 20 Mar 2021 18:58:52 +0000

Background

Continuous integration and deployment is a fun topic. I've learned a lot recently working on some projects at my actual job.
The task can be a little intimidating sometimes, specially if you work with Jenkins. Don't get me wrong! Jenkins is an amazing tool. I just find the learning curve a little bit steeper compared to other solutions I've tried (Github Actions, Gitlab CI/CD Pipelines, Buddy.works, etc).

If you're not familiar with Jenkins, it's an open-source CI/CD automation suite really popular in enterprise environments.
To execute instructions, Jenkins uses an especial file called Jenkinsfile. You can use two flavors:

Declarative Syntax: A relatively new way to write pipeline instructions (first added in version 2.5 of "Pipeline Plugin"). More information here.
Scripted Syntax: The traditional way to write pipelines. This option strictly uses Apache Groovy Lang syntax to declare every step of the pipeline.

The Jenkinsfile

When you work with Jenkins you have two choices to automate your pipelines:

Working with an inline pipeline
Working with a Jenkinsfile.

This is a very summarized example of how a Jenkinsfile looks:

pipeline {
  agent any

  stages {
    stage("This is stage 1") {
      steps {
        // Cool stuff goes here!
      }
    }

    stage("This is stage 2") {
      steps {
        // Cool stuff goes here!
      }
    }
  }
}

I'm not going to explain the sections of the file here, but you can check this amazing video by TechWorld by Nana: Complete Jenkins Pipeline Tutorial | Jenkinsfile explained

The recommendation is to work with a standalone Jenkinsfile because the steps to build, test and deploy your code will belong to the repository and can be versioned.

The problem

Every time that I'm working on a Jenkinsfile I make mistakes! 😓. The problem is: you need to commit and push those changes every time, run the pipeline and check if (this time) the pipeline will run. This adds unnecessary git history with syntax fixes (personally, I really hate writing 5 commits messages like "fix(jenkins): syntax typo"). How you can avoid it? Well, the solution comes to use an extension of VS Code 😄.

Validating Jenkinsfile with Visual Studio Code

You will need:

A Jenkins Server
User credentials to Jenkins Server
Visual Studio Code installed on your PC.
Jenkins Pipeline Linter Connector for Visual Studio Code.

First, you need to install Jenkins Pipeline Linter Connector extension in your Extension panel (Ctrl + Shift + X in Windows and Cmd + Shift + X in macOS)

Once the installation process is finished, you need to configure it. Go to the Settings section in VS Code (Ctrl + , in Windows and Cmd + , in macOS). In the "Search settings" field write "Jenkins".
Complete the fields below:

Connector Pass: Enter your Jenkins user password here.
Connector URL: Enter your Jenkins server URL here as the format below shows:

https://<JENKINS SERVER URL>/pipeline-model-converter/validate

Connector User: Enter your Jenkins username here.

And that's it! Now you can lint your Jenkinsfile syntax by checking it against your remote Jenkins Server Linter 😄. To use it, open your Jenkinsfile and open the Command Pallette and write "Validate Jenkins"

If the syntax of your file is valid, you'll have a message similar to this in the Output tab.

Conclusions

Validating your Jenkinsfiles in your local environment can really improve the time you spent on writing pipelines. You can avoid common mistakes by simply validate the syntax regularly using the Jenkins Pipeline Linter Connector Extension for VS Code.

Closing

Thank you for reading my post. You can follow me on Twitter or if you like to support me you can also buy me a coffee ☕.

References

Using Loupedeck Live to enhance your developer experience

Nicolás Avila — Sun, 07 Mar 2021 20:34:08 +0000

Disclaimer: I don't have any commercial affiliation with Loupedeck. I just think is an awesome tool 😄

Recently I bought a Loupedeck Live with aims to enhance my developer workflow. After several weeks of use I cannot recommend it enought!. It's just an amazing tool that will improve your speed and make your developer experience easier.
In this post I'll share my thougts, tips and how to use it.

What is Loupedeck Live?

Loupedeck Live is a console made by Loupedeck, a company based in Finland. They make hardware for creative audience, to improve workflow used by content creators, photographers and artists.
The Live model consists on a surface with touch screen, dials and buttons that can be mapped to perform certain actions in a desired software. They have other models (CT, and +) that you can check on their official website.

What's lead me to use it for development? Well, I saw there's a developer program who able you to create your own plugins (more details below). I saw some videos on Youtube about custom usage with your own apps and I thought: "That's perfect! This mean I can control any software that uses hotkeys". I placed an order in Amazon and waited for the arrival of the package to my country to see how it works (I live in Chile, so it taked a while).

How it works

Loupedeck devices are composed by three components:

Hardware console: This is the physical controller to interact. Is build in very firmly plastic material. You have 6 dials that can be pressed and a touchscreen bar at each side. At the center of the device, you have three rows four touchscreen buttons. You can swipe left / right to change pages of control. At the bottom you have five buttons.
Software: The Loupedeck hardware doesn't work standalone. You need to install a proxy software that will map the actions on the hardware to the target application. Loupedeck comes with predefined applications to work. You can also create your own custom profile in order to control every app you want.
Target application to control: Is the targeted application you want control. You make sure your application has hotkeys combinations (ex: Cmd + Shift + D) or keyboard bindings.

Using Loupedeck with VS Code

To follow the steps below, you need a Loupedeck Live device and the Loupedeck software installed on your machine.

I work a lot with Visual Studio Code, so this is my first application I tried to map. To check the Keyboard Shortucuts you can press Cmd + K + Cmd + S (on macOS) or Ctrl + K + Ctrl + S (on Windows).

Here you can simply add a keyboard shortcut by pressing a desired command. For this example, I want to map the Docker view on VS Code using Ctrl + Shift + Alt + 1 (if you don't have the Docker extension installed, you can download it here).

First go to Keyboard Bindigs in Visual Studio Code.
In the search bar (1) write "docker view" and find the "View: Show Docker" row (2).

Press the plus icon (+) and press Ctrl + Shift + Alt + 1 (in order)

Open your Loupedeck software at your computer and go to "Application" > "Add Application".

In the Application section, select "VS Code" app. Fill the other fields as you want and click "Save" button.

To add a new custom action to VS Code, you need to press the plus (+) icon at the right of "Custom" in the section Press Actions (1). Then add a new action by fill the needed fields: In the Action name field enter "View docker". On the shortcut field, press Ctrl + Shift + Alt + 1 (in order)(2), then click the OK icon. To finish, press the "Save" button.

To finish, drag the recently created custom action to the touchscreen panel as the image shows.

And there you go! Every time you open VS Code, your Loupedeck Hardware will show the "View docker" action (make sure to have the Dynamic Mode enabled).

Extend Loupedeck Live usage below: Plugin development

Loupedeck have a developer program in order to develop custom plugins using their SDK (C#) to enhance the usage possibilities. However, the current documentation is outdated and they encourage not to use right now.
I was very lucky to have a meeting with the B2B manager of Loupedeck few months ago. She told me there's a plan to release a new version of the SDK this year (TBA). Meanwhile, you can create a new account and wait for the official release of the SDK. Stay tuned at their Twitter account 👀

Conclusions

Loupedeck devices are great hardware to improve the workflow of a broad audience. Developers can use this consoles in order to make their work faster. You can control almost every app you want by simply map the keyboard shortcuts into the Loupedeck Software on your PC or macOS.

Closing

Thank you for reading my post. You can follow me on Twitter or if you like to support me you can also buy me a coffee ☕.