Skip to content

Latest commit

 

History

History

micropython

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ubirch
ubirch
 
 
README.md
README.md
 
 
asn1.py
asn1.py
 
 
helpers.py
helpers.py
 
 
main.py
main.py
 
 
pybytes_config.json
pybytes_config.json
 
 
pymakr.conf
pymakr.conf
 
 
urequests.py
urequests.py
 
 
uuid.py
uuid.py
 
 

README.md

Micropython Example (w/ SIM)

Works on a Pycom GPy module (requires at least firmware version 1.19+).

The code needs a file config.json (not committed) that looks like this:

ask ubirch for API tokens.

{
    "wifi": {"ssid": "MyNetwork", "pass": "MyPassword"},
    "apn": "iot.1nce.net",
    "env": "demo",
    "password": "API Token for UPP backend server",
    "debug": false
}

The wifi settings are optional, if you are just using the SIM card as a trusted execution environment. If the "wifi"-key is not set in the configuration, the client will try to establish a NB-IoT connection, otherwise it will use the given ssid and pass to connect to a WIFI network.

LED Status

LED colour Status
blue flashing initialization
green running main loop
red something went wrong while sending UPP
purple lost connection and trying to reconnect
off waiting for next interval

Testing

The console prints the hash of the data sent as Base64 which can be used to verify with the ubirch backend.

  1. Test UPP has arrived correctly and was verifiable:
curl -d '3W2pCWFB+v3tkJ5p2+QlQDWS5Dsj3QzaphA4ZeX/3Ss=' https://verify.demo.ubirch.com/api/upp
{"upp":"liPEEESNtd1lZE99r65GMl243//EQGhY892X0oEeGMvEmUhHwShBe3kbEHgA1E/+38+nLhhtt8DqfXVzQcpPkkUXWRn293RcwDoTuAlLEoonExMmnYcAxCDdbakJYUH6/e2Qnmnb5CVANZLkOyPdDNqmEDhl5f/dK8RAr56JvcayQvTMPX2sM4p4If2uzC7HL0VGTVE0jHl/3Q2qkscyFfvYfdHbUn2RFY+aheCqlXVlSQ98H0KCgJmqkQ==","prev":null,"anchors":null}
  1. Test UPP with a extended verification (also includes chain):
curl -d '3W2pCWFB+v3tkJ5p2+QlQDWS5Dsj3QzaphA4ZeX/3Ss=' https://verify.demo.ubirch.com/api/upp/verify
{"upp":"liPEEESNtd1lZE99r65GMl243//EQGhY892X0oEeGMvEmUhHwShBe3kbEHgA1E/+38+nLhhtt8DqfXVzQcpPkkUXWRn293RcwDoTuAlLEoonExMmnYcAxCDdbakJYUH6/e2Qnmnb5CVANZLkOyPdDNqmEDhl5f/dK8RAr56JvcayQvTMPX2sM4p4If2uzC7HL0VGTVE0jHl/3Q2qkscyFfvYfdHbUn2RFY+aheCqlXVlSQ98H0KCgJmqkQ==","prev":"liPEEESNtd1lZE99r65GMl243//EQNCpfVGMZLzmX4lu9rVxwIUTzqKEiCU257SUtpZa0dRGtuuFyn1xuXmpSawbKxoEXbVQOCgGDFk1Tp3ShMF2gFUAxCBRW/4r/YTyLHa/VuaGWyKQ8LMA8B3NrTnWv5r8qS7Y5cRAaFjz3ZfSgR4Yy8SZSEfBKEF7eRsQeADUT/7fz6cuGG23wOp9dXNByk+SRRdZGfb3dFzAOhO4CUsSiicTEyadhw==","anchors":null}
  1. Test UPP and include blockchain info when this was data was received (may take up to 1-2 minutes):
