Can I use SCP to move a file into Azure Sphere?

Question

I am wishing to move a configuration file for Azure Sphere. Naturally SCP over SSH would work nicely. Can anyone direct me to a solution? I will have to modify the file sometimes depending on the layout of the equipment in use.

Thanks.

wizio · Accepted Answer

So... user files READ ONLY Files Packed files to application-image on compilation User Home Dir ( read-only mount folder ) /mnt/apps/GUID_FROM_APP_MANIFEST/ packed_file_name.1 , packed_file_name.2 , ... int Storage_OpenFileInImagePackage ( "packed_file_name" ); return FD of /mnt/apps/GUID_FROM_APP_MANIFEST/packed_file_name READ & WRITE Mutable Storage User Home Dir (read-write mount folder, size = "MutableStorage": { "SizeKB": 8 } /mnt/config/GUID_FROM_APP_MANIFEST/ Storage_OpenMutableFile () return FD of file name /mnt/config/GUID_FROM_APP_MANIFEST/default Folder /mnt/config/GUID_FROM_APP_MANIFEST can store other files, but by default open() not exist ... How to read, write, upload, download file/s ... user-ware App: Azure Explore
MUTABLE READ[0] 
MUTABLE WRITE[20] = "Mutable Storage Text"
MUTABLE READ[20] Mutable Storage Text

[TEST] OPEN: test.txt (fd = 4) No error information (0).

FOLDER: /mnt/config/dfb1b8e6-90a9-4480-a8c6-6267e5aed1a9
 FILE: /mnt/config/dfb1b8e6-90a9-4480-a8c6-6267e5aed1a9/test.txt
(empty) 
 FILE: /mnt/config/dfb1b8e6-90a9-4480-a8c6-6267e5aed1a9/default
Mutable Storage Text

bwilless · Answer

There are a few ways to move configuration data to a Sphere device . . .

If you only need to operate on one or two devices you could use a Direct Method call to send down a JSON object with your configuration:
1. https://www.element14.com/community/external-link.jspa?url=http%3A%2F%2Favnet.me%2Fazure_sphere_direct_method_blog
If you want to send a file to be included with your application build, you can package the file up into the image_package file. This Microsoft example (https://github.com/Azure/azure-sphere-samples/tree/master/Samples/ExternalMcuUpdate ) shows how to send a binary file to a Sphere device. Note that the sample uses the binary file to update a connected MCU, but you can take the file and pull your configuration data.
You could also use device twins to send configuration data to your device. The OOB examples #2 and #3, use device twins to do things like change the LEDs.

If you only need to operate on a single device, option #3 is simplest. While option #1 should be easy and give you more flexibility in the structure of your data.

Brian

wizio · Answer

Just hint: app_manifest.json can be used as read-only setting file see: my ... var_1 .... {
 "Name": "", 
 "Capabilities": {
 "Uart": ["$AVNET_AESMS_ISU0_UART"], 
 "AllowedConnections": []
 }, 
 "CmdArgs": [], 
 "EntryPoint": "", 
 "SchemaVersion": 1, 
 "ComponentId": "9FAFA94E-3CFA-4B1D-8A13-50B82539A9B7",
 "my" : {
 "var_1" : "1",
 "var_2" : "2",
 "var_3" : "3"
 }
} as example #include <applibs/storage.h> void foo(){ int fd = Storage_OpenFileInImagePackage( "app_manifest.json" ); char json_buffer[ 1024 ]; read(fd, json_buffer, sizeof (json_buffer)); //PARSE JSON VARIABLES close(fd); } the real file name is: /mnt/apps/GUID_FROM_APP_MANIFEST/app_manifest.json

wizio · Answer

Simple example how to use packed-image files with CURL as REST-API and certificates https://github.com/Wiz-IO/platform-azure/tree/master/Examples/ArduinoCurlAmazonRestApi

wizio · Answer

File System is real but is controled ( firewall ) from Pluton subsytem ... I dont know ( for now ) how to write file ... Pluton is as "dongle" ... hardware "sudo" There is MutableStorage for user ( not explored from me - this days I will ) This is file in user root folder with permition for write "home" folder is: /mnt/apps/GUID_FROM_APP_MANIFEST/ .... By default you not have access to function open() but have API for opening this MutableFile This days will explore ....

wizio · Answer

move file into module? module have "ssh" ( not sure for protocol over 443 ) only over "usb" ... you can pack files on compilation

bwilless · Answer

I'm not sure I see any advantage to using the app_manifest.json file to define application settings. You can do this, but the only way to change them in the field is to upload a new application to AS3 and push the changes down with an OTA update. This would be similar to using constants in your application. If you use device twins, or Direct Methods for configuration data you have a flexible implementation that does not require a new application build and you can push different values down for each device. My 2 cents . . .

Can I use SCP to move a file into Azure Sphere?

Top Replies