Gestione degli hotspot da Android con la API2 Key di BM

In questo articolo desidero spiegarvi come poter gestire i TG statici del vostro hotspot Pi-Star, o delle applicazioni MMDVM che utilizzano la API2 Key di BrandMeister, attraverso un’App Android creata ed aggiornata per questo scopo.

Premessa

Con questo ulteriore aggiornamento della versione dell’App Android BM Hotspot, viene dato gratuitamente a tutti i Radioamatori un nuovo modo gratuito per poter gestire in mobilità i propri hotspots connessi alla rete DMR di BrandMeister. Questa modalità rende molto più semplice il controllo e la configurazione da remoto dei TG a tutti i sysop proprietari di hotspot pi-star (simplex e duplex).

 

Come creare la propria API2 Key di BM

Per poter utilizzare la BM API2 key di BM è necessario essere registrati sul portale di BrandMeister; la maggior parte di voi lo saprà già, dato che avrete almeno un Hotspot attivo connesso a quella rete mondiale DMR.

Iniziate questa semplice procedura, facendo il login al sito di BM utilizzando questo link; successivamente dovrete selezionare il menu in alto a destra (posizionandovi sopra al vostro nominativo) e selezionare la voce “Profile Settings“.

Successivamente selezionate il pulsante blu “API Keys“.

Visualizzando il pannello di gestione delle vostre API keys, e cliccate sul pulsante “Add“; vi si aprirà un’ulteriore finestra dove inserirete un nome alla nuova API key appena creata (ad esempio, io la mia prima chiave l’ho chiamata “Hotspot“). Una volta inserito il nome che desiderate dare a questa chiave ed aver confermato con OK, vi apparirà una finestra che visualizzerà sia il contenuto di un lungo codice di testo ed anche un codice QR-Code.

NOTA: Il mio codice di esempio e l’immagine QR-Code non le inserisco qui per motivi di sicurezza dei miei sistemi, in quanto utilizzando i codici di questa chiave di esempio potreste cercare di amministrare da remoto i miei sistemi hotspots.

Il portale vi avvisa con la frase “Your API key is:   This key will not be visible again“, in quanto, dopo aver confermato l’uso di questa chiave, sia il codice testo che il QR-Code non saranno più visibili all’utente.
NOTA: Per questo motivo vi consiglio di copiare tutto il codice di testo della chiave (e magari anche l’immagine del codice QR-Code) nel vostro PC premendo il pulsante “Copy”, per poi creare sul PC un file testo vuoto dove incollare il vostro codice appena creato. Come già detto sopra, ricordate che una volta confermato il codice con il pulsante OK, ambedue i codici non saranno più visibili; quindi salvate il file di testo (e anche l’immagine ottenuta, salvandola)  al sicuro, per il prossimo uso futuro.

 

Come inserire la vostra API2 key nell’hotspot pi-star

Ora collegatevi al vostro hotspot Pi-Star (l’esempio segueenn te riguarda la versione inglese) ed utilizzate il menu Configurazione > Expert > BM API, dove vi apparirà una pagina di configurazione, nella quale dovete incollare il codice di testo appena creato e copiato.

Una volta copiato il contenuto del testo della chiave, premete il comando Applica le modifiche;(vi sembrerà che dopo il salvataggio il codice che avete inserito sparisca, ma in realtà se selezionerete un’altra volta lo stesso menu BM API potrete vedere nuovamente il codice copiato e salvato in precedenza).
Avete terminato la configurazione della chiave BM API nel vostro hotspot.

 

Gestione dei TG statici dell’hotspot / ripetitore personale

