arduino-libraries / Arduino_Cellular

A library which provides a toolkit for interacting with the official Arduino Pro 4G Modules.
Mozilla Public License 2.0
3 stars 3 forks source link
iot

📡 Arduino Cellular

Arduino Lint Compile Examples Spell Check Sync Labels Render Documentation

This library provides a toolkit for interacting with the official Arduino 4G Modules (EMEA and Global Versions). It allows you to connect to the internet, send and receive SMS messages, and get location from the cellular network or GPS.

Examples

✨ Features

👀 Instructions

  1. Insert a nano SIM card in the PCIE_SIM connector on the Arduino Portenta Mid Carrier.

  2. Connect the Serial (J17) to the adjacent PCIE Breakout Pins (J16) with jumpers included in the Portenta Mid Carrier: Serial 1 (J17) PCIE Breakout (J16)
    RX (Pin 1) CK_N (Pin 1)
    TX (Pin 2) CK_P (Pin 3)
    RTS (Pin 3) RX_N (Pin 5)
    CTS (Pin 4) RX_P (Pin 7)
    mPCIE_GPIO_RST (Pin 5) mPCIE_RST (Pin 9)
    Portenta Mid Carrier with Portenta H7 and PCIE Breakout Pin Configuration
  3. On J9, using jumpers connect the following pins: Source (J9) Buck Converter (J9)
    3V3 PCIE (Pin 1) 3V3 BUCK (Pin 3)
    OUT VCC (Pin 2) 3V3 BUCK EN (Pin 4)
    Portenta Mid Carrier SIM and Power Pin Configuration
  4. Insert the Arduino Pro 4G Module in the Arduino Portenta Mid Carrier.

  5. Screw one black post with a white nut from under the Portenta Mid Carrier. Using another black post, screw the board to the post. Place two washers on top, and one underneath the Pro 4G Module. So that the board is fixed to the post snuggly and horizontally.

  6. (EMEA and GNSS variants) Connect the cellular antenna (flat antenna in Arduino Pro 4G Module Antennas Kit) to the left microUFL connector marked MAIN.

  7. (PRO 4G GNSS only) Connect the GNSS antenna (square antenna in Arduino Pro 4G Module Antennas Kit) to the middle microUFL connector marked GNSS.

    Portenta Mid Carrier with Pro 4G Module GNSS with both the MAIN and GNSS antennas connected
  8. Insert a Portenta C33 or Portenta H7 Board into the marked location. The USB-C port of the Portenta board should be next to the Ethernet port on the Mid Carrier.

  9. Insert a Terminal Block 2-pin > DC female adapter into the screw terminal (J4). Ensure that the negative (-) pin is connected to GND.

    Portenta Mid Carrier with Portenta C33 and Pro 4G Module GNSS with all antennas connected
  10. Use a 5V adapter that can output at least 3A and connect it to the DC female adapter.

  11. Connect the Portenta board to your computer using a USB-C cable.

  12. Install the Arduino_Cellular library and its dependencies

  13. Obtain the APN (Access Point Name) settings from your network operator and add them to the arduino_secrets.h file for each sketch. For example:

    #define SECRET_PINNUMBER     "" // replace with your SIM card PIN
    #define SECRET_GPRS_APN      "services.telenor.se" // replace with your GPRS APN
    #define SECRET_GPRS_LOGIN    ""    // replace with your GPRS login
    #define SECRET_GPRS_PASSWORD "" // replace with your GPRS password
  14. Upload sketch to the Portenta board. Enjoy!

📖 Documentation

For more information about this library please read the documentation here.