As previously announced on September 21, 2021, the following changes have now been applied to the Harvest Data "Download content as JSON" and "Download chart data as JSON/CSV" functions, which are available on the Harvest Data page of the Soracom User Console:

• Update date and time format
• Add Simple Location Tracking data
• Remove contentType property

For more details about these changes, please refer to the SORACOM Harvest Data Download format change notice.

Previously, Soracom sent important notification emails related to your account from the email address no-reply@soracom.jp. Now, these emails will be sent from the email address no-reply@soracom.io. This change will apply to the system notifications that are sent by Soracom when performing the following operations:

• Creating a new Soracom account
• Adding and verifying an email address
• Changing the primary email address of an account
• Resetting a password or Multi-Factor Authentication setting

The email address used in system notifications for operations other than those listed above will not be changed.

As of September 27, 2021, prices for the following Japan-only devices have been revised. Prices are in Japanese Yen (¥) and include Japanese consumption tax.

LTE Cat.1 Module EC21-J Mini PCIe with GNSS

• Old price: ¥4,708
• New price: ¥6,358 (includes a ¥1,000 Soracom platform service coupon)

For more details, visit the product page (Japanese).

LTE Cat.M Module BG96 Mini PCIe

• Old price: ¥3,278 (includes a ¥300 Soracom platform service coupon)
• New price: ¥4,378 (includes a ¥1,000 Soracom platform service coupon)

For more details, visit the product page (Japanese).

LTE-M Shield for Arduino

• Old price: ¥6,578 (includes a ¥1,000 Soracom platform service coupon)
• New price: ¥7,128 (includes a ¥1,500 Soracom platform service coupon)

For more details, visit the product page (Japanese).

When using SORACOM Harvest to capture and store data from your devices, you can easily view and download the data directly from the User Console. This update introduces several changes when downloading data in order to improve precision and support additional features.

This update will take effect on September 21.

Note that these changes apply only to the following options in the Soracom User Console:

• Downloading data using the "Download content as JSON" option
• Downloading data using the "Download chart data as JSON" option
• Downloading data using the "Download chart data as CSV" option

This update does not affect the response format returned when retrieving data using the Harvest Data APIs.

Date and time format

Currently, the date and time that corresponds to each data entry is output using the format Sep, 16, 2021 13:45, with minute precision.

With this update, the date and time format will be changed to the ISO 8601 format, and will include both millisecond precision and time zone information, in order to provide more precision and to be easier for various applications to process. The new output will use the format 2021-09-16T13:45:59.123-08:00.

An exception to this is the "Download chart data as CSV" option, where the original date and time format will also be included in order to maintain compatibility with spreadsheet applications:

• The __time column will follow the original date and time format, and will be updated to include second precision using the format Sep, 16, 2021 13:45:59.
• A __iso8601Time column will be added to the CSV and will use the ISO 8601 format of 2021-09-16T13:45:59.123-08:00.

Simple Location Tracking data

Simple Location Tracking (in Japanese) is an optional service for plan-KM1 SIMs that determines the approximate geographic location of a device based on its cellular connection, without the device needing its own GPS or Wi-Fi positioning functionality.

While the longitude and latitude data provided by Simple Location Tracking is automatically combined with other data uploaded by a device to Harvest Data (as well as other Soracom services), this location data was not included when using the "Downloading content as JSON" option.

With this update, the location data follow the same format as the Harvest Data API response format (in Japanese), and will be included as a metadata property for each data entry.

Remove contentType property

With this update, the contentType property previously included when downloading data using the "Download chart data as JSON" and "Download chart data as CSV" options will no longer be included.

Data format samples

When downloading data using the "Download content as JSON" option, the new format will look like this:

[
  {
    "resourceType":"Subscriber",
    "resourceId":"295050012345678",
    "time":"2021-09-16T13:45:59.123-08:00",
    "contentType":"application/json",
    "content":{
      "clickType":2,
      "clickTypeName":"DOUBLE",
      "batteryLevel":1,
      "binaryParserEnabled":true
      //...other data from device
    },
    "metadata":{
      "locationQueryResult":"success",
      "location":{
        "lat": "47.6062",
        "lon": "-122.3321"
      }
    }
  },
  // ...other data entries
]

When downloading data using the "Download chart data as JSON" option, the new format will look like this:

[
  {
    "resourceType":"Subscriber",
    "resourceId":"295050012345678",
    "time":"2021-09-16T13:45:59.123-08:00",
    "chartData":{
      "clickType":2,
      "batteryLevel":1,
      "$metadata.location.lat":"47.6062",
      "$metadata.location.lon":"-122.3321"
      //...other data from device
    }
  },
  // ...other data entries
]

When downloading data using the "Download chart data as CSV" option, the new format will look like this:

__resourceType,__resourceId,__time,__iso8601Time,$metadata.location.lat,$metadata.location.lon,batteryLevel,clickType
"Subscriber","295050012345678","Sep, 16, 2021 13:45:59","2021-09-16T13:45:59.123-08:00","47.6062","-122.3321","1","2"
...

Two new reference devices, the I-O DATA WN-CS300FR LTE Router and the I-O DATA UD-LT1/EX Industrial LTE Router, are now available on the Soracom IoT Store (Japan).

WN-CS300FR LTE Router

• Compatible Soracom subscriptions: plan-D, plan-DU, plan-K, plan01s, planP1, planX1, planX2
• Supported countries and regions: Japan
• Price: 14,850 yen (tax included, bundled with a 1,500 yen Soracom service coupon)

For more details or to purchase, please visit the product page (Japanese).

UD-LT1/EX Industrial LTE Router

• Compatible Soracom subscriptions: plan-D, plan-DU, plan-K, plan01s, planX1, planX2
• Supported countries and regions: Japan
• Price: 29,700 yen (tax included, bundled with a 2,200 yen Soracom service coupon)

