JSGSM CLI

A full-featured command-line tool for managing SMS via GSM modems (Huawei, Wavecom, Quectel, etc).

📦 Installation

Install globally via NPM:

npm install -g jsgsm

Requires Node.js and a supported GSM modem connected via serial/USB.

📖 Usage

jsgsm <command> [options]

Core Commands

| Command | Description | | ------------------------------------------ | --------------------------------------------------- | | --help | Show help / usage | | --version | Print CLI version | | --about | Show about & developer info | | --listport | List available serial ports | | --read <COM> | Read all SMS (text mode) | | --readunread <COM> | Read unread SMS only | | --readall <COM> | Read SMS from all storage (SM, ME, MT) | | --jsonout <COM> | Output SMS as JSON | | --backup <COM> | Save SMS to sms_backup.json | | --monitor <COM> | Real-time SMS monitoring | | --send <COM> <number> <message> | Send SMS (text mode) | | --delete <COM> <index> | Delete SMS by index | | --sendcmd <COM> <AT command> | Send raw AT command | | --sendpdu <COM> <PDU> <length> | Send SMS in PDU mode | | --pduencode <number> <message> [options] | Encode PDU string (customizable) | | --at <COM> <AT command> | Alias for --sendcmd | | --contacts <COM> | List SIM contacts | | --siminf <COM> | Show SIM & network info via AT commands | | --init <COM> | Initialize modem (disable echo, set text mode, etc) | | --pin <COM> <PIN> | Enter SIM PIN if required | | --ussd <COM> <code> | Send USSD code | | --balance <COM> | Check balance via USSD (*888#) | | --config <COM> [options] | Configure APN, dial, auth, network mode, etc. |

--pduencode Options

Customize PDU parameters:

--smsc <hex>   SMSC address (default: 00)
--mti  <hex>   Message Type Indicator (default: 11)
--mr   <hex>   Message Reference (default: 00)
--pid  <hex>   Protocol ID (default: 00)
--dcs  <hex>   Data Coding Scheme (default: 00)
--vp   <hex>   Validity Period (default: A7)

Example:

jsgsm --pduencode "08123456789" "Hello" --smsc 07911326040010F0 --vp 05

⚙️ Configuration

Use --config to set up APN, dial number, credentials, connection & network mode:

jsgsm --config COM3 --apn telkomsel --static --dial *99# \
  --user wap --pass wap123 --conn RAS --net HSDPA

🛠️ Requirements

• Node.js v14+ (ES Modules support)
• A supported GSM modem
• npm dependencies installed via npm install

🤝 Contributing

Feel free to open issues or pull requests on the GitHub repository.

👤 Developer

RasiTech

📜 License

MIT