Uma placa.
Quatro formas
de programar.

01 Primeiros passos

O NINASENSE não é uma placa com USB integrado. A comunicação local ocorre por Bluetooth Low Energy; a gravação de baixo nível e a depuração podem ser feitas por SWD.

02 Escolha como deseja programar

03 Trocar o firmware pelo navegador

Se o bootloader nRFClaw já estiver instalado na placa, você pode alternar entre nRFClaw, Espruino e MicroPython diretamente pelo navegador, sem J-LINK, ST-Link ou cabo UART.

Botão de recuperação: o botão a ser pressionado é o P0.21, indicado na imagem acima.

No Studio, entre em Devices e, no final da página, selecione o firmware apropriado em Programming & firmware.

Arquivos disponíveis para download

04 Instalar a integração Arduino

O pacote NINASENSE Arduino Universal acrescenta a variante própria ao BSP Adafruit nRF52, SoftDevice S132 7.2.0, programador ST-Link/OpenOCD e monitor RTTSerial.

Pré-requisitos

Etapa 1 — Instalar o BSP Adafruit nRF52

Antes de instalar o pacote NINASENSE FULL, configure o índice oficial da Adafruit na Arduino IDE e instale o pacote de placas Adafruit nRF52. Essa etapa é necessária porque a integração NINASENSE acrescenta uma variante ao core da Adafruit, não o substitui.

https://adafruit.github.io/arduino-board-index/package_adafruit_index.json

Etapa 2 — Instalar o pacote NINASENSE FULL

Baixar integração Arduino V8.1.1 FULL ↓

Instalação no seu sistema

cd NINASENSE_Arduino_Universal_v8.1.1
./install_linux.sh --install-deps

py -3 setup.py --install-deps

./install_macos.command --install-deps

Configuração na Arduino IDE

05 Compile e grave seu programa

Teste o GPIO do botão sem depender de um LED onboard (o NINASENSE não possui LED de usuário permanentemente conectado).

#include <Arduino.h>
#include "RTTSerialSelect.h"

void setup() {
  pinMode(21, INPUT_PULLUP); // P0.21
  Serial.begin(115200);      // RTTSerial
  Serial.println("NINASENSE ready");
}

void loop() {
  Serial.print("Button P0.21: ");
  Serial.println(digitalRead(21)); // 1 = released, 0 = pressed
  delay(1000);
}

Use Sketch → Carregar usando Programador. Ligue o adaptador J-LINK ou ST-Link ao header H1: SWDIO, SWCLK, VDDNRF e GND. A referência VDDNRF não substitui uma alimentação dimensionada para a placa.

Exemplos adicionais: BLE e temperatura

Os exemplos abaixo ilustram o uso do core Arduino com BLE e sensores. Compile e valide com a versão do BSP e do SoftDevice da sua placa antes de usar em campo.

#include <bluefruit.h>
void setup() {
  Bluefruit.begin();
  Bluefruit.setName("NINASENSE");
  Bluefruit.Advertising.addFlags(
    BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE);
  Bluefruit.Advertising.addName();
  Bluefruit.Advertising.setInterval(3200, 3200); // ~2 s
  Bluefruit.Advertising.start(0);
}
void loop() { delay(1000); }

#include <OneWire.h>
#include <DallasTemperature.h>
OneWire oneWire(20); // GPIO P0.20 / D20
DallasTemperature sensors(&oneWire);
void setup() { sensors.begin(); }
void loop() {
  sensors.requestTemperatures();
  float tempC = sensors.getTempCByIndex(0);
  // Envie tempC via RTTSerial, UART ou BLE de sua aplicação
  delay(2000);
}

Gravar o SoftDevice separadamente

Abra NINASENSE Flash SoftDevice, selecione J-LINK ou ST-Link e confirme a verificação do arquivo s132_nrf52_7.2.0_softdevice.hex. A opção de gravação existe para preparar uma placa que ainda não tenha o SoftDevice adequado.

06 RTTSerial — depuração sem UART física

O RTTSerial permite visualizar logs na RAM por SWD. O caminho mais estável é usando J-LINK, mas o monitor também pode ser aberto com ST-Link + OpenOCD quando o firmware e a versão do OpenOCD suportarem RTT.

Ligação recomendada do J-LINK-OB ao conector H1 do NINASENSE. O alvo deve estar alimentado normalmente; o pino VTref do J-LINK é apenas referência da tensão da placa.

