Skip to main content

Quick Install - MAC

Navigation bar

GT500 Installation​

Quickly get started with the GT500 5G Dongle on macOS

Prerequisites​

  1. A Mac device
  2. Dongle GT500 and a Type-C data cable
  3. A Nano-SIM card with Internet service

Installing the Nano-SIM Card​

Image

  1. Find a plastic card and pry the cover open
  2. Gently pull out the SIM1 card holder, insert the Nano-SIM card, and push it back in place

Connecting to the Mac​

Image

Note

There is currently no serial driver for Mac computers, so the switch to ECM mode can only be done from Linux; please use Linux to switch it

  • AT+QCFG="usbnet",1: ECM mode (recommended for Linux systems)

Quick Configuration​

macOS has no serial driver, so AT commands cannot be sent from the Mac itself. Run the table below on Linux or Windows, then plug the Dongle back into the Mac.

Recommended order

PlatformCommands to run
Linux / Mac / Android1 → 2 → 4 (disable hot-swap → check mode → switch to ECM)
Windows1 → 2 → 3 (disable hot-swap → check mode → switch to RNDIS)
Dual-SIM modelsUse 6 (SIM1) or 7 (SIM2), then confirm +CPIN: READY
Changes not taking effectRun 8 AT+CFUN=1,1 to reboot the module

Every command below was tested on a RM520N-GL (firmware RM520NGLAAR03A04M4G, China Telecom 5G) and must be run on Linux (minicom -D /dev/ttyUSB2 -b 115200) or Windows (QCOM).

No.CommandNotesMeasured response
1AT+QSIMDET=0,0Disable SIM hot-swap detection; the first parameter 0 means offOK, reads back +QSIMDET: 0,0
2AT+QCFG="usbnet"Query the current USB mode (1=ECM, 0=RNDIS)+QCFG: "usbnet",1
3AT+QCFG="usbnet",0Switch to Windows mode (RNDIS); not recommended on MacOK, reads back +QCFG: "usbnet",0
4AT+QCFG="usbnet",1Switch to Linux / Mac mode (ECM); takes effect after AT+CFUN=1,1OK, reads back +QCFG: "usbnet",1
5AT+CPIN?Check the SIM; +CME ERROR: 10 = no card, SIM PIN = PIN locked+CPIN: READY
6AT+QUIMSLOT=1Switch to SIM1; re-reads the card in about 3~5 sOK, then +CPIN: READY
7AT+QUIMSLOT=2Switch to SIM2; CPIN: NOT READY when that slot is emptyOK, reads back +QUIMSLOT: 2
8AT+CFUN=1,1Reboot the module; USB re-enumerates after ~40 sOK, then the module disappears from USB and returns; no serial data in between
9AT&FFactory reset (AT command defaults only, NV settings untouched)OK; usbnet stays 1, QUIMSLOT stays 1, CGDCONT is not cleared; a few seconds of garbage / ERROR echoes afterwards
10ATIModel and firmware revisionQuectel / RM520N-GL / Revision: RM520NGLAAR03A04M4G
11AT+GMRFirmware revisionRM520NGLAAR03A04M4G
12AT+CGSNIMEI (15 digits on the real unit; middle 4 masked)86854906****457
13AT+QUIMSLOT?Current SIM slot+QUIMSLOT: 1
14AT+QSIMDET?Hot-swap detection switch+QSIMDET: 0,0
15AT+CSQMeaningless on 5G; use AT+QCSQ instead+CSQ: 99,99
16AT+QCSQ5G returns RSRP / RSRQ / SINR+QCSQ: "NR5G",-81,32,-10 (floats between -80 and -81 dBm)
17AT+CEREG?Registration status; 5G SA may return 0,0 while fully online+CEREG: 0,0 (still able to access the Internet)
18AT+COPS?Current operator+COPS: 0,0,"CHN-CT",11
19AT+QNWINFORAT / band / EARFCN+QNWINFO: "TDD NR5G","46011","NR5G BAND 78",620640
20AT+QENG="servingcell"Serving cell; cellID / TAC tail masked+QENG: "servingcell","NOCONN","NR5G-SA","TDD",460,11,75A0CB***,390,752A**,620640,78,12,-81,-10,32,1,-
21AT+CGDCONT?Current APN profiles4 lines: ctnet(1) / IMS(2) / ctwap(3) / sos(4), all IPV4V6
22AT+IPR?AT port baud rate+IPR: 115200
23AT+CFUN=0 / AT+CFUN=1RF off / on; quick way to reload configurationOK (no extra output)

IMEI, cellID and TAC are values from the real unit with sensitive digits masked; signal figures vary with location and weather.

Caution

AT&F does not reset usbnet / QUIMSLOT / APN on this firmware (it only restores AT command defaults), and the Mac still sees the RM520N-GL adapter afterwards. Other firmware versions may behave differently, so re-check AT+QCFG="usbnet" and AT+QUIMSLOT? after a factory reset.


Configuring the Dongle - Mac Side​

The factory default is already ECM (usbnet=1), so the Dongle usually works as soon as it is plugged into a Mac; step 1 below is only needed if the mode was changed.

1. Confirm / switch to ECM on Linux​

See Quick Install - Linux; serial parameters 115200 8N1:

root@OpenWrt:~# minicom -D /dev/ttyUSB2 -b 115200

Check the current mode:

AT+QCFG="usbnet"
+QCFG: "usbnet",1

OK

1 means ECM, no change needed. Otherwise switch and reboot the module:

AT+QCFG="usbnet",1
OK

AT+CFUN=1,1

After the reboot the module re-enumerates as a CDC-ECM adapter. Exit minicom with Ctrl + A → X → Yes.

2. Plug it into the Mac​

  1. Unplug the Dongle and connect it to the Mac's Type-C/USB port
  2. Open System Settings → Network; an Ethernet service named RM520N-GL appears
  3. Set the configuration to Using DHCP; the status turns "Connected" when successful

It normally receives 192.168.225.x/22 (the module itself is 192.168.225.1).

Verify in a terminal:

networksetup -listallhardwareports | grep -A 2 RM520N
ifconfig en10 # actual interface name may differ
ping -c 3 192.168.225.1

The enX name is assigned by macOS; look it up with networksetup or ifconfig rather than assuming.

3. Can I change the APN or send AT commands on Mac?​

No. macOS has no serial driver, and the Dongle's AT port does not show up under /dev/tty.usb*.

To change the APN, switch modes or check signal, go back to Linux or Windows.

4. FAQ​

SymptomCause / Resolution
No RM520N-GL in NetworkThe module is not in ECM mode; switch to usbnet=1 and run AT+CFUN=1,1
Adapter exists but no IPping 192.168.225.1 first; if it fails, the mode or driver is wrong — replug or switch mode again
Adapter connected but web pages do not loadSIM not registered or wrong APN; go back to Linux and check AT+CSQ, AT+CEREG?
Dongle disappears after changing usbnetMode mismatch; plug it back into Linux and restore 1 via /dev/ttyUSB2
AI Translation Notice

This page was translated into English by AI and is provided for reference only. The original document is written in Chinese. If there is any discrepancy, the Chinese version prevails.

本页英文内容由 AI 自动翻译生成,仅供参考;原文为中文,如有差异请以中文原文为准。

查看中文原文 / View the Chinese original →