Ashley Mills / ATConsole

This is a console for interacting with Vodafone dongles.

Dependencies:   mbed-rtos VodafoneUSBModem mbed

This is a bridge between a serial driven console and a serial driven cellular modem or modem interface. This was written to complement our collaboration with mbed: See https://mbed.org/users/mbed_official/code/VodafoneUSBModem/ for further information.

For example, one can use GNU screen or PuTTY (two popular consoles) to interact with a Vodafone K3770 USB dongle. In the image below I used the UNIX version of PuTTY:

/media/uploads/ashleymills/atcons.png

Support is provided for line-based consoles, which send one line at a time, and for character based consoles.

For character based consoles, the following line-editing features are provided:

  • In-line editing (deletion, left/right arrow keys, insertion)
  • Command history (via up/down arrow keys)

Line buffer length, and command history depth, are compile-time options.

--

How to use:

Compile and save to mbed.

Connect PuTTY or GNU screen to serial port.

If you use GNU screen you probably already know what you are doing.

If you use PuTTY, you need to set the options to specify the serial device and, set the baud rate, and set the "Connection Type" to "Serial":

/media/uploads/ashleymills/putty0.png

You need to set the keyboard to send Control-H for backspace, and use "Linux" function keys and keypad:

/media/uploads/ashleymills/putty1.png

ATConsole.cpp@11:76ecb8799b0d, 2013-01-10 (annotated)

