Wireless AWS IoT esempi utilizzando AWS CLI

Per associare un account partner al tuo AWS account

L'associate-aws-account-with-partner-accountesempio seguente associa le seguenti credenziali dell'account Sidewalk al tuo account. AWS

aws iotwireless associate-aws-account-with-partner-account \
    --sidewalk AmazonId="12345678901234",AppServerPrivateKey="a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"

Output:

{
    "Sidewalk": {
        "AmazonId": "12345678901234",
        "AppServerPrivateKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"
    }
}

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Come associare un oggetto a un dispositivo wireless

L’esempio associate-wireless-device-with-thing seguente associa un oggetto al dispositivo wireless con l’ID specificato.

aws iotwireless associate-wireless-device-with-thing \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
    --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MyIoTWirelessThing"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come associare il certificato al gateway wireless

L’esempio associate-wireless-gateway-with-certificate seguente associa un gateway wireless a un certificato.

aws iotwireless associate-wireless-gateway-with-certificate \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
    --iot-certificate-id "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"

Output:

{
    "IotCertificateId": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"
}

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come associare un oggetto a un gateway wireless

L’esempio associate-wireless-gateway-with-thing seguente associa un oggetto a un gateway wireless.

aws iotwireless associate-wireless-gateway-with-thing \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
    --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MyIoTWirelessThing"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come creare una destinazione wireless IoT

L'create-destinationesempio seguente crea una destinazione per mappare un messaggio del dispositivo a una regola AWS IoT. Prima di eseguire questo comando, devi aver creato un ruolo IAM che fornisca a AWS IoT Core for LoRa WAN le autorizzazioni necessarie per inviare dati alla regola AWS IoT.

aws iotwireless create-destination \
    --name IoTWirelessDestination \
    --expression-type RuleName \
    --expression IoTWirelessRule \
    --role-arn arn:aws:iam::123456789012:role/IoTWirelessDestinationRole

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination",
    "Name": "IoTWirelessDestination"
}

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come creare un nuovo profilo del dispositivo

L’esempio create-device-profile seguente crea un nuovo profilo del dispositivo wireless IoT.

aws iotwireless create-device-profile

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come creare un nuovo profilo del servizio

L’esempio create-service-profile seguente crea un nuovo profilo del servizio wireless IoT.

aws iotwireless create-service-profile

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come creare un dispositivo wireless IoT

L'create-wireless-deviceesempio seguente crea una risorsa di dispositivo wireless di tipo LoRa WAN.

aws iotwireless create-wireless-device \
    --cli-input-json file://input.json

Contenuto di input.json:

{
    "Description": "My LoRaWAN wireless device"
    "DestinationName": "IoTWirelessDestination"
    "LoRaWAN": {
        "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333",
        "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100",
        "OtaaV1_1": {
            "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012",
            "JoinEui": "b4c231a359bc2e3d",
            "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4"
        },
        "DevEui": "ac12efc654d23fc2"
    },
    "Name": "SampleIoTWirelessThing"
    "Type": LoRaWAN
}

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f",
    "Id": "1ffd32c8-8130-4194-96df-622f072a315f"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come creare una definizione di attività del gateway wireless

L’esempio create-wireless-gateway-task-definition seguente crea automaticamente attività utilizzando questa definizione di attività per tutti i gateway con la versione corrente specificata.

aws iotwireless create-wireless-gateway-task-definition \
    --cli-input-json file://input.json

Contenuto di input.json:

{
    "AutoCreateTasks": true,
    "Name": "TestAutoUpdate",
    "Update":{
        "UpdateDataSource" : "s3://cupsalphagafirmwarebin/station",
        "UpdateDataRole" : "arn:aws:iam::001234567890:role/SDK_Test_Role",
        "LoRaWAN" :{
            "CurrentVersion" :{
                "PackageVersion" : "1.0.0",
                "Station" : "2.0.5",
                "Model" : "linux"
            },
            "UpdateVersion" :{
                "PackageVersion" : "1.0.1",
                "Station" : "2.0.5",
                "Model" : "minihub"
            }
        }
    }
}

Output:

