Forem: rafaone

My Guidelines for Codebase

rafaone — Fri, 30 Jan 2026 18:54:19 +0000

Engineering Guidelines & Codebase Principles

This project integrates low-level hardware communication (STM32/ESP) with a high-level orchestration layer (Java 21). To ensure system reliability and maintainability, all contributors must adhere to the following principles.

1. Combatting Software Entropy

We prevent system degradation by strictly following the Broken Windows Theory: no bug or "quick fix" (workaround) should be left unaddressed.

Avoid Rigidity & Fragility: Code must be modular. If a change in the protocol breaks the USB handler, the coupling is too high.
Immobility Prevention: Ensure code is reusable and testable to avoid "technical debt paralysis."
Load-Modify-Store (LMS) Awareness: Always consider the atomic nature of operations to prevent race conditions.

2. Naming Conventions & Style

We maintain a clear visual distinction between Java (Business Logic) and C (Hardware Logic).

Context	Pattern	Example
Java Classes	`PascalCase`	`UsbPacketHandler`
Java Methods/Variables	`camelCase`	`rawUsbData`
C Variables/Functions	`snake_case`	`raw_usb_data`
Global Constants	`SCREAMING_SNAKE_CASE`	`MAX_BUFFER_SIZE`

Context-First Naming: Variables must be structured by context (e.g., EA_XX_KI, SIZE_DF_VAR).
Enums over Magic Numbers: Use Enums with (code, description) for state machines and error codes.

3. Communication Protocols

Reliable hardware-software synchronization requires structured framing:

Buffering: Prefer fixed-size buffers. For high-throughput requirements, implement a Circular Buffer to prevent data loss.

4. Concurrency & Threading Model

We use a Hybrid Threading Model to balance hardware latency with cloud scalability.

Java 21 Layer

Platform Threads (Kernel Space): Dedicated to high-priority, blocking I/O (e.g., USB/Serial reading).
Virtual Threads (User Space): Used for lightweight, concurrent tasks such as PLC connections and API processing.
Synchronization: Prefer ReentrantLock over synchronized to avoid thread pinning in Virtual Threads.

Firmware Layer (STM32/ESP)

Atomic Operations: Use stdatomic.h or disable IRQs during critical sections to prevent Race Conditions.
Volatile vs. Atomic: * Use volatile for Visibility (state flags/booleans).
- Use Atomics for Integrity (shared counters and global variables).
Interruption Safety: Minimize variable sharing between the Main Loop and ISRs (Interrupt Service Routines).

5. Performance Optimization

Deterministic Execution: Avoid heavy time computing inside high-frequency loops. Use modular tasks for precision.
State Counters: Use sequential counters (cnt == 10, cnt == 11) to orchestrate non-blocking state machine actions.

6. Documentation & Quality Assurance

A "Lint-First" approach is mandatory to prevent code rot.

Documentation: Use Doxygen for C/C++ and JavaDoc for Java.
Static Analysis: * C/C++: Mandatory Cppcheck scans (clean report policy).
- Java: PMD, Checkstyle, and SpotBugs for bug pattern detection.
Automation: If code quality deviates, Linters and Formatters will be enforced via CI/CD gates.

Java8 + JavaFx updates issues

rafaone — Tue, 18 Mar 2025 09:31:58 +0000

Java8 with JavaFX: A Challenging Task to Update a Legacy System 200 Updates Behind

A legacy system, running on a dedicated Linux totem-like device with the "twm" minimal window manager, and only the main application running in X, presented a significant challenge. The system, using Java8 with JavaFX, was 200 updates behind, necessitating a major update from 8.0u232 to 8.0u442.

Upon upgrading to the latest currently version 8u442, the same ".jar" binary exhibited window positioning issues. Despite setX(0) and setY(0) being set in the code, the window no longer appeared at the top-left corner. Since the window manager remained the same, the issue was clearly attributed to Java.

To accommodate the need for the latest Java version, a workaround was devised to move the application window via a script. This approach leveraged the window ID, reminiscent of techniques used in keyloggers that monitor application title bars.

