Differences

This shows you the differences between two versions of the page.

--- doc:appunti:hardware:insta360_one_rs_wifi_reverse_engineering [2023/07/08 12:56] – [Getting the .proto files from the Android APK] niccolo
+++ doc:appunti:hardware:insta360_one_rs_wifi_reverse_engineering [2023/07/14 14:59] – [Unsolved Problems] niccolo
@@ Line 42: / Line 42: @@
 /opt/bin/tcpdump -w /tmp/SD0/tcpdump-$(date +%m%d%H%M%S).log -s0 -n 'host 192.168.42.2'
 </code>
+===== Packets anatomy =====
+==== Sent Packets ====
+=== Sync Packet ===
+^ Offset  ^ Content  ^ Bytes  ^ Note  ^
+|   0 | Packet Length     | 4   | Overall length of the packet, including this 4 bytes.  |
+|   4 | 0x06 0x00 0x00    | 3   | Message Type: Sync Packet.  |
+|   7 | syNceNdinS        | 10  | Magic String.  |
+=== Keep Alive Packet ===
+^ Offset  ^ Content  ^ Bytes  ^ Note  ^
+|   0 | Packet Length     | 4   | Overall length of the packet, including this 4 bytes.  |
+|   4 | 0x05 0x00 0x00    | 3   | Message Type: Keep Alive.  |
+=== Phone Commands ===
+^ Offset  ^ Content  ^ Bytes  ^ Note  ^
+|   0 | Packet Length     | 4  | Overall length of the packet, including this 4 bytes.  |
+|   4 | 0x04 0x00 0x00    | 3  | Message Type: Phone Command.  |
+|   7 | Message Code      | 2  | Examples: PHONE_COMMAND_GET_OPTIONS, PHONE_COMMAND_SET_OPTIONS, PHONE_COMMAND_TAKE_PICTURE, PHONE_COMMAND_START_CAPTURE, etc.  |
+|   9 | 0x02              | 1  |
+|  10 | Sequence Number   | 3  | Each command sent to the camera have its increasing sequence number, the relative response contains the same sequence number.  |
+|  13 | 0x80 0x00 0x00    | 3  |
+|  16 | Protobuf Message  | Variable  | The message serialized using Protocol Buffers.  |
+==== Received Packets ====
+=== Notifications or Response to Phone Commands ===
+^ Offset  ^ Content  ^ Bytes  ^ Note  ^
+|   0 | Packet Length     | 4  | Overall length of the packet, including this 4 bytes.  |
+|   4 | 0x04 0x00 0x00    | 3  | Response Type: Phone Command.  |
+|   7 | Response Code     | 2  | Examples: 200: OK, 500: ERROR, CAMERA_NOTIFICATION_CURRENT_CAPTURE_STATUS, etc.  |
+|   9 | 0x02              | 1  |
+|  10 | Sequence Number   | 3  | Matches to the requesting message.  |
+|  13 | 0x80              | 1  |
+|  14 | Unknown           | 2  |  |
+|  16 | Protobuf Message  | Variable  | The response message serialized using Protocol Buffers.  |
@@ Line 56: / Line 100: @@
 </code>
-Then **extract some protobuf binary messages from the tcpdump output**; in the following example we try to decode a binary message received from the camera by the Android app. It seems that each message is prefixed by a 12 bytes header (more on that later), so in the Python code strip that header away and keep only the message body before calling the ''protobuf_to_json()'' function:
+Then **extract some protobuf binary messages from the tcpdump output**; in the following example we try to decode a binary message received from the camera by the Android app. Each message is prefixed by a 12 bytes header (see packets anatomy, above), so in the Python code strip that header away and keep only the message body before calling the ''protobuf_to_json()'' function:
 <code python>
@@ Line 226: / Line 270: @@
 echo "Python files were compiled into the pb2 directory."
 </code>
+===== The Insta360 Python remote program =====
+On the **[[https://github.com/RigacciOrg/insta360-wifi-api/|insta360-wifi-api GitHub repository]]** you can find a Python library which implements basic communication with the Insta360 camera over WiFi connection. There is also an example Python program with the basic functionality of **remote control**. You can easily run it from a PC with GNU/Linux, but you can also install the required Python language and libraries in MS-Windows and even on Android. I run that program on my smartphone, it just required to install the **[[https://f-droid.org/en/packages/com.termux/|Termux]]** app.
+===== Unsolved Problems =====
+It seems **impossibile to change some settings via the WiFi API**; e.g. I was not able to change:
+  * Sharpness
+  * Prompt Sound
+  * Indicator Light (LEDs)
+When some settings are changed via the WiFi API, **the preview on the camera screen does not reflect that change**; nor in the live stream, nor into the on-screen-display labels. E.g. white balance, capture resolution, fielf of view. Fortunately if you start the video capture, the settings are effective.
+===== White Balance Settings =====
+It is possible to change the white balance setting by changing the value of **white_balance** choosing from some enumerated presets or directly by changing the temperature value of **white_balance_value**. There seems to be some inconsistency between the labels assigned to the presets in the .proto files and the actual temperature values. I think that the best choice is to assign the white_balance_value, ignoring the enumerated presets.
+^ white_balance_value  ^ white_balance  ^ Protobuf Enum Label  ^
+|   AUTO |   0 | WB_AUTO  |
+|   2000 |   6 |  |
+|   2200 |   7 |  |
+|   2400 |   8 |  |
+|   2600 |   9 |  |
+|   2800 |   1 | WB_2700K  |
+|   3000 |  10 |  |
+|   3200 |  11 |  |
+|   3400 |  12 |  |
+|   3600 |  13 |  |
+|   3800 |  14 |  |
+|   4000 |   2 | WB_4000K  |
+|   4500 |  15 |  |
+|   5000 |   5 | WB_7500K  |
+|   5500 |  16 |  |
+|   6000 |  17 |  |
+|   6500 |   3 | WB_5000K  |
+|   7000 |  18 |  |
+|   7500 |   4 | WB_6500K  |
+|   8000 |  19 |  |
+|   8500 |  20 |  |
+|   9000 |  21 |  |
+|   9500 |  22 |  |
+|  10000 |  23 |  |
 ===== Web References =====