Committer:
ashleymills
Date:
Thu Jan 10 11:11:27 2013 +0000
Revision:
11:76ecb8799b0d
Parent:
8:fc50785435c5
Child:
12:c087d25ec3b8
Added Mu509 functionality

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ashleymills 0:6c831cc49d22 1 #include "ATConsole.h"
ashleymills 2:8cc63f7a24cf 2 #include "ATCommandsInterface.h"
ashleymills 0:6c831cc49d22 3
ashleymills 4:6971bded3ebd 4 ATConsole::ATConsole(
ashleymills 4:6971bded3ebd 5 Serial *terminal,
ashleymills 4:6971bded3ebd 6 int lineLength,
ashleymills 4:6971bded3ebd 7 int numLines,
ashleymills 4:6971bded3ebd 8 bool characterBased,
ashleymills 4:6971bded3ebd 9 ATCommandsInterface* atInterface)
ashleymills 4:6971bded3ebd 10 : Console(terminal,lineLength,numLines,characterBased), _atInterface(atInterface) {
ashleymills 4:6971bded3ebd 11
ashleymills 4:6971bded3ebd 12 // constructor
ashleymills 4:6971bded3ebd 13 atInterface->registerEventsHandler(this);
ashleymills 2:8cc63f7a24cf 14 _gettingSMSData = false;
ashleymills 0:6c831cc49d22 15 }
ashleymills 0:6c831cc49d22 16
ashleymills 0:6c831cc49d22 17 ATConsole::~ATConsole() {
ashleymills 0:6c831cc49d22 18
ashleymills 0:6c831cc49d22 19 }
ashleymills 0:6c831cc49d22 20
ashleymills 0:6c831cc49d22 21 void ATConsole::processCommand() {
ashleymills 3:6b3ca3af97cf 22 if(strlen(_lineBuffer)==0)
ashleymills 3:6b3ca3af97cf 23 return;
ashleymills 7:f46ec146f3de 24 //_terminal->printf("ATConsole::processCommand()\r\n");
ashleymills 8:fc50785435c5 25 _terminal->printf("\r\n");
ashleymills 2:8cc63f7a24cf 26 if(_gettingSMSData) {
ashleymills 3:6b3ca3af97cf 27 _terminal->printf("_gettingSMSData %s\r\n",_lineBuffer);
ashleymills 3:6b3ca3af97cf 28 strcpy(_smsMessage,_lineBuffer);
ashleymills 2:8cc63f7a24cf 29 _gettingSMSData = false;
ashleymills 2:8cc63f7a24cf 30 return;
ashleymills 2:8cc63f7a24cf 31 }
ashleymills 2:8cc63f7a24cf 32
ashleymills 0:6c831cc49d22 33 if((strncmp(_lineBuffer,"h",_lineLength)==0)||
ashleymills 0:6c831cc49d22 34 (strncmp(_lineBuffer,"help",_lineLength)==0)) {
ashleymills 1:719c0f047c34 35 _terminal->printf("Help.\r\n");
ashleymills 1:719c0f047c34 36 _terminal->printf(" \"connect\": Connect to 3G network.\r\n");
ashleymills 1:719c0f047c34 37 _terminal->printf(" \"disconnect\": Disconnect from 3G network.\r\n");
ashleymills 0:6c831cc49d22 38 return;
ashleymills 0:6c831cc49d22 39 }
ashleymills 3:6b3ca3af97cf 40
ashleymills 4:6971bded3ebd 41 if(!_characterBased) {
ashleymills 4:6971bded3ebd 42 _lineBuffer[strlen(_lineBuffer)-2]=0x00;
ashleymills 4:6971bded3ebd 43 }
ashleymills 4:6971bded3ebd 44
ashleymills 7:f46ec146f3de 45 //_terminal->printf("\r\ncmd: \"%s\"(%d)\r\n",_lineBuffer,strlen(_lineBuffer));
ashleymills 1:719c0f047c34 46 _atInterface->execute(_lineBuffer, this, &_cmdResult, 1000);
ashleymills 2:8cc63f7a24cf 47
ashleymills 3:6b3ca3af97cf 48 if(_cmdResult.result==ATCommandsInterface::ATResult::AT_OK&&!_gettingSMSData) {
ashleymills 2:8cc63f7a24cf 49 clearBuffer();
ashleymills 2:8cc63f7a24cf 50 _terminal->printf("OK\r\n");
ashleymills 2:8cc63f7a24cf 51 }
ashleymills 0:6c831cc49d22 52 }
ashleymills 0:6c831cc49d22 53
ashleymills 0:6c831cc49d22 54 void ATConsole::update() {
ashleymills 0:6c831cc49d22 55 Console::update();
ashleymills 1:719c0f047c34 56 }
ashleymills 1:719c0f047c34 57
ashleymills 1:719c0f047c34 58 int ATConsole::onNewATResponseLine(ATCommandsInterface* pInst, const char* line) {
ashleymills 8:fc50785435c5 59 _terminal->printf("%s\r\n",line);
ashleymills 1:719c0f047c34 60 return OK;
ashleymills 1:719c0f047c34 61 }
ashleymills 1:719c0f047c34 62
ashleymills 1:719c0f047c34 63 int ATConsole::onNewEntryPrompt(ATCommandsInterface* pInst) {
ashleymills 11:76ecb8799b0d 64 storeBuffer();
ashleymills 11:76ecb8799b0d 65 clearBuffer();
ashleymills 3:6b3ca3af97cf 66 _terminal->printf("new entry prompt\r\n");
ashleymills 3:6b3ca3af97cf 67 _terminal->printf(">\r\n");
ashleymills 2:8cc63f7a24cf 68 _gettingSMSData = true;
ashleymills 2:8cc63f7a24cf 69 while(_gettingSMSData) {
ashleymills 2:8cc63f7a24cf 70 update();
ashleymills 2:8cc63f7a24cf 71 Thread::wait(10);
ashleymills 2:8cc63f7a24cf 72 }
ashleymills 3:6b3ca3af97cf 73 _terminal->printf("about to send: \"%s\"\r\n",_smsMessage);
ashleymills 3:6b3ca3af97cf 74 _atInterface->sendData(_smsMessage);
ashleymills 1:719c0f047c34 75 return OK;
ashleymills 2:8cc63f7a24cf 76 }
ashleymills 2:8cc63f7a24cf 77
ashleymills 2:8cc63f7a24cf 78 void ATConsole::onEvent(const char* atCode, const char* evt) {
ashleymills 4:6971bded3ebd 79 _terminal->printf("Unsolicited result code: %s - %s\r\n", atCode, evt);
ashleymills 2:8cc63f7a24cf 80 }
ashleymills 2:8cc63f7a24cf 81
ashleymills 2:8cc63f7a24cf 82 /*virtual*/ void ATConsole::onDispatchStart() { }
ashleymills 2:8cc63f7a24cf 83
ashleymills 2:8cc63f7a24cf 84 /*virtual*/ void ATConsole::onDispatchStop() { }
ashleymills 2:8cc63f7a24cf 85
ashleymills 4:6971bded3ebd 86 bool ATConsole::isATCodeHandled(const char* atCode) {
ashleymills 4:6971bded3ebd 87 if(strcmp("+CUSD", atCode) == 0 ) {
ashleymills 4:6971bded3ebd 88 return true;
ashleymills 4:6971bded3ebd 89 }
ashleymills 4:6971bded3ebd 90 return false;
ashleymills 11:76ecb8799b0d 91 }
ashleymills 11:76ecb8799b0d 92
ashleymills 11:76ecb8799b0d 93 /*virtual*/ char* ATConsole::getEventsEnableCommand() {
ashleymills 11:76ecb8799b0d 94 return NULL; // no need to disable or enable commands
ashleymills 11:76ecb8799b0d 95 }
ashleymills 11:76ecb8799b0d 96
ashleymills 11:76ecb8799b0d 97 /*virtual*/ char* ATConsole::getEventsDisableCommand() {
ashleymills 11:76ecb8799b0d 98 return NULL;
ashleymills 4:6971bded3ebd 99 }