Phonebook and other functionalities.

.github/workflows/arduino_ci.yml

@@ -34,5 +34,6 @@ jobs:
           arduino-cli compile --fqbn arduino:avr:uno --library src --build-path build examples/card_info/card_info.ino
           arduino-cli compile --fqbn arduino:avr:uno --library src --build-path build examples/handshake/handshake.ino
           arduino-cli compile --fqbn arduino:avr:uno --library src --build-path build examples/network_op/network_op.ino
+          arduino-cli compile --fqbn arduino:avr:uno --library src --build-path build examples/phonebook_example/phonebook_example.ino
           arduino-cli compile --fqbn arduino:avr:uno --library src --build-path build examples/rtc_example/rtc_example.ino
           arduino-cli compile --fqbn arduino:avr:uno --library src --build-path build examples/sms_send_example/sms_send_example.ino

README.md

@@ -26,6 +26,7 @@ The SIM900 Arduino Shield Library is a versatile and powerful Arduino library fo
 - **Real-Time Clock**: Update and extract real-time clock data from the module.
 - **HTTP Requests**: Send HTTP requests and retrieve responses.
 - **Information Retrieval**: Gather data about network operator, module status, SIM card information, and more.
+- **Phonebook Management**: Store and retrieve phonebook accounts.
 - **Extensive Documentation**: Well-documented code and usage examples.
 
 ## Getting Started

examples/phonebook_example/phonebook_example.ino

@@ -0,0 +1,49 @@
+#include <SoftwareSerial.h>
+#include <sim900.h>
+
+SoftwareSerial shieldSerial(7, 8);
+
+void setup() {
+  Serial.begin(9600);
+  SIM900 sim900(&shieldSerial);
+  uint8_t index = 1;
+
+  SIM900CardAccount account;
+  account.name = "Nathanne Isip";
+  account.number = "00000000000";
+  account.numberType = SIM900_PHONEBOOK_NATIONAL;
+
+  Serial.println(F("Storing to phonebook..."));
+  if(!sim900.savePhonebook(index, account)) {
+    Serial.println(F("Error saving to phonebook."));
+    return;
+  }
+
+  Serial.println(F("Stored!"));
+  Serial.println(F("--------------------------"));
+  Serial.println(F("Retrieving..."));
+
+  SIM900CardAccount retrieved = sim900.retrievePhonebook(index);
+  Serial.print(F("Name:\t"));
+  Serial.println(retrieved.name);
+
+  Serial.print(F("Number:\t"));
+  Serial.println(retrieved.number);
+
+  Serial.print(F("Type:\t"));
+  switch(retrieved.numberType) {
+    case SIM900_PHONEBOOK_INTERNATIONAL:
+      Serial.println("International");
+      break;
+
+    case SIM900_PHONEBOOK_NATIONAL:
+      Serial.println("National");
+      break;
+
+    default:
+      Serial.println("Unknown");
+      break;
+  }
+}
+
+void loop() { }

src/sim900.cpp

@@ -69,6 +69,19 @@ bool SIM900::handshake() {
     return this->isSuccessCommand();
 }
 
+bool SIM900::isCardReady() {
+    this->sendCommand(F("AT+CPIN?"));
+    return this->isSuccessCommand();
+}
+
+bool SIM900::changeCardPin(uint8_t pin) {
+    if(pin > 9999)
+        return false;
+
+    this->sendCommand("AT+CPIN=\"" + String(pin) + "\"");
+    return this->isSuccessCommand();
+}
+
 void SIM900::close() {
     this->sim900->end();
 }
@@ -313,6 +326,11 @@ SIM900CardAccount SIM900::retrievePhonebook(uint8_t index) {
     return accountInfo;
 }
 
+bool SIM900::deletePhonebook(uint8_t index) {
+    this->sendCommand("AT+CPBW=" + String(index));
+    return this->isSuccessCommand();
+}
+
 SIM900CardAccount SIM900::cardNumber() {
     this->sendCommand(F("AT+CNUM"));
 

src/sim900.h

@@ -25,6 +25,9 @@ class SIM900 {
     bool handshake();
     void close();
 
+    bool isCardReady();
+    bool changeCardPin(uint8_t pin);
+
     SIM900DialResult dialUp(String number);
     SIM900DialResult redialUp();
     SIM900DialResult acceptIncomingCall();
@@ -43,7 +46,8 @@ class SIM900 {
     bool updateRtc(SIM900RTC config);
 
     bool savePhonebook(uint8_t index, SIM900CardAccount account);
-    SIM900CardAccount retrievePhonebook(uint8_t index);
+    bool deletePhonebook(uint8_t index);
+    SIM900CardAccount retrievePhonebook(uint8_t index);    
 
     String manufacturer();
     String softwareRelease();