curl -d '3W2pCWFB+v3tkJ5p2+QlQDWS5Dsj3QzaphA4ZeX/3Ss=' https://verify.demo.ubirch.com/api/upp/verify/anchors
{"upp":"liPEEESNtd1lZE99r65GMl243//EQGhY892X0oEeGMvEmUhHwShBe3kbEHgA1E/+38+nLhhtt8DqfXVzQcpPkkUXWRn293RcwDoTuAlLEoonExMmnYcAxCDdbakJYUH6/e2Qnmnb5CVANZLkOyPdDNqmEDhl5f/dK8RAr56JvcayQvTMPX2sM4p4If2uzC7HL0VGTVE0jHl/3Q2qkscyFfvYfdHbUn2RFY+aheCqlXVlSQ98H0KCgJmqkQ==","prev":"liPEEESNtd1lZE99r65GMl243//EQNCpfVGMZLzmX4lu9rVxwIUTzqKEiCU257SUtpZa0dRGtuuFyn1xuXmpSawbKxoEXbVQOCgGDFk1Tp3ShMF2gFUAxCBRW/4r/YTyLHa/VuaGWyKQ8LMA8B3NrTnWv5r8qS7Y5cRAaFjz3ZfSgR4Yy8SZSEfBKEF7eRsQeADUT/7fz6cuGG23wOp9dXNByk+SRRdZGfb3dFzAOhO4CUsSiicTEyadhw==","anchors":[{"label":"PUBLIC_CHAIN","properties":{"timestamp":"2019-12-11T10:22:55.994Z","hash":"IPWOQKNWOGX9FLTGMXUSYNDTPKRCTPVMVLOPLINAHYVHAIHEBXHYYDBCZZZWMPDVKGGC9JYSD9VU99999","public_chain":"IOTA_TESTNET_IOTA_TESTNET_NETWORK","prev_hash":"a62acde68924c11d81838185b67801d71ebb1eb0bf9e6ab8e037ab9b57938ea1f67921a25f1204872fdbb557d407a5ea5d0551745c56b881e32eef7bfc034451","type":"PUBLIC_CHAIN"}},{"label":"PUBLIC_CHAIN","properties":{"timestamp":"2019-12-11T10:23:07.442Z","hash":"db57b19d67e11ac2668ff7b43a1a6c5da350c4848fac46feef5834d3dea3f4b3","public_chain":"ETHEREUM_TESTNET_RINKEBY_TESTNET_NETWORK","prev_hash":"a62acde68924c11d81838185b67801d71ebb1eb0bf9e6ab8e037ab9b57938ea1f67921a25f1204872fdbb557d407a5ea5d0551745c56b881e32eef7bfc034451","type":"PUBLIC_CHAIN"}}]}
  1. Test UPP and include blockchain anchoring window (left and right anchoring):