Selezionate il menu Admin (dell’hotspot pi-star inglese) ed in questa pagina troverete ora delle nuove finestre, denominate “Active BrandMeister Connections” (dove visualizzare i TG attivi (sia statici che dinamici) (ed eventualmente lo slot assegnato in caso sia un hotspot /ripetitore duplex, mentre con un hotspot simplex questa selezione è ininfluente); e la finestra “BrandMeister Manager“, dove poter interagire con il sistema e attivare o disattivare i TG statici, ed eventualmente fare il “Drop QSO” o “Drop All Dynamic” dei TG attivati in modo dinamico.
NOTA: La procedura funziona anche con la versione americana del pi-star, ma la visualizzazione grafica del pannello comandi sarà leggermente diversa; ma i comandi disponibili saranno gli stessi.

Esempio: Desiderando attivare un TG statico sullo slot 1 (ad esempio il TG 222). Inserite il numero del TG nell’area “Static Talkgroup” e selezionate lo Slot 1 (TS1). Nel caso utilizzaste un hotspot simplex, lasciate pure impostato lo Slot 2 (TS2), in quanto l’azione è ininfluente), poi impostate la selezione su “Add” ed eseguite il comando premendo il pulsante “Modify Static“.
In questo caso, nella finestra superiore Static TGs apparirà l’indicazione TG222(1), dove il numero tra parentesi indicherà il Time Slot utilizzato dall’hotspot.
Allo stesso modo sono stati inseriti i due TG regionali 22231 e 22233, sullo Slot 2.

Se desiderate togliere il TG statico dal vostro hotspot, utilizzerete gli stessi comandi, con la differenza che selezionerete il comando “Delete” per disattivare il TG, inviando il comando sempre con il pulsante  “Modify Static“.

 

Gestione dei TG dinamici e dei QSO dell’hotspot / ripetitore personale

Nella finestra Dynamic TGs appariranno anche i TG dinamici che sono stati utilizzati nel vostro Hotspot, TG dinamici che successivamente la rete DMR di BM disattiverà automaticamente dopo 10 minuti dall’ultimo utilizzo di quel TG sull’hotspot / ripetitore.
ATTENZIONE: Nel caso si utilizzi un hotspot simplex, l’ultimo TG utilizzato sull’hotspot verrà convertito in automatico in TG statico; questa regola viene detta “TG Autostatico“. Per scollegare anche questo TG dal vostro hotspot, sarà necessario inviare un comando di PTT con il TG 4000, oppure operare attraverso le API key di BM, premendo il pulsante “Drop All Dynamic“.

NOTA: Non è necessario creare molte API keys (anche se questo viene reso possibile dal portale di BM), in quanto è sufficiente una sola chiave API BM per gestire tutti i vostri dispositivi hotspot; ricordatevi che potete controllare e gestire i vostri sistemi anche via web, direttamente dal pannello di controllo di ogni dispositivo che avete collegato a BrandMeister. Lo potete fare (solo dopo esservi connessi al portale di BM) attraverso la lista dei dispositivi visualizzata nella dashboard principale, alla voce “My Devices“.

