]> gitweb.ps.run Git - matrix_esp_thesis/blobdiff - Readme.md
update examples
[matrix_esp_thesis] / Readme.md
index c4e575b614ed4c03a0a21dc8345429d0959a7de3..9475a9f20824f678c78f4fcbad87af7f0dc2e2c4 100644 (file)
--- a/Readme.md
+++ b/Readme.md
@@ -9,6 +9,7 @@ Device verification is also supported.
 Building requires a C/C++ compiler and make.\r
 \r
 To build the dependencies run `make deps`.\r
+All dependencies are included in this repository.\r
 \r
 To build any of the examples run `make out/examples/<example>`.\r
 \r
@@ -21,6 +22,17 @@ To use the library:
 - Add include path `ext/mjson/src/`\r
 - Add include path `ext/mongoose/`\r
 \r
+To build the example for the ESP32 start an ESP-IDF shell in esp32/esp_project or esp32/esp_project_riscv and run:\r
+- `idf.py build`\r
+- `idf.py flash`\r
+- `idf.py monitor`\r
+\r
+To use the library in an ESP-IDF project:\r
+- Add the matrix and olm components (can be found in `esp32/esp_project/components/`)\r
+- Add `wifi.c/.h` (can be found in `esp32/esp_project/main/`)\r
+- Add `SET(CMAKE_CXX_FLAGS  "${CMAKE_CXX_FLAGS} -fpermissive")` to CMakeLists.txt\r
+- Call `wifi_init("<SSID>", "<PASSWORD>")` before initializing the library\r
+\r
 ## Dependencies\r
 [Mongoose](https://github.com/cesanta/mongoose)\r
 \r
@@ -30,6 +42,31 @@ To use the library:
 \r
 ## Examples\r
 \r
+### (De)Initialization\r
+```\r
+MatrixClient * client = (MatrixClient*)malloc(sizeof(MatrixClient));\r
+MatrixClientInit(client);\r
+\r
+MatrixHttpInit(&client->hc, SERVER);\r
+MatrixClientSetUserId(client, USER_ID);\r
+\r
+MatrixClientLoginPassword(client,\r
+    "pscho",\r
+    "Wc23EbmB9G3faMq",\r
+    "Test1");\r
+\r
+MatrixClientDeleteDevice(client);\r
+    \r
+MatrixHttpDeinit(&client->hc);\r
+```\r
+\r
+### Uploading keys\r
+```\r
+MatrixClientGenerateOnetimeKeys(client, 10);\r
+MatrixClientUploadOnetimeKeys(client);\r
+MatrixClientUploadDeviceKeys(client);\r
+```\r
+\r
 ### Sending an encrypted message\r
 ```\r
 MatrixMegolmOutSession * megolmOutSession;\r