xdotool proved to be an invaluable tool for simulating X input.

AI struggled to provide a simple script for this task. It became apparent that for complex tasks, breaking them into smaller problems, manageable problems was more effective for AI assistance. However, the ultimate solution was found in the documentation. The AI's suggestion to retrieve the window ID by application title worked for the initial window, but became impractical for subsequent forms with varying titles. The getwindowfocus option in xdotool provided the necessary solution.

By running the script every 2 seconds, the focused window was moved to X(0) and Y(0), effectively centering it (assuming full-screen windows).

This type of solution highlights the limitations of AI in handling complex, macro-level problems. While AI can be helpful, it often lacks the ability to grasp the bigger picture.

Vscodium for privacy

rafaone — Wed, 11 Sep 2024 20:29:10 +0000

Vscodium is an open-source project based on Visual Studio Code by Microsoft. It's essentially a clone of VSCode, but with a key difference: VSCodium removes all telemetry code. This means it doesn't collect any usage data and send it back to Microsoft.

The big difference is regarding the Telemetry Sends usage data to Microsoft, "helping the company improve the product and identify issues."
In really it track your preferences, time usage, .env files, all to Microsoft.

Alternatively VSCodium has No telemetry Does not collect or send usage data.

Greater privacy for users who are concerned about data collection.

The extensions that you use on VSCODE will work normally on VsCodium.
For more info itsfoss.com/vscodium

Stay free from big techs, also pay attention in the Copilot assistance, has huge discussion, the collect your files like .env, preferences etc.

Imagine that it can be collect sensitive data, like your business core from your project. COMPLICATED! pay attention.

Android alternative app and block trackers

rafaone — Thu, 11 Jul 2024 13:10:27 +0000

Focusing in the avoid at all the apps that track you, skipping from Google Play Services, Facebook, Amazon in general big tech.
Tracker are lib's that the apps install inside, to spyware you and collect data in silent mode.

To Monitor/Analyses you can you Tracker Control

It's in action on my Phone

With this app you can block some requests from specific apps.
Another way to check if an specific app are tracking you is the Exodus Reports, check this out for Strava app.

Mostly of the apps you can install using F-Droid o Aurora Store, alternative option to Google Play Store.

Alternative Apps
I really like this list Awesome-Privacy and DeGoogle.

The both list are very good to start, For youtube, no ads, no trackers, no sponsor, newPipe is very good, but Tubular is awesome,

for Desktop I recommend Materialio, good replacement for Youtube, and no tracks no ads.

For explorer Files Material Files is very good, and have a option to make a internal temporary FTP server, and you can connect from you computer using FileZilla client and download your files.

To listening musics Spotube is decent but works only for Music, To Podcast Antenna Pod .

To message, step back and use SimpleX, or PGP communication for any messageria service, if you don't have Xmpp server you need to guarantee that use PGP to encrypt your message, but the another people need to learning PGP.

Email proton is a decent to start, they have a good support and you can download the PGP keys and you, but I still recommend that you learn about PGP and use yours.

Android for Privacy

rafaone — Mon, 08 Jul 2024 11:47:47 +0000

Introduction
Kind of guide to my-self to install and configure my de-googled cellphone.
Android provided by brands has totally googled eco-system, that force you to use the big-tech services, and blind you in terms of trade off about your privacy and the free services.

Alternatives OS
To bypass this we have a some alternatives in terms of Operation System for android, I tested LinageOS, CalyxOS, because they have support for my currently hardware, you can consider GrapheneOS and DivestOS. On of advantage is that you can update your phone to newest android(14).

Considering that you are getting a pure S.O with minimal to start to install the Apps that will attend you with functionality versus privacy.

Many ways to follow, because of this I'm writing to my self back and re-learn with my chooses.

Apps that track info from you
My approach is avoid at all big-tech services, and replace for community options, to this you will need spirit of auto custody.
And take care about you backups, e-mail, calendar, contacts etc.

Transitory time is acceptable to use some tracked apps, but important to you know how to check that and decide considering the risks.

