aboutsummaryrefslogtreecommitdiff
path: root/docs/es/newbs_testing_debugging.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/es/newbs_testing_debugging.md')
-rw-r--r--docs/es/newbs_testing_debugging.md99
1 files changed, 99 insertions, 0 deletions
diff --git a/docs/es/newbs_testing_debugging.md b/docs/es/newbs_testing_debugging.md
new file mode 100644
index 000000000..ef7412f15
--- /dev/null
+++ b/docs/es/newbs_testing_debugging.md
@@ -0,0 +1,99 @@
1# Testeando y depurando
2
3Una vez que hayas flasheado tu teclado con un firmware personalizado estarás listo para probarlo. Con un poco de suerte todo funcionará a la primera, pero si no es así, este documento te ayudará a averiguar qué está mal.
4
5## Probando
6
7Probar tu teclado es generalmente bastante sencillo. Persiona cada una de las teclas y asegúrate de que envía la tecla correcta. Existen incluso programas que te ayudarán a asegurarte de que no te dejas ninguna tecla sin comprobar.
8
9Nota: Estos programas no los provée ni están relacionados con QMK.
10
11* [Switch Hitter](https://elitekeyboards.com/switchhitter.php) (Sólo Windows)
12* [Keyboard Viewer](https://www.imore.com/how-use-keyboard-viewer-your-mac) (Sólo Mac)
13* [Keyboard Tester](http://www.keyboardtester.com) (Aplicación web)
14* [Keyboard Checker](http://keyboardchecker.com) (Aplicación web)
15
16## Depurando
17
18Tu teclado mostrará información de depuración si tienes `CONSOLE_ENABLE = yes` en tu `rules.mk`. Por defecto la información de salida es muy limitada, pero puedes encender el modo de depuración para incrementar la información de salida. Utiliza el keycode `DEBUG` de tu keymap, usa la característica [Comando](feature_command.md) para activar el modo depuración, o añade el siguiente código a tu keymap.
19
20```c
21void keyboard_post_init_user(void) {
22 // Customise these values to desired behaviour
23 debug_enable=true;
24 debug_matrix=true;
25 //debug_keyboard=true;
26 //debug_mouse=true;
27}
28```
29
30### Depurando con QMK Toolbox
31
32Para plataformas compatibles, [QMK Toolbox](https://github.com/qmk/qmk_toolbox) se puede usar para mostrar mensajes de depuración de tu teclado.
33
34### Depurando con hid_listen
35
36¿Prefieres una solución basada en una terminal? [hid_listen](https://www.pjrc.com/teensy/hid_listen.html), provista por PJRC, se puede usar también para mostrar mensajes de depuración. Hay binarios preconstruídos para Windows,Linux,y MacOS.
37
38<!-- FIXME: Describe the debugging messages here. -->
39
40## Enviando tus propios mensajes de depuración
41
42A veces, es útil imprimir mensajes de depuración desde tu [código personalizado](custom_quantum_functions.md). Hacerlo es bastante simple. Comienza incluyendo `print.h` al principio de tu fichero:
43
44 #include <print.h>
45
46Después de eso puedes utilzar algunas funciones print diferentes:
47
48* `print("string")`: Imprime un string simple
49* `uprintf("%s string", var)`: Imprime un string formateado
50* `dprint("string")` Imprime un string simple, pero sólo cuando el modo de depuración está activo
51* `dprintf("%s string", var)`: Imprime un string formateado, pero sólo cuando el modo de depuración está activo
52
53## Ejemplos de depuración
54
55Debajo hay una colección de ejemplos de depuración del mundo real. Para información adicional, Dirígete a [Depurando/Encontrando problemas en QMK](faq_debug.md).
56
57### ¿Que posición en la matriz tiene esta pulsación de tecla?
58
59Cuando estés portando, o intentando diagnosticar problemas en la pcb, puede ser útil saber si la pulsación de una tecla es escaneada correctamente. Para hablitar la información de registro en este escenario, añade el siguiente código al `keymap.c` de tus keymaps
60
61```c
62bool process_record_user(uint16_t keycode, keyrecord_t *record) {
63 // If console is enabled, it will print the matrix position and status of each key pressed
64#ifdef CONSOLE_ENABLE
65 uprintf("KL: kc: %u, col: %u, row: %u, pressed: %u\n", keycode, record->event.key.col, record->event.key.row, record->event.pressed);
66#endif
67 return true;
68}
69```
70
71Ejemplo de salida
72```text
73Waiting for device:.......
74Listening:
75KL: kc: 169, col: 0, row: 0, pressed: 1
76KL: kc: 169, col: 0, row: 0, pressed: 0
77KL: kc: 174, col: 1, row: 0, pressed: 1
78KL: kc: 174, col: 1, row: 0, pressed: 0
79KL: kc: 172, col: 2, row: 0, pressed: 1
80KL: kc: 172, col: 2, row: 0, pressed: 0
81```
82
83### ¿Cuanto tiempo tardó en escanear la pulsación de una tecla?
84
85Cuando estés probando problemas en el rendimiento, puede ser útil saber la frecuenta a la cual la matríz de pulsadores se está escaneando. Para hablitar la información de registro en este escenario, añade el siguiente código al `config.h` de tus keymaps
86
87```c
88#define DEBUG_MATRIX_SCAN_RATE
89```
90
91Ejemplo de salida
92```text
93 > matrix scan frequency: 315
94 > matrix scan frequency: 313
95 > matrix scan frequency: 316
96 > matrix scan frequency: 316
97 > matrix scan frequency: 316
98 > matrix scan frequency: 316
99```