Skip to content

02 Intro to Azure Sphere RemoteX

Jump to bottom
Dave Glover edited this page Jan 31, 2022 · 5 revisions

Setting started with Azure Sphere RemoteX development

Azure Sphere RemoteX enables remote access to Azure Sphere peripherals and mutable storage. It consists of two components. The Azure Sphere RemoteX Service that runs on the Azure Sphere and listens for requests on a network socket. There the Azure Sphere RemoteX client library that is is called from your desktop C POSIX application. The RemoteX client library provides transparent access to the RemoteX service running on the Azure Sphere. The RemoteX Client library is API compatible with the Azure Sphere peripheral and mutable storage APIs.

AzureSphereRemoteX repos

The following lists the repos for the two Azure Sphere RemoteX components:

Video introduction to Azure Sphere RemoteX

Azure Sphere RemoteX

Remote configuration

The RemoteX.cmake file is used to configure the following information:

  1. The Azure Sphere developer board you are using.
  2. The IP Address of your Azure Sphere Developer board
  3. And if to enable RemoteX Performance mode. Performance mode is enabled for SPI transaction not requiring a response. Performance mode improves writes to devices such as LED panels.

Configuring RemoteX

Follow these steps:

  1. Open the RemoteX.cmake file in VS Code or Visual Studio
  2. Update the configuration
  3. Save the file
  4. Rebuild the CMake cache.
    • From Visual Studio Code, press F1, select Delete Cache and reconfigure.
  5. Rebuild the project
    • From Visual Studio Code, press F1, select Clean Rebuild.

RemoteX.cmake example

##################################################################################################################
# IMPORTANT READ
#
# You must rebuild the CMakeLists cache if you change any options here.
# In Visual Studio Code, press F1, select Delete Cache and Reconfigure.
# Visual Studio will regenerate the CMakeLists when any file prefixed with .cmake is updated
#
##################################################################################################################

##################################################################################################################
# Select your developer board by removing the # tag from the beginning of the line
# If you are NOT using the AVNET Revision 1 board be sure to comment out the AVNET board
#
set(AVNET TRUE "AVNET Azure Sphere Starter Kit Revision 1")    
# set(AVNET_REV_2 TRUE "AVNET Azure Sphere Starter Kit Revision 2")             
# set(SEEED_STUDIO_RDB TRUE "Seeed Studio Azure Sphere MT3620 Development Kit (aka Reference Design Board or RDB)")
# set(SEEED_STUDIO_MINI TRUE "Seeed Studio Azure Sphere MT3620 Mini Dev Board")
#
##################################################################################################################

##################################################################################################################
# Uncomment if using AZURE SPHERE REMOTE remote peripheral over network access
add_compile_definitions(AZURE_SPHERE_REMOTEX_IP="192.168.10.117")
##################################################################################################################


##################################################################################################################
# Comment out to disable performance mode
add_compile_definitions(AZURE_SPHERE_REMOTEX_PERFORMANCE_MODE)
##################################################################################################################
Clone this wiki locally