The most popular way is use Exodus Privacy reports to verify this info, basically the web site tell you how many "tracks" the app has, and track means a inside codes in app that collect data from you.
Twitter/X has 4 tracks and you check will have information about the data that are collect from you.

It's a pain in the ass verify and decide, much time to test and consider witch app you will use.

Apps
List of Alternatives Awesome-Privacy and DeGoogle
The first app to use is F-Droid, unpopular store no need google account basically is a repository that you can trust more than download the apk from another sources.
I recommend to install Aurora Store, this one "need" google account that you can choose anonymous one and its connected with PlayStore but has linked report with Exodus Services than is easy to check if the app has trackers.

Store: F-Droid, Aurora Store
Home: TCP/UDP WIDGET (developed by KJM), Ewlink
Sec: Aegis Authentication, OpenKeyChain.
Chat: Telegram Foss, Signal, SimpleX, Proton-Mail.
Browser: Mull, Firefox.
Social: Amethyst nostr Client.
Media: Spotube, Tubular, LibreTube, Materialious, FocusPodcast.
Maps: OsmAnd, GMaps WV.
Others: Material Files, ConnectBot
VPN/Firewall: Orbot, Wireguard Client, NetGuard.

Exodus Reports are amazing to help you to decide, if you really need install an app or not, sometimes is better to use the service in the web-browser to avoid tracks, sure that on web-site they can collect data, but you can use Firefox extension like uBlock Origin and Privacy Badger that will mitigate that and block the track .
Your Firefox/based Firefox browser is a good option, you need to configure and remove the telemetry about mozilla, but is easy to do this, the extension to improve the privacy are enough.

Conclusion
Nowadays we good services for privacy approach like Proton services, Next-Cloud etc, the best option is your auto custody of your data creating your setup, has more work to do, but has more privacy.

Dicas de Terminal e SSH

rafaone — Tue, 18 Jun 2024 22:55:39 +0000

Algumas dicas para ter um pouco mais de segurança no seu terminal, principalmente de uma segurança espacial no sentido do seu entorno e em conexões ssh.

Use customizador de prompt como starship, nele é possível ocultar o nome da maquina e do usuário, podendo customizar de acordo com seu uso podendo criar seu próprio padrão.

Evite ter login por senha em seu servidor SSH, estude sobre chaves ssh mantenha ela em local criptografado e use uma passphrase;
Configure seu .ssh/config com seus host, portas e nome de usuário.
vai sair disso "ssh -p7642 usexpto@server.com" para "ssh server.com".

Mude a porta do seu SSH, isso ajuda mas não resolve os ataques.
Se não consegue por um acesso somente por VPN, se possível implemente um "Port Knocking". #dicas #linux #ssh #terminal

Updating repository recursively

rafaone — Fri, 09 Feb 2024 11:48:34 +0000

Many use systems like GitHub and BitBucket, but some companies have their own repository structure in directory mode.

So imagine that a devops backs up a directory called repos where it has all the versioned projects and the dev has this copy but needs to update it.

cd repos

for i in */.git; do ( echo $i; cd $i/..; git fetch origin; ); done;

You can change your command there with your need, if it were mercurial easily adapted to

for i in */.hg; do ( echo $i; cd $i/..; hg update; ); done

Raspberry 4 with SSD and nvme adapters performance

rafaone — Mon, 20 Nov 2023 22:46:37 +0000

Studying to create a NAS with raspberry pi4, it's not a reliable NAS but kind of backup of backup.

Since raspberry 4 has only USB3.0 this is our limit, but depends on the brand/chip of adapter the results are different.

The test to read used hdparm command and to write a dd command.
Read
hdparm -tT /dev/sda
Write
dd if=/dev/zero of=./TestingFile bs=100M count=10 oflag=direct status=progress
Nvme + usb3.0 Orico / Realtek adapter

SSd + usb3.0 sata adapter Jmicron

sucks 33 mb read and write on Jmicron chip

SSd + usb3.0 sata adapter ASmedia

Not bad with usb3.0 and asmedia chip to sata.

Final Results

From my opinion the better option is SSD SATA with asmedia chip, is good cost and benefit, nvme is good also but more expansive price.