{
    "Id": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come creare l’attività per un gateway wireless

L’esempio create-wireless-gateway-task seguente crea un’attività per un gateway wireless.

aws iotwireless create-wireless-gateway-task \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
    --wireless-gateway-task-definition-id "aa000102-0304-b0cd-ef56-a1b23cde456a"

Output:

{
    "WirelessGatewayTaskDefinitionId": "aa204003-0604-30fb-ac82-a4f95aaf450a",
    "Status": "Success"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come creare un gateway wireless

L'create-wireless-gatewayesempio seguente crea un gateway per dispositivi LoRa WAN wireless.

aws iotwireless create-wireless-gateway \
    --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \
    --name "myFirstLoRaWANGateway" \
    --description "Using my first LoRaWAN gateway"

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare una destinazione wireless IoT

L’esempio delete-destination seguente elimina la risorsa di destinazione wireless creata con il nome IoTWirelessDestination.

aws iotwireless delete-destination \
    --name "IoTWirelessDestination"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare un profilo del dispositivo

L’esempio delete-device-profile seguente elimina un profilo del dispositivo creato con l’ID specificato.

aws iotwireless delete-device-profile \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare un profilo del servizio

L’esempio delete-service-profile seguente elimina un profilo del servizio creato con l’ID specificato.

aws iotwireless delete-service-profile \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare un dispositivo wireless

L’esempio delete-wireless-device seguente elimina un dispositivo wireless con l’ID specificato.

aws iotwireless delete-wireless-device \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare una definizione di attività del gateway wireless

L’esempio delete-wireless-gateway-task-definition seguente elimina la definizione dell’attività del gateway wireless creata con il seguente ID.

aws iotwireless delete-wireless-gateway-task-definition \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare un’attività del gateway wireless

L’esempio delete-wireless-gateway-task seguente elimina l’attività del gateway wireless con l’ID specificato.

aws iotwireless delete-wireless-gateway-task \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come eliminare un gateway wireless

L’esempio delete-wireless-gateway seguente elimina un gateway wireless con l’ID specificato.

aws iotwireless delete-wireless-gateway \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Per dissociare l'account partner dall' AWS account

L'disassociate-aws-account-from-partner-accountesempio seguente dissocia un account partner dall'account attualmente associato. AWS

aws iotwireless disassociate-aws-account-from-partner-account \
    --partner-account-id "12345678901234" \
    --partner-type "Sidewalk"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come annullare l’associazione dell’oggetto al dispositivo wireless

L’esempio disassociate-wireless-device-from-thing seguente annulla l’associazione di un dispositivo wireless all’oggetto a cui è attualmente associato.

aws iotwireless disassociate-wireless-device-from-thing \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come annullare l’associazione del certificato al gateway wireless

L’esempio disassociate-wireless-gateway-from-certificate seguente annulla l’associazione di un gateway wireless al certificato a cui è attualmente associato.

aws iotwireless disassociate-wireless-gateway-from-certificate \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come annullare l’associazione dell’oggetto al gateway wireless

L’esempio disassociate-wireless-gateway-from-thing seguente annulla l’associazione di un gateway wireless all’oggetto a cui è attualmente associato.

aws iotwireless disassociate-wireless-gateway-from-thing \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core for LoRa WAN nella Guida per sviluppatori AWS IoT.

Come ottenere informazioni su una destinazione wireless IoT

L’esempio get-destination seguente ottiene informazioni sulla risorsa di destinazione creata con il nome IoTWirelessDestination.

aws iotwireless get-destination \
    --name "IoTWirelessDestination"

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination",
    "Name": "IoTWirelessDestination",
    "Expression": "IoTWirelessRule",
    "ExpressionType": "RuleName",
    "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole"
}

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni su un profilo del dispositivo

L’esempio get-device-profile seguente ottiene informazioni sul profilo del dispositivo creato con l’ID specificato.

aws iotwireless get-device-profile \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "LoRaWAN": {
    "MacVersion": "1.0.3",
    "MaxDutyCycle": 10,
    "Supports32BitFCnt": false,
    "RegParamsRevision": "RP002-1.0.1",
    "SupportsJoin": true,
    "RfRegion": "US915",
    "MaxEirp": 13,
    "SupportsClassB": false,
    "SupportsClassC": false
    }
}

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni sull’account partner

L’esempio get-partner-account seguente ottiene informazioni sull’account Sidewalk con il seguente ID.

aws iotwireless get-partner-account \
    --partner-account-id "12345678901234" \
    --partner-type "Sidewalk"

Output:

{
    "Sidewalk": {
        "AmazonId": "12345678901234",
        "Fingerprint": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"
    },
    "AccountLinked": false
}

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Come ottenere l’endpoint del servizio