curl -d '3W2pCWFB+v3tkJ5p2+QlQDWS5Dsj3QzaphA4ZeX/3Ss=' https://verify.demo.ubirch.com/api/upp/verify/record
{"upp":"liPEEESNtd1lZE99r65GMl243//EQGhY892X0oEeGMvEmUhHwShBe3kbEHgA1E/+38+nLhhtt8DqfXVzQcpPkkUXWRn293RcwDoTuAlLEoonExMmnYcAxCDdbakJYUH6/e2Qnmnb5CVANZLkOyPdDNqmEDhl5f/dK8RAr56JvcayQvTMPX2sM4p4If2uzC7HL0VGTVE0jHl/3Q2qkscyFfvYfdHbUn2RFY+aheCqlXVlSQ98H0KCgJmqkQ==","prev":"liPEEESNtd1lZE99r65GMl243//EQNCpfVGMZLzmX4lu9rVxwIUTzqKEiCU257SUtpZa0dRGtuuFyn1xuXmpSawbKxoEXbVQOCgGDFk1Tp3ShMF2gFUAxCBRW/4r/YTyLHa/VuaGWyKQ8LMA8B3NrTnWv5r8qS7Y5cRAaFjz3ZfSgR4Yy8SZSEfBKEF7eRsQeADUT/7fz6cuGG23wOp9dXNByk+SRRdZGfb3dFzAOhO4CUsSiicTEyadhw==","anchors":{"upper_blockchains":[{"label":"PUBLIC_CHAIN","properties":{"timestamp":"2019-12-11T10:22:55.994Z","hash":"IPWOQKNWOGX9FLTGMXUSYNDTPKRCTPVMVLOPLINAHYVHAIHEBXHYYDBCZZZWMPDVKGGC9JYSD9VU99999","public_chain":"IOTA_TESTNET_IOTA_TESTNET_NETWORK","prev_hash":"a62acde68924c11d81838185b67801d71ebb1eb0bf9e6ab8e037ab9b57938ea1f67921a25f1204872fdbb557d407a5ea5d0551745c56b881e32eef7bfc034451","type":"PUBLIC_CHAIN"}},{"label":"PUBLIC_CHAIN","properties":{"timestamp":"2019-12-11T10:23:07.442Z","hash":"db57b19d67e11ac2668ff7b43a1a6c5da350c4848fac46feef5834d3dea3f4b3","public_chain":"ETHEREUM_TESTNET_RINKEBY_TESTNET_NETWORK","prev_hash":"a62acde68924c11d81838185b67801d71ebb1eb0bf9e6ab8e037ab9b57938ea1f67921a25f1204872fdbb557d407a5ea5d0551745c56b881e32eef7bfc034451","type":"PUBLIC_CHAIN"}}],"lower_blockchains":[{"label":"PUBLIC_CHAIN","properties":{"timestamp":"2019-12-11T10:22:07.440Z","hash":"f13b22446256628282fb9cfcb2d163c1dc2e24c1b6f573250279644a7ced1590","public_chain":"ETHEREUM_TESTNET_RINKEBY_TESTNET_NETWORK","prev_hash":"8d532551a50d47c756787651ae1fc04fb19acaef41939294682b8b049bdce1ff89bded8b4dd1685fe66764459ecc7e927bd7d8be7528eb0354cd6d5eb50a15c3","type":"PUBLIC_CHAIN"}},{"label":"PUBLIC_CHAIN","properties":{"timestamp":"2019-12-11T10:21:48.781Z","hash":"9RISCWMJPMAOWXBSUBHIQBMKOHWEVJDDVQA9BHTGZOKU9MWISUTBVQHSAVV9RSIUAZDFCDMYCPYBZ9999","public_chain":"IOTA_TESTNET_IOTA_TESTNET_NETWORK","prev_hash":"8d532551a50d47c756787651ae1fc04fb19acaef41939294682b8b049bdce1ff89bded8b4dd1685fe66764459ecc7e927bd7d8be7528eb0354cd6d5eb50a15c3","type":"PUBLIC_CHAIN"}}]}}

Issues

  • The Sequans modem seems to have an issue if the send interval is longer than 30s. It gets into a state where it does not recognize the SIM commands anymore. A solution could be (also from a point of view to save energy) is to completely disable the modem and connection and restart it.

Dissecting the UPP

9623c410448db5dd65644f7dafae46325db8dfffc4405c2ae0cbb68dcf34f4f4ad89fc652ca69cf809fb57b2eb6673b6bd5a4160b69ce5ce5703c9da73bcb40f53950f82ff3806f6acf995dd89390f946caa698611fb00c42030245fde6b651a8afcd140574774e1fe0fce2712233713faae9552a733404d9fc440a0e1b567352db9e0aab4b257f16c9b40497b21ffd7db317e7fb441c6c674c93299763fabdf66d5083a644500b26af1480725eda76c2fd224b4bb9f69a081c66f

contains:

[35,"RI213WVkT32vrkYyXbjf/w==","XCrgy7aNzzT09K2J/GUsppz4CftXsutmc7a9WkFgtpzlzlcDydpzvLQPU5UPgv84Bvas+ZXdiTkPlGyqaYYR+w==",0,"MCRf3mtlGor80UBXR3Th/g/OJxIjNxP6rpVSpzNATZ8=","oOG1ZzUtueCqtLJX8WybQEl7If/X2zF+f7RBxsZ0yTKZdj+r32bVCDpkRQCyavFIByXtp2wv0iS0u59poIHGbw=="]
Data Comment
96 6 byte array
23 version numnber (0x23)
c410 448db5dd65644f7dafae46325db8dfff UUID (16 byte array)
c440 5c2ae0cbb68dcf34f4f4ad89fc652ca69cf809fb57b2eb6673b6bd5a4160b69ce5ce5703c9da73bcb40f53950f82ff3806f6acf995dd89390f946caa698611fb chain (prev signature, 64 byte array)
00 payload type
c420 30245fde6b651a8afcd140574774e1fe0fce2712233713faae9552a733404d9f hash (SHA256, 32 byte array)
c440 a0e1b567352db9e0aab4b257f16c9b40497b21ffd7db317e7fb441c6c674c93299763fabdf66d5083a644500b26af1480725eda76c2fd224b4bb9f69a081c66f signature (64 byte array)