In my case I have 4tb nvme for this test, but I'm waiting the special case for raspberry pi that has the NVME adapter for raspberry pi from 52pi that I hope that have a good chip like asmedia or realtek.

2009 dev hacks

rafaone — Thu, 09 Nov 2023 17:25:12 +0000

cabo de rede duplo, um cabo 2 pontos de rede.

rafaone — Thu, 09 Nov 2023 17:15:24 +0000

original post 02/05/2010 rafaelgimenes.net
Em casa possuo um roteador, mas meu desktop utiliza de cabo de rede por motivos de downloads etc, não curto muito wireless em desktop ainda não confio nisso.
Agora eu encomendei um módulo de rede para brincar com o arduino, ou seja necessitaria de outro cabo de rede saindo do quarto do meu pai para o meu quarto.
Porém o cabo tem quatro pares, mas rede categoria 5 e utiliza somente 2 pares para funcionar, então porque eu iria passar outro cabo sendo que temos ali 2 pares inutilizados.
Eu sempre utilizei o padrão de cores A, então dando uma relembrada em TX e RX, cheguei a seguinte combinação.

Pino / Cor / Status
1 / Branco Verde / TX +
2 / Verde / TX –
3 / Branco Laranja / RX +
4 / Azul / não utilizado
5 / Branco Azul / não utilizado
6 / Laranja / RX –
7 /Branco Marrom / não utilizado
8 / Marrom / não utilizado

Ou seja o que interessa pra gente é o pino 1 e 3, 2 e 6, então mantive o esquema de cores do padrão, e no segundo cabo fiz o seguinte esquema:
Pino / Cor / Status
1 / Branco Azul/ TX +
2 / Azul / TX –
3 / Branco Marrom / RX +
4 / não utilizado
5 / não utilizado
6 / Marrom / RX –
7 / não utilizado
8 buy drugs online / não utilizado

Material utilizado: alicate Crimpador, 4 conectores RJ45, * cola quente e fita isolante.

Como os espaço dos conectores ficaram vazios pois foi utilizado somente 2 pares eu preenchi internamente no conector

com cola quente deixando assim bem fixo e firme os pares. É um dispedicio usar deixar 2 pares lá nulos, com esse esquema economizei um cabo, a questão não é o dinheiro mas sim espaço e organização.

executando comando em um novo terminal

rafaone — Thu, 09 Nov 2023 17:11:14 +0000

original post 01/12/2009 rafaelgimenes.net

Dica rápida que salvou minha vida hoje em uma aplicação, é executar com comando em um novo terminal. Geralmente é a opção “-e” do seu terminal.
Eu uso o xterm, hoje tive que fazer um shell script que teve que ser aberto em uma nova janela, então usei essa instrução:

xterm -e comando &

Dentro do meu shell script ficou mais ou menos assim:

xterm -e sh segundosh.sh &;

Não posso usar o meu exemplo que fiz por se tratar de um sw da empresa, e um exemplo didático não me vem a cabeça mas fica a dica.

Ubuntu Minimal Install

rafaone — Thu, 09 Nov 2023 17:03:47 +0000

original post 28/12/2010 rafaelgimenes.net

Para você que se sente meio preso ao instalar o Ubuntu, pois ele já vem pronto para um usuário final, mas isso não me agrada parece que perco o espirito de liberdade.

Mas o ponto forte Ubuntu são suas atualizações, então eu fui em busca de como fazer uma instalação customizada somente com os pacotes do Ubuntu.
Depois de muita pesquisa e anos de experiência com linux desenvolvi o que chamo de instalação mínima, para MIM(Rafael Gimenes Leite) é perfeita.

Alguns conceitos da minha instalação
– Não tem gerenciador de login gráfico.
– Precisar habilitar o root, na unha e você usa isso.
– Não tem menus, os aplicativos são chamados via tecla de atalho ou docks.
– Não tem menu para desligar.
– Não é um desktop, usa apenas um gerenciador de Janelas.
– Aqui tudo é minimalista, não é bonito também não quer dizer que é feio, é apenas simples faz o necessário.
– Não importa a versão do ubuntu, atual ou não essa técnica quase nunca mudará.