For more details or to purchase, please visit the product page (Japanese).

Connectivity Diagnostics is a tool that allows you to easily investigate the connection status of your SIMs.

Prior to this update, to check diagnostics for different SIMs, you had to return to the SIM Management page of the User Console in order to run diagnostics for each SIM.

With this update, you can now quickly diagnose another SIM by searching its name, IMSI, or SIM ID, without going back to the SIM Management page:

For more information about Connectivity Diagnostics, please refer to the documentation.

Currently, Soracom sends important notification emails related to your account from the email address no-reply@soracom.jp.

On September 28, 2021, this address will be changed to no-reply@soracom.io. This change will apply to the system notifications that are sent by Soracom when performing the following operations:

• Creating a new Soracom account
• Adding and verifying an email address
• Changing the primary email address of an account
• Resetting a password or Multi-Factor Authentication setting

The email address used in system notifications for operations other than those listed above will not be changed.

The date of this update may be subject to change without notice.

Event Handler is a service that allows you to build automations that react to different SIM events. An event handler consists of a rule and one or more actions, which can be freely combined to fit a variety of situations, as well as variables which can be used to customize certain actions.

• Examples of rules that Event Handler can check:

  • Perform an action when a SIM is activated (its status changes to Active)
  • Perform an action when a SIM exceeds 1 GiB of data transfer within one month
  • Perform an action when a SIM's expiration date has passed

• Examples of action that Event Handler can perform:

  • Send a notification by email
  • Change the speed class of the SIM
  • Call an AWS Lambda function

Event Handler has been updated and now supports the following additional rules, actions, and variables:

New Rule: Match when a SIM status is changed to Standby

The Target Status property of the Sim status attribute and Subscriber status attribute rules can now be set to Standby. With this configuration, an Event Handler will run its actions when a SIM's status is changed to Standby.

Updated Rule: Match source SIM status

In addition to configuring an Event Handler rule to run its actions when a SIM's status is changed to a specific status (such as when a SIM status changes to Active or Inactive), you can now also match a specific SIM status before the status change.

This gives you finer control over your devices, such as running different actions when a SIM changes from Ready to Active, than when it changes from Inactive to Active.

New Action: Suspend a SIM

You can now choose to suspend a SIM (change its status to Suspended) as an action to perform when an Event Handler's rule is matched.

• Note: A fee may apply

  Note that a suspension fee or a reactivation fee will apply when changing a SIM status to or from the Suspended status, respectively, depending on the subscription plan of the SIM. For more information, refer to the Pricing & Fee Schedule documentation.

New Variable: Coverage Type

Event Handlers only apply to the coverage type in which they are created. In other words, an Event Handler created for Global coverage will only apply to SIMs which are also managed in the Global coverage type, and likewise for Japan coverage. If you have configured Event Handlers in both coverage types, you can now use the ${coverage} variable in the Send email, Send mail to operator, Execute web request, and Invoke AWS Lambda actions to differentiate which coverage type the action is coming from. This variable will return the following values:

• When an Event Handler in Global coverage executes, ${coverage} will be replaced with g
• When an Event Handler in Japan coverage executes, ${coverage} will be replaced with jp

For more information, please refer to the Event Handler documentation.

SORACOM Arc, a secure link service that allows compatible devices to connect directly to Soracom using any standard Internet connection, now supports connectivity using IPv6.

When configuring Arc, configuration details will be issued, which your device can then use to connect to Soracom. These configuration details include a connection endpoint which consists of a domain name like *.arc.soracom.io.

With this update, when your device looks up the domain name specified by the connection endpoint, both IPv4 (A record) and IPv6 (AAAA record) addresses will be returned:

$ nslookup abc.arc.soracom.io
Server:         192.168.0.1
Address:        192.168.0.1#53

Non-authoritative answer:
Name:   abc.arc.soracom.io
Address: 54.11.22.33
Name:   abc.arc.soracom.io
Address: 2406:d014:3333:4444:5555:6666:7777:8888

Your device can then use the IPv6 address to connect to Soracom.

Compatibility

In order for your device to connect using IPv6, both the device itself and all network elements between the device and Soracom must support IPv6. For example, if your device is connected via Wi-Fi to a router, the router must support IPv6 networking, and your Internet Service Provider must also provide you with an IPv6 address.

If you are using the soratun tool to configure and manage the SORACOM Arc connections on your device, you will also need to upgrade soratun to version 1.1.0 or later. You can check which version is currently installed by running soratun version.

SORACOM Harvest is a data collection and storage service that allows you to easily capture and save data from devices without the need to set up and configure servers or other cloud services.

Soracom is pleased to announce updates to the Harvest Data interface on the SORACOM User Console, to help make accessing and visualizing data more intuitive.

Improved Layout

The Harvest Data interface layout has been improved to make accessing the following features easier:

• Showing or hiding individual data series in graphs
• Displaying detailed data when clicking on a data point in a graph or map
• Specifying which data properties should be used for latitude and longitude when displaying data on a map
• Automatically refreshing to check for new data
• Enabling or disabling the Extended Data Retention Option

Easier Searching

The Harvest Data interface now provides quick shortcuts for specifying a time range for the shown data, such as "Last 1 hour," "Last 7 days," or "All Time."

When changing the time range, the User Console will now also dynamically update the URL to match the specified time range. You can use this to save a link and easily return to the same view later.

• Relative and Absolute Times

  Please note that when selecting a Relative Time range such as "Last 7 days," the URL will only include the relative time range. As a result, when accessing the URL later, the time range shown in Harvest Data will be updated relative to the current time.

  If you want to save a URL in order to return to the same time range later, specify an Absolute Time range instead.