Nota: ao usar o J-LINK OB deve-se usar a alimentação (VCC/GND) direto na entrada da placa, como as linhas pontilhadas mostram. Isso se deve porque a placa possui buck-booster que alimenta todo o circuito, inclusive o módulo LoRa. Se alimentar pelos pinos SWD, o LoRa e a saída 3V não irão funcionar. Em caso de usar o Segger J-LINK original, a sequência deve ser direto pelos pinos SWD e a placa deve ser alimentada por uma fonte adicional, já que no Segger o pino VCC é somente VTref.

Mapa de conexão Segger J-LINK original → NINASENSE

python3 ~/Arduino/tools/RTTSerial/rttserial_monitor.py

Na Arduino IDE 1.8, use Ferramentas → Open RTTSerial. Na IDE 2.x, inicie o programa independente. Escolha o probe na parte superior da janela e conecte. Feche o RTTSerial antes de gravar firmware, porque o programador precisa do acesso SWD.

07 Espruino no NINASENSE

O fork nearmeter/Espruino (branch nrfclaw) adiciona suporte ao hardware NINASENSE e ao bootloader de aplicação. Não confunda com uma compilação genérica do Espruino para outra placa nRF52832.

1 + 2             // =3
NINASENSE.battery();
NINASENSE.batteryRaw();

08 LoRa no Espruino — APIs disponíveis

A build NINASENSE do fork Espruino expõe funções nativas de LoRa no objeto global NINASENSE. Não é necessário iniciar um driver SPI JavaScript genérico para usar essas funções.

Configurar, transmitir e receber

// Perfil LoRa privado de exemplo — não é LoRaWAN
NINASENSE.loraInit();

NINASENSE.loraConfig({
  frequency: 915000000,
  power: 14,
  sf: 7,
  bandwidth: 125,
  cr: 1,           // coding rate 4/5
  syncWord: 0x12,
  preamble: 8
});

print("TX:", NINASENSE.loraSend("HELLO NINASENSE"));
var packet = NINASENSE.loraReceive(15000);
print("RX:", packet);
NINASENSE.loraSleep();

Para transmitir a cada dez segundos:

NINASENSE.loraInit();
var counter = 0;
setInterval(function () {
  var message = "T" + counter++;
  print("TX", message, NINASENSE.loraSend(message));
}, 10000);

09 MicroPython pelo Web Bluetooth REPL

O port NINASENSE do MicroPython V0.3 foi validado com S132 7.2.0, console UART e NUS BLE bidirecional. Quando esse firmware está ativo, a placa aparece como NINA-MPY.

Usar o REPL no navegador

import sys, gc
from machine import Pin

print(sys.platform)  # nrf
gc.collect()
print(gc.mem_free())
button = Pin("BUTTON", Pin.IN, Pin.PULL_UP)
print(button.value())  # 1 = released, 0 = pressed

Serviço NUS: 6e400001-b5a3-f393-e0a9-e50e24dcca9e. Escrita RX: ...0002...; notificações TX: ...0003.... No modo ATT MTU 23, o máximo usual de payload por escrita é 20 bytes.

10 nRFClaw + Studio

O nRFClaw é um firmware de máquina virtual orientado a eventos para BLE, LoRa, sensores e baixo consumo. Uma vez que o bootloader nRFClaw esteja instalado, você pode alternar entre nRFClaw, Espruino e MicroPython diretamente no Studio.

Read temperature and battery every 10 minutes,
format both values and transmit them using LoRa.
Repeat continuously after boot.

Também é possível utilizar o nRFClaw CLI, por exemplo:

python3 nrfclaw_cli.py --device YOUR_DEVICE_ID \
  firmware-upgrade ../build/ninasense/nrfclaw_ninasense.bin

Os binários mais recentes também podem ser obtidos diretamente em nearmeter.com/downloads: nrfclaw_latest.bin, espruino_latest.bin e micropython_latest.bin.

11 Pinagem e mapa de memória

Referência para NINASENSE nRF52832 / Rev. 1.1. Na variante Arduino, Dx corresponde a P0.x; respeite os pinos reservados para o rádio.

Header H1 — SWD

Memória flash — áreas que devem ser respeitadas

Orientações para projetos low power

Prefira interrupções e wake-up por evento, evite polling contínuo, coloque o LLCC68 em sleep quando não estiver transmitindo e não deixe GPIOs flutuantes ou periféricos externos energizados desnecessariamente. A autonomia depende do firmware carregado, intervalo de advertising, alimentação e sensores conectados; medidas feitas com nRFClaw não são automaticamente válidas para Arduino, Espruino ou MicroPython.

12 Problemas comuns

13 Links e arquivos úteis

Downloads diretos

Validação registrada

Atualização editorial: 21 de outubro de 2026. Esta página documenta o fluxo de desenvolvimento e recuperação do NINASENSE usando bootloader nRFClaw, Studio, Arduino, Espruino e MicroPython.