L’utilizzo delle funzioni attraverso le API Keys di BM possono essere utilizzate per impostare i TG come statici su tutti i vostri dispositivi (siano dei Pi-Star (inglese o americano) o applicazioni come il proprio server DVSwitch, DroidStar, o qualsiasi altro tipo di connessione che avete verso BM. Lo potete fare utilizzando una specifica applicazione Android, dove potete visualizzare e controllare tutte le vostre connessioni dei TG nei dispositivi attivi.
NOTA: Per gli hotspot possono essere impostate anche delle connessioni e disconnessioni temporizzate, ma solo tramite il pannello di comandi presente nel portale di BM.

 

Installazione dell’App Android “BM Hotspot”

Per poter gestire i vostri dispositivi da uno smartphone Android, scaricate l’applicazione BM Hotspot dal Play Store di Google, tramite questo link.

La versione descritta in questa guida, è la 2.0.4, del 8 febbraio 2026.

 

Configurazione dell’App BM Hotspot

Una volta avviata l’applicazione per la prima volta, è necessario configurarla inserendo il vostro nominativo radioamatoriale (in maiuscolo) e il codice di testo della chiave API2 KEY creato in precedenza (l’App prevede anche l’inserimento del QR Code (utilizzando la telecamera dello smartphone)  oppure del codice salvato precedentemente nel file di testo).  Una volta salvati i dati di configurazione, potrete gestire tutti i vostri dispositivi senza problemi.

Nella schermata di Login dovrete inserire i vostri dati,seguendo le modalità descritte nel display:

• Il vostro Nominativo personale
• Nel campo API TOKEN, dovete inserire il contenuto completo (in formato testo) dell’intero contenuto della vostra API2 Key, oppure inserire il QR Code, premendo il pulsante Scansiona il Codice QR, utilizzando la fotocamera dello smartphone, (se avevate precedentemente salvato l’immagine da parte).

Una volta fatto, cliccate su Accedi e entrate all’interno del programma.
Troverete la schermata principale di benvenuto (Home) dove visualizzerete l’elenco degli ID DMR di tutti i vostri dispositivi che avete connesso alla rete DMR di BM utilizzando la API2 Key di BM, con in evidenza il numero ID DMR di ogni dispositivo e l’icona di stato del dispositivo: connesso (verde) o disconnesso (rosso).

 

Gestione dei dispositivi hotspot dallo smartphone

Ora potete selezionare uno dei vostri dispositivi accesi che desiderate controllare o modificare la configurazione dei TG.
NOTA: Per la gestione dei ripetitori personali, l’applicazione funzionerà solo se il ripetitore utilizza lo stesso nominativo del Radioamatore utilizzato per il Login e NON il nominativo ministeriale di zona IRnumABC.

Per proseguire con la descrizione del funzionamento di questa applicazione Android, utilizzeremo uno dei miei dispositivi hotspot Duplex. Ho scelto di gestire da remoto il mio mini ripetitore portatile da viaggio “Personal mini repeater pi-star Duplex (con software versione 4.1.10 UK)“, che corrisponde all’ID DMR 222448388.
Ad esso gli ho assegnato il nome host bvkmobile, ma in questa guida questo dato è ininfluente.

L’hotspot Duplex viene visualizzato in questo modo, e le indicazioni visualizzate corrispondono a:

• il pallino VERDE, presente dopo l’ID DMR del dispositivo, indica che il dispositivo è connesso al server della rete DMR di BM (se il dispositivo è sconnesso, il pallino visualizzato sarà di colore ARANCIONE);
• La scritta seguente (Both Slots Linked), indica che ambedue i Time Slots dell’hotspot sono attivi e disponibili (accade solo per gli Hotspot Duplex); altrimenti, per gli Hotspot Simplex, l’indicazione visualizzata sarà DMO.
• Di seguito trovate visualizzate le indicazioni della Versione del firmware, delle frequenze di RX e TX, il Color Code utilizzato e il nome del Master server di BM a cui è connesso; di seguito vengono visualizzate le ulteriori informazioni del dispositivo.
• La posizione geografica dell’hotspot;
• La data e l’ora dell’ultima connessione avvenuta al Master Server DMR.

NOTA: Tutti questi dati vengono prelevati dalla configurazione della scheda MMDVM del dispositivo e vengono trasmessi al master server DMR ad ogni connessione; dati che sono stati precedentemente inseriti e che trovate presenti nella pagina di configurazione dell’Hotspot pi-star.
Questi dati vengono aggiornati ciclicamente e automaticamente tra il dispositivo e la rete DMR di BM.

 

Gestione dei TG e dei QSO

Selezionando il dispositivo Hotspot con ID: 222448388 (il mio hotspot duplex (che uso spesso in mobilità), che ho realizzato con una scheda modem MMDVM Dual Hat e due antenne ceramiche a 430 MHz.), per questo esempio verranno visualizzati i seguenti dati.

Da questo pannello comandi potete visualizzare i TG statici attivi utilizzati nei due Time Slot (se sonon stati precedentemente impostati); verranno elencati nell’area sottostante alla scritta “Talk Group Statici“.
Qui, solo a solo titolo di esempio, ho già inserito il TG 222 (Italia) sullo Slot 1 e il TG 22231 (regionale FVG) sullo Slot 2.

 

Gestione dei TG statici con un hotspot duplex

Tutte le modifiche che apporterete ai TG Statici e Dinamici dei vostri dispositivi hotspot, verranno aggiornate rapidamente sia nella pagina locale della Dashboard del vostro hotspot e anche nella pagina presente nel portale di BrandMeister.

Tramite questo stesso pannello dell’App, potete inserire altri TG Statici (utilizzando la stessa procedura usata dal pannello comandi del Pi-Star); ovvero inserendo prima lo Slot desiderato e poi il numero del TG Statico da attivare.

• Premete il pulsante Aggiungi Talk Group Statico;
• Si aprirà una piccola finestra, che chiederà di selezionare lo Slot in cui aggiungere il TG desiderato; (questa finestra di selezione appare solo se sono attivi entrambi i Time Slot);
• Selezionato lo Slot, si aprirà una successiva finestra di inserimento, dove viene chiesto di inserire il numero del TG che desiderate aggiungere. Confermate l’inserimento numerico, premendo il pulsante Aggiungi.

NOTA: Utilizzando un hotspot Simplex, si aprirà direttamente la finestra di selezione del TG.

 

Per eliminare un TG Statico presente, mantenete premuta l’area di descrizione del numero del TG e fate un movimento di trascinamento verso sinistra (l’area si colorerà di rosso e tolta la pressione del dito dall’area del TG, vi apparirà una finestra di richiesta (Rimuovi Talk Group Statico) per eliminare il TG statico.  Alla richiesta di rimozione, confermate con il pulsante OK.

In questo esempio, si è desiderato eliminare il TG Statico 222 dallo Slot 1 dell’hotspot. Premendo il pulsante Annulla, si rinuncia ad effettuare l’operazione di rimozione del TG Statico.

 

Menu Azioni Rapide

Le operazioni effettuabili da questo pannello di controllo sono molto semplici e richiedono poche prove per prendere la confidenza necessaria.
Toccate il menu a tendina denominato Azioni Rapide. Si aprirà la seguente pagina del programma.

Attraverso questi comandi, disponibili sia per gli hotspot simplex che duplex, avrete la possibilità di interrompere i QSO (DROP) che avvengono su i TG dei vostri dispositivi Hotspot.
Vediamo assieme che cosa prevedono:

• Interrompi Chiamata (Slot1). Se nel vostro hotspot sta avvenendo una conversazione (QSO) su un TG impostato nello Slot 1 che desiderate interrompere immediatamente, premete questo pulsante. Il QSO si interromperà immediatamente, fino alla ripresa del QSO successivo.
• Interrompi Chiamata (Slot2). Stessa azione del comando precedente, ma l’azione verrà effettuata su i TG presenti nello Slot 2.
• Interrompi TG Dinamici (Slot1). La pressione di questo pulsante farà disconnettere immediatamente tutti i TG Dinamici che erano presenti sullo Slot 1 del dispositivo.
• Interrompi TG Dinamici (Slot2). Stessa azione del comando precedente, ma l’azione verrà effettuata su i TG presenti nello Slot 2.

ATTENZIONE: Vi ricordo che nel caso si utilizzi un hotspot Simplex, l’ultimo TG utilizzato sull’hotspot verrà convertito in automatico in TG statico; questa regola viene detta “TG Autostatico”. Per scollegare anche questo TG dal vostro hotspot, sarà necessario inviare un comando di PTT con il TG 4000, oppure operare attraverso l’App, premendo il pulsante Interrompi TG Dinamici (Slot2).

Vi ricordo che anche da dentro il menu Azioni Rapide, è possibile aggiungere e rimuovere i TG Statici del dispositivo, effettuando le stesse operazioni indicate precedentemente.

 

Conclusioni

Siamo arrivati alla fine dell’articolo e spero che sia stato di vostro gradimento.
Vi informo che l’App Android funziona regolarmente sia con il WiFi casalingo e anche con la connessione di rete in 4G / 5G, in quanto l’App non si connette direttamente ai vostri hotspot / ripetitori personali, ma si connette direttamente e solo al server DMR di BrandMeister. 
In questo modo tutti i sysop dei vari hotspots potranno avere un controllo immediato e diretto dei propri sistemi, anche stando in mobilità.

Buon divertimento e sperimentazione con i sistemi radio digitali,
’73 de Paolo IV3BVK