Research: computing: tokens: programming the FST-01

research/computing/token.md

@@ -45,6 +45,34 @@ Sobre tokens criptográficos USB.
 * [How does Gnuk protect against attacks to extract private keys? - FST-01 Q&A Forum](http://no-passwd.net/askbot/question/32/how-does-gnuk-protect-against-attacks-to-extract/).
 * [What types of risk are more likely? What's "best practice" against that? - FST-01 Q&A Forum](http://no-passwd.net/askbot/question/68/what-types-of-risk-are-more-likely-whats-best/).
 
+### Programando o FST-01
+
+Agradecimento ao `unixjazz` do projeto [DIYNuk](https://gitlab.com/unixjazz/DIYNuk) por fornecer estas instruções!
+
+Roteiro baseado no programador (STLink) ligado a um STM8 com os pinos soldados:
+
+1. Ligar ambas as pacas conforme [este diagrama dos
+   pinos](https://www.gniibe.org/memo/development/gnuk/hardware/stlinkv2-stm8s-discovery.html).
+2. Configurar o ST-Link (programador) no PC. Instruções
+   [aqui](https://www.gniibe.org/FST-01/q_and_a/swd-debugger.html).
+3. Compilar (mesmo procedimento para Gnuk e Neug (se diz Noisy com sotaque
+   japones)) conforme [estas instruções](https://www.gniibe.org/memo/development/gnuk/gnuk-building-for-stm32-part-of-stm8s-discovery-kit.html).
+
+Em geral, o procedimento e' o seguinte:
+
+1. Instalar o [ultimo NeuG do repo do Debian](https://salsa.debian.org/gnuk-team/gnuk/neug).
+2. Instalar o GNU Toolchan for ARM (4.5 ou maior).
+3. Instalar o OpenOCD (pacote do Debian).
+4. Compilar o NeuG.
+5. Configurar o ST-Link com as seguintes regras do udev (por exemplo em `/etc/udev/rules.d/10-stlink.rules`):
+
+        ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="0483", \
+        ATTR{idProduct}=="3748", GROUP="tape", MODE="664", SYMLINK+="stlink"
+
+6. Plugar o ST-Link, rodar o OpenOCD e escrever o binario na flash do STM8
+   conforme [este procedimento](https://www.gniibe.org/memo/development/gnuk/gnuk-installation-to-stm32-part-of-stm8s-discovery-kit.html)
+7. Pronto! Agora basta [ler a serial](https://www.gniibe.org/FST-01/q_and_a/neug-standalone-device.html).
+
 ## Safenet eToken E5110
 
 No Debian, instale o [MUSCLE](https://pcsclite.alioth.debian.org/):