Package Exports

jsgsm
jsgsm/bin/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (jsgsm) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

jsgsm