L’esempio get-service-endpoint seguente ottiene l’endpoint specifico dell’account per il protocollo CUPS.

aws iotwireless get-service-endpoint

Output:

{
    "ServiceType": "CUPS",
    "ServiceEndpoint": "https://A1RMKZ37ACAGOT.cups.lorawan.us-east-1.amazonaws.com:443",
    "ServerTrust": "-----BEGIN CERTIFICATE-----\n
    MIIESTCCAzGgAwIBAgITBn+UV4WH6Kx33rJTMlu8mYtWDTANBgkqhkiG9w0BAQsF\n
    ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6\n
    b24gUm9vdCBDQSAxMB4XDTE1MTAyMjAwMDAwMFoXDTI1MTAxOTAwMDAwMFowRjEL\n
    MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEVMBMGA1UECxMMU2VydmVyIENB\n
    IDFCMQ8wDQYDVQQDEwZBbWF6b24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK\n
    AoIBAQDCThZn3c68asg3Wuw6MLAd5tES6BIoSMzoKcG5blPVo+sDORrMd4f2AbnZ\n
    cMzPa43j4wNxhplty6aUKk4T1qe9BOwKFjwK6zmxxLVYo7bHViXsPlJ6qOMpFge5\n
    blDP+18x+B26A0piiQOuPkfyDyeR4xQghfj66Yo19V+emU3nazfvpFA+ROz6WoVm\n
    B5x+F2pV8xeKNR7u6azDdU5YVX1TawprmxRC1+WsAYmz6qP+z8ArDITC2FMVy2fw\n
    0IjKOtEXc/VfmtTFch5+AfGYMGMqqvJ6LcXiAhqG5TI+Dr0RtM88k+8XUBCeQ8IG\n
    KuANaL7TiItKZYxK1MMuTJtV9IblAgMBAAGjggE7MIIBNzASBgNVHRMBAf8ECDAG\n
    AQH/AgEAMA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUWaRmBlKge5WSPKOUByeW\n
    dFv5PdAwHwYDVR0jBBgwFoAUhBjMhTTsvAyUlC4IWZzHshBOCggwewYIKwYBBQUH\n
    AQEEbzBtMC8GCCsGAQUFBzABhiNodHRwOi8vb2NzcC5yb290Y2ExLmFtYXpvbnRy\n
    dXN0LmNvbTA6BggrBgEFBQcwAoYuaHR0cDovL2NydC5yb290Y2ExLmFtYXpvbnRy\n
    dXN0LmNvbS9yb290Y2ExLmNlcjA/BgNVHR8EODA2MDSgMqAwhi5odHRwOi8vY3Js\n
    LnJvb3RjYTEuYW1hem9udHJ1c3QuY29tL3Jvb3RjYTEuY3JsMBMGA1UdIAQMMAow\n
    CAYGZ4EMAQIBMA0GCSqGSIb3DQEBCwUAA4IBAQCFkr41u3nPo4FCHOTjY3NTOVI1\n
    59Gt/a6ZiqyJEi+752+a1U5y6iAwYfmXss2lJwJFqMp2PphKg5625kXg8kP2CN5t\n
    6G7bMQcT8C8xDZNtYTd7WPD8UZiRKAJPBXa30/AbwuZe0GaFEQ8ugcYQgSn+IGBI\n
    8/LwhBNTZTUVEWuCUUBVV18YtbAiPq3yXqMB48Oz+ctBWuZSkbvkNodPLamkB2g1\n
    upRyzQ7qDn1X8nn8N8V7YJ6y68AtkHcNSRAnpTitxBKjtKPISLMVCx7i4hncxHZS\n
    yLyKQXhw2W2Xs0qLeC1etA+jTGDK4UfLeC0SF7FSi8o5LL21L8IzApar2pR/\n
    -----END CERTIFICATE-----\n"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni su un profilo del servizio

L’esempio get-service-profile seguente ottiene informazioni sul profilo del servizio creato con l’ID specificato.

aws iotwireless get-service-profile \
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Output:

{
    "Arn": "arn:aws:iotwireless:us-east-1:651419225604:ServiceProfile/538185bb-d7e7-4b95-96a0-c51aa4a5b9a0",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "LoRaWAN": {
        "HrAllowed": false,
        "NwkGeoLoc": false,
        "DrMax": 15,
        "UlBucketSize": 4096,
        "PrAllowed": false,
        "ReportDevStatusBattery": false,
        "DrMin": 0,
        "DlRate": 60,
        "AddGwMetadata": false,
        "ReportDevStatusMargin": false,
        "MinGwDiversity": 1,
        "RaAllowed": false,
        "DlBucketSize": 4096,
        "DevStatusReqFreq": 24,
        "TargetPer": 5,
        "UlRate": 60
    }
}

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni operative su un dispositivo wireless

L’esempio get-wireless-device-statistics seguente ottiene informazioni operative su un dispositivo wireless.

aws iotwireless get-wireless-device-statistics \
    --wireless-device-id "1ffd32c8-8130-4194-96df-622f072a315f"

Output:

{
    "WirelessDeviceId": "1ffd32c8-8130-4194-96df-622f072a315f"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni sul dispositivo wireless

L'get-wireless-deviceesempio seguente elenca i widget disponibili nel tuo AWS account.

aws iotwireless get-wireless-device \
    --identifier "1ffd32c8-8130-4194-96df-622f072a315f" \
    --identifier-type WirelessDeviceID

Output:

{
    "Name": "myLoRaWANDevice",
    "ThingArn": "arn:aws:iot:us-east-1:123456789012:thing/44b87eb4-9bce-423d-b5fc-973f5ecc358b",
    "DestinationName": "IoTWirelessDestination",
    "Id": "1ffd32c8-8130-4194-96df-622f072a315f",
    "ThingName": "44b87eb4-9bce-423d-b5fc-973f5ecc358b",
    "Type": "LoRaWAN",
    "LoRaWAN": {
        "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333",
        "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100",
        "OtaaV1_1": {
            "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012",
            "JoinEui": "b4c231a359bc2e3d",
            "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4"
        },
        "DevEui": "ac12efc654d23fc2"
    },
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f",
    "Description": "My LoRaWAN wireless device"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere l’ID di un certificato associato a un gateway wireless

L’esempio get-wireless-gateway-certificate seguente ottiene l’ID del certificato associato a un gateway wireless con l’ID specificato.

aws iotwireless get-wireless-gateway-certificate \
    --id "6c44ab31-8b4d-407a-bed3-19b6c7cda551"

Output:

{
    "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni sul firmware di un gateway wireless

L’esempio get-wireless-gateway-firmware-information seguente ottiene la versione del firmware e altre informazioni su un gateway wireless.

aws iotwireless get-wireless-gateway-firmware-information \
    --id "3039b406-5cc9-4307-925b-9948c63da25b"

Output:

{
    "LoRaWAN" :{
        "CurrentVersion" :{
            "PackageVersion" : "1.0.0",
            "Station" : "2.0.5",
            "Model" : "linux"
        }
    }
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni operative su un gateway wireless

L’esempio get-wireless-gateway-statistics seguente ottiene informazioni operative su un gateway wireless.

aws iotwireless get-wireless-gateway-statistics \
    --wireless-gateway-id "3039b406-5cc9-4307-925b-9948c63da25b"

Output:

{
    "WirelessGatewayId": "3039b406-5cc9-4307-925b-9948c63da25b"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni sulla definizione dell’attività di un gateway wireless

L’esempio get-wireless-gateway-task-definition seguente ottiene informazioni sulla definizione dell’attività wireless con l’ID specificato.

aws iotwireless get-wireless-gateway-task-definition \
    --id "b7d3baad-25c7-35e7-a4e1-1683a0d61da9"

Output:

{
    "AutoCreateTasks": true,
    "Name": "TestAutoUpdate",
    "Update":{
        "UpdateDataSource" : "s3://cupsalphagafirmwarebin/station",
        "UpdateDataRole" : "arn:aws:iam::001234567890:role/SDK_Test_Role",
        "LoRaWAN" :{
            "CurrentVersion" :{
                "PackageVersion" : "1.0.0",
                "Station" : "2.0.5",
                "Model" : "linux"
            },
            "UpdateVersion" :{
                "PackageVersion" : "1.0.1",
                "Station" : "2.0.5",
                "Model" : "minihub"
            }
        }
    }
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni sull’attività del gateway wireless

L’esempio get-wireless-gateway-task seguente ottiene informazioni sull’attività del gateway wireless con l’ID specificato.

aws iotwireless get-wireless-gateway-task \
    --id "11693a46-6866-47c3-a031-c9a616e7644b"

Output:

{
    "WirelessGatewayId": "6c44ab31-8b4d-407a-bed3-19b6c7cda551",
    "WirelessGatewayTaskDefinitionId": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9",
    "Status": "Success"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come ottenere informazioni su un gateway wireless

L’esempio get-wireless-gateway seguente ottiene informazioni sul gateway wireless myFirstLoRaWANGateway.

aws iotwireless get-wireless-gateway \
    --identifier "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
    --identifier-type WirelessGatewayId

Output:

{
    "Description": "My first LoRaWAN gateway",
    "ThingArn": "arn:aws:iot:us-east-1:123456789012:thing/a1b2c3d4-5678-90ab-cdef-12ab345c67de",
    "LoRaWAN": {
        "RfRegion": "US915",
        "GatewayEui": "a1b2c3d4567890ab"
    },
    "ThingName": "a1b2c3d4-5678-90ab-cdef-12ab345c67de",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/6c44ab31-8b4d-407a-bed3-19b6c7cda551",
    "Name": "myFirstLoRaWANGateway"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare le destinazioni wireless

L'list-destinationsesempio seguente elenca le destinazioni disponibili registrate nel tuo AWS account.

aws iotwireless list-destinations

Output:

{
    "DestinationList": [
        {
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination",
            "Name": "IoTWirelessDestination",
            "Expression": "IoTWirelessRule",
            "Description": "Destination for messages processed using IoTWirelessRule",
            "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole"
        },
        {
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination2",
            "Name": "IoTWirelessDestination2",
            "Expression": "IoTWirelessRule2",
            "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole"
        }
    ]
}

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare i profili di dispositivo

L'list-device-profilesesempio seguente elenca i profili di dispositivo disponibili registrati nell' AWS account.

aws iotwireless list-device-profiles

Output:

{
    "DeviceProfileList": [
        {
            "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d"
        },
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-12ab345c67de",
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/a1b2c3d4-5678-90ab-cdef-12ab345c67de"
        }
    ]
}

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare gli account partner

L'list-partner-accountsesempio seguente elenca gli account partner disponibili associati al tuo AWS account.

aws iotwireless list-partner-accounts

Output:

{
    "Sidewalk": [
        {
            "AmazonId": "78965678771228",
            "Fingerprint": "bd96d8ef66dbfd2160eb60e156849e82ad7018b8b73c1ba0b4fc65c32498ee35"
        },
        {
            "AmazonId": "89656787651228",
            "Fingerprint": "bc5e99e151c07be14be7e6603e4489c53f858b271213a36ebe3370777ba06e9b"
        }
    ]
}

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Come elencare i profili di servizio

L'list-service-profilesesempio seguente elenca i profili di servizio disponibili registrati nell' AWS account dell'utente.

aws iotwireless list-service-profiles

Output:

{
    "ServiceProfileList": [
        {
            "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/538185bb-d7e7-4b95-96a0-c51aa4a5b9a0"
        },
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-12ab345c67de",
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/ea8bc823-5d13-472e-8d26-9550737d8100"
        }
    ]
}

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare i tag assegnati alla risorsa

L’esempio list-tags-for-resource seguente elenca i tag assegnati a una risorsa di destinazione wireless.

aws iotwireless list-tags-for-resource \
    --resource-arn "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination"

Output:

{
    "Tags": [
        {
            "Value": "MyValue",
            "Key": "MyTag"
        }
    ]
}

Per ulteriori informazioni, consulta Descrivi le tue risorse AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare i dispositivi wireless disponibili

L'list-wireless-devicesesempio seguente elenca i dispositivi wireless disponibili registrati nell' AWS account.

aws iotwireless list-wireless-devices

Output:

{
    "WirelessDeviceList": [
        {
            "Name": "myLoRaWANDevice",
            "DestinationName": "IoTWirelessDestination",
            "Id": "1ffd32c8-8130-4194-96df-622f072a315f",
            "Type": "LoRaWAN",
            "LoRaWAN": {
                "DevEui": "ac12efc654d23fc2"
            },
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f"
        }
    ]
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare le definizioni di attività del gateway wireless

L'list-wireless-gateway-task-definitionsesempio seguente elenca le definizioni delle attività del gateway wireless disponibili registrate nell' AWS account.

aws iotwireless list-wireless-gateway-task-definitions

Output:

{
    "TaskDefinitions": [
        {
            "Id": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9",
            "LoRaWAN" :
                {
                "CurrentVersion" :{
                    "PackageVersion" : "1.0.0",
                    "Station" : "2.0.5",
                    "Model" : "linux"
                },
                "UpdateVersion" :{
                    "PackageVersion" : "1.0.1",
                    "Station" : "2.0.5",
                    "Model" : "minihub"
                }
            }
        }
    ]
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come elencare i gateway wireless

L'list-wireless-gatewaysesempio seguente elenca i gateway wireless disponibili nell' AWS account.

aws iotwireless list-wireless-gateways

Output:

{
    "WirelessGatewayList": [
        {
            "Description": "My first LoRaWAN gateway",
            "LoRaWAN": {
                "RfRegion": "US915",
                "GatewayEui": "dac632ebc01d23e4"
            },
            "Id": "3039b406-5cc9-4307-925b-9948c63da25b",
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/3039b406-5cc9-4307-925b-9948c63da25b",
            "Name": "myFirstLoRaWANGateway"
        },
        {
            "Description": "My second LoRaWAN gateway",
            "LoRaWAN": {
                "RfRegion": "US915",
                "GatewayEui": "cda123fffe92ecd2"
            },
            "Id": "3285bdc7-5a12-4991-84ed-dadca65e342e",
            "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/3285bdc7-5a12-4991-84ed-dadca65e342e",
            "Name": "mySecondLoRaWANGateway"
        }
    ]
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come inviare dati al dispositivo wireless

L’esempio send-data-to-wireless-device seguente invia un frame di dati dell’applicazione decrittografato al dispositivo wireless.

aws iotwireless send-data-to-wireless-device \
    --id "11aa5eae-2f56-4b8e-a023-b28d98494e49" \
    --transmit-mode "1" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata LoRaWAN={FPort=1}

Output:

{
    MessageId: "6011dd36-0043d6eb-0072-0008"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come specificare una chiave e un valore di tag per una risorsa

L’esempio tag-resource seguente assegna alla destinazione wireless IoTWirelessDestination il tag con la chiave MyTag e il valore MyValue.

aws iotwireless tag-resource \
    --resource-arn "arn:aws:iotwireless:us-east-1:651419225604:Destination/IoTWirelessDestination" \
    --tags Key="MyTag",Value="MyValue"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Descrivi le tue risorse AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come testare il dispositivo wireless

L’esempio test-wireless-device seguente invia i dati di uplink Hello a un dispositivo con l’ID specificato.

aws iotwireless test-wireless-device \
    --id "11aa5eae-2f56-4b8e-a023-b28d98494e49"

Output:

{
    Result: "Test succeeded. one message is sent with payload: hello"
}

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come rimuovere uno o più tag da una risorsa

L’esempio untag-resource seguente rimuove il tag MyTag e il relativo valore dalla destinazione wireless IoTWirelessDestination.

aws iotwireless untag-resource \
    --resource-arn "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination" \
    --tag-keys "MyTag"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Descrivi le tue risorse AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come aggiornare le proprietà di una destinazione

L’esempio update-destination seguente aggiorna la proprietà di descrizione di una destinazione wireless.

aws iotwireless update-destination \
    --name "IoTWirelessDestination" \
    --description "Destination for messages processed using IoTWirelessRule"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come aggiornare le proprietà di un account partner

L’esempio update-partner-account seguente aggiorna AppServerPrivateKey per l’account con l’ID specificato.

aws iotwireless update-partner-account \
    --partner-account-id "78965678771228" \
    --partner-type "Sidewalk" \
    --sidewalk AppServerPrivateKey="f798ab4899346a88599180fee9e14fa1ada7b6df989425b7c6d2146dd6c815bb"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Come aggiornare le proprietà di un dispositivo wireless

L'update-wireless-deviceesempio seguente aggiorna le proprietà di un dispositivo wireless registrato nell' AWS account dell'utente.

aws iotwireless update-wireless-device \
    --id "1ffd32c8-8130-4194-96df-622f072a315f" \
    --destination-name IoTWirelessDestination2 \
    --description "Using my first LoRaWAN device"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

Come aggiornare il gateway wireless

L’esempio update-wireless-gateway seguente aggiorna la descrizione del gateway wireless.

aws iotwireless update-wireless-gateway \
    --id "3285bdc7-5a12-4991-84ed-dadca65e342e" \
    --description "Using my LoRaWAN gateway"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.