OSHI

Flash your node

Plug the node into this computer with a USB cable and press one button. This is the only time you will need the cable — after this, OSHI talks to it over Bluetooth.

⚠️ This browser can't talk to USB devices. Web Serial works in Chrome, Edge, Brave, Opera and Arc on a computer — not in Safari or Firefox, and not on iOS or Android. Open this page in one of those, or see the other ways to get a node running.
Not connected.
Chip
—
MAC
—
Flash
—
Board
—
⚠️
⚠️
—
—
—

    


    

      ✅
      Installed. Unplug the node, power it on, then open OSHI →
      Settings → LoRa Node and press Connect. It appears over Bluetooth within a few seconds.
    

  


  

    When it is done, three things are left
    
    
      
  1. Power the node on. Unplug it from the computer and give it power —
          USB or a battery. It starts on its own.
    2. 
      
  2. Pair it in the OSHI app. On your iPhone: OSHI → Settings →
          LoRa Node. The node shows up over Bluetooth within a few seconds; tap it.
    3. 
      
  3. Choose your region. A freshly flashed node starts with no region and
          will not transmit at all — it pairs, reports "connected", and sends nothing. Pick your region
          on that same screen and press Set region.
    4. 
    

    
Region is a legal setting, not a preference: which
       frequencies and what power a radio may use is decided by your country's regulator. OSHI suggests one
       from your phone's locale and asks you to confirm it.

  


  

    What this does, exactly
    
    
      
  1. Reads the chip so it can refuse a board the firmware isn't for. A mismatched
          image is how a node gets bricked, so this check is not skippable.
    2. 
      
  2. Erases the flash completely, then writes each image at the offset the firmware's
          own installer specifies — never a guessed address.
    3. 
      
  3. Reads back what it wrote and compares, so "done" means verified rather than
          "no error was thrown".
    4. 
    

  


  
  

    Boards that install a different way
    
Some very common nodes — the RAK WisBlock
       boards, the LILYGO T-Echo, anything built on a Raspberry Pi Pico — use a different chip that the
       button above cannot talk to. They are not harder to install; they just work another way, and no cable
       trick will make the flasher on this page reach them.

    
    
      
  1. Download the file for your board from the list below. It ends in
          .uf2.
    2. 
      
  2. Plug the board in and press its reset button twice, quickly. A USB
          drive appears on your computer, the way a memory stick does.
    3. 
      
  3. Drag the .uf2 file onto that drive. The board copies it, restarts
          on its own and the drive disappears. That is the whole install — there is nothing to verify by hand.
    4. 
    

    

    
Two boards are different again: the Wio-E5 and the RAK3172
       are STM32, and their firmware is a raw .bin that needs STM32CubeProgrammer or a DFU tool. Neither a
       browser nor a drag-and-drop drive can install it, so no file for them is offered here.

    
These files are built and published by the Meshtastic
       project, not by OSHI. We keep a copy so the download does not depend on anyone else staying online, and
       every copy was checked byte-for-byte against the checksum Meshtastic published with it.