Seria bom/Pré-Requisitos
– Se você tem conceitos de particionamento.
– Se você já instalou um Debian.
– Se você sabe usar o vim.
– Conexão com internet via placa de rede 10/100 (sim tem que ser assim).

Introdução
A idéia é usar a instalação mínima do Ubuntu (https://help.ubuntu.com/community/Installation/MinimalCD), onde é bem parecida com a NetInstall do Debian. Iremos baixar a imagem(12 ~ 13MB) do link acima e queimar em um cd rom e dar boot.

Vamos usar o assistente de instalação, e não selecionaremos nenhum pacote na instalação, tudo sera instalado via linha de comando usando o apt. Pra quem já instalou usando o anaconda da RedHat não terá problemas, qualquer ser capaz de ler consegue instalar.

Esta é a primeira tela exibida após o boot, selecione o menu

Va seguindo o instalador conforme as telas, não quer que eu fique explicando tudo né?

Coloque o nome que quiser, este é o nome da sua maquina pense em algo inspirador.

Aqui você estara selecionando daonde pacotes serão baixados.

Se não tiver proxy de um [enter], se tiver pesquise no google como configurar.

Chegamos a parte onde todo usuário de windows faz cagada, na configuração das particões, bom use o método manual, não vou entrar em detalhes, pra esse tutorial eu criei uma partição só.

Após criar, FINISH!

Aguarde, vai demorar, o instalador esta baixando o minimo para poder instalar o sistema, no debian o cd é de 170mb essa parte é mais rápida.

O nome do usuario, eu coloquei “lion”, coloque ai o seu usuário.

senha é bom por né.

Aqui você tem a opção de encriptar seus dados, tudo que estiver no /home/ você deve pro governo? eu encriptei.

Aqui você pode selecionar a primeira opção, eu prefiro atualizar manualmente.

Neste tela desmarque tudo, isso faz você ser o cara livre do sistema, aguarde pois vai demorar.

Grub é o gerenciador de boot, instale ele ai sem medo.

Cara se você chegou nessa tela eu já estou orgulhoso, pois provavelmente não fez nenhuma cagada.

Logue-se com seu usuário, meu caso “lion” (que coisa gay figura 24 ainda).

**Apartir daqui acabou as figurinhas fio, espero que você saiba o mínimo de VI.

Torna-se root
Isso é primordio no linux, sempre somos o ROOT, o Ubuntu tem essa filosofia para você não fazer cagada, mas na vida uma boa técnica de aprendizado é fazendo cagada, então vamos habilitar o root.
Calma usaremos o root para tarefas como instalar novos software, mas a execução e configuração de nosso ambiente será com nosso usuário.

$ sudo passwd root

Pronto a partir de agora os comandos começados com # quer dizer que você tem que estar logado como root, e quando estiver $ você deve executar com seu usuário.

Loge-se como root vamos usar bastante de um $su ou entre num novo tty como root.

Instalando o vim

#apt-get install vim

(repare # você tem que estar logado como root)

Removendo o boot-splash
Amigos estamos falando de uma maquina limpa, o boot splash só come memória.
Faça um backup antes e depois edite o arquivo “/boot/grub/grub.cfg” procure a palavra splash e apague somente ela e salve o arquivo. É necessário dar diretos de gravação e depois volte como somente leitura.

Removendo Mensagem de boas vindas MOTD
Logo após o login, é exibida uma mensagem de boas vindas enorme do ubuntu, eu não gosto dela, nem do debian eu gostava e eu a removia editando o script “/etc/init.d/boot-misc.sh” mas no ubuntu esse arquivo não existe.
Depois de muito fuçar eu descobri que removendo os arquivos do diretorio “/etc/update-motd.d/” a mensagem some, pra mim basta, também removi o conteudo do arquivo /var/run/motd ;

UPDATE
Dica do comentário do Marcelo Godim
Ele é gerenciado pelo pam_motd basta ir em /etc/pam.d nos arquivos “login” e “sshd” e comentar essas linhas abaixo:
login:

session optional pam_motd.so

sshd:

session optional pam_motd.so # [1]

Mudando mensagem da versão

Dica velha edite o arquivo “/etc/issue” coloque o que preferir.

——Se você não precisa de modo gráfico a instalação terminou aqui.

Alterando o sources.list adicionando outros repositórios

Edite o arquivo /etc/apt/sources.list e deixe assim, basicamente adicionados pacotes do site Medibuntu, se prefereir siga esses passos é melhor do que editar o arquivo.

Instalando o resto dos pacotes

apt-get install xserver-xorg xinit alsa-base alsa-utils openbox obconf obmenu feh nitrogen tint2 k3b conky gmrun pcmanfm gtk-theme-switch ssh smbfs smbclient dosfstools setserial usbutils leafpad x11-apps openbox-themes terminator chromium-browser xcompmgr gcc g++ openjdk-6-jdk mysql-server mysql-query-browser gftp gcc-avr avrdude imagemagick gparted ntfs-3g file-roller zip unrar gpicview gtk2-engines gnome-icon-theme-gartoon vim unace rar unrar zip unzip p7zip-full p7zip-rar sharutils uudeview mpack lha arj cabextract file-roller pidgin pidgin-data pidgin-lastfm pidgin-guifications msn-pecan pidgin-musictracker pidgin-plugin-pack pidgin-themes mplayer vlc cairo-dock w32codecs audacious

Vai dormir, seila vai baixar ai uns 500mb, você pode tirar ou por o que quiser ai isso é minha instalação.

Como entrar no modo gráfico?

Logue-se com seu usuário

$startx

O comando antigo, simples, que dei a primeira vez no meu conectiva 4.

Este é o resultado final, mas para isso vamos algumas dicas.

Toda incialização dos aplicativos eu concentrei no .config/openbox/autostart.sh segue o meu ai

# Set desktop wallpaper
nitrogen –restore &
# Enable Eyecandy – off by default
xcompmgr -cCfF -r7 -o.65 -l-10 -t-8 &
# Launch network manager applet
(sleep 4s && nm-applet) &
# Launch clipboard manager
#(sleep 1s && parcellite) &
# Uncomment to enable system updates at boot
#(sleep 180s && system-update) &
cairo-dock &
# Launch Conky
#conky -q &
# Launch panel
tint2 &

Configurando teclas de atalho, edite o arquivo .config/openbox/rc.xml, vá até a seção keybinds as minhas são essas abaixo:

<keybind key=”W-a”><action name=”Execute”>  <execute>audacious</execute></action></keybind><keybind key=”W-1″><action name=”Execute”>  <execute>xcompmgr -cCfF -r7 -o.65 -l-10 -t-8</execute></action></keybind><keybind key=”W-2″><action name=”Execute”>  <execute>pkill xcompmgr</execute></action></keybind><keybind key=”W-a”><action name=”Execute”>  <execute>audacious</execute></action></keybind><keybind key=”W-e”><action name=”Execute”>  <execute>pcmanfm</execute></action></keybind><keybind key=”W-g”><action name=”Execute”>  <startupnotify>    <enabled>true</enabled>    <name>transset</name>  </startupnotify>  <command>transset .50</command></action></keybind><keybind key=”W-h”><action name=”Execute”>  <startupnotify><enabled>true</enabled><name>transset 1</name></startupnotify><command>transset 1</command></action></keybind><keybind key=”W-l”><action name=”Execute”><startupnotify><enabled>true</enabled><name>Lock screen</name></startupnotify><command>gnome-screensaver-command -l</command></action></keybind><keybind key=”W-t”><action name=”Execute”><execute>terminator</execute></action></keybind><keybind key=”W-r”> <action name=”Execute”> <execute>gmrun</execute> </action></keybind>

Pesquise como instalar temas GTK, configurar o TINT2 (desk bar), Cairo Dock, também tem muitas configurações de openbox na internet.

Esse tutorial vem de anos de convivio com linux, é duro passar tudo a limpo aqui, uma dica e testar o Linux Crunch-Bang aprendi muitas customizações com ele.