Merge branch 'master' of https://github.com/henryk86/toniebox-reverse-engineering.github.io

Author: henryk86

content/docs/custom-firmware/cc3200/hackieboxng-bl/ofw-patches.md

@@ -20,9 +20,6 @@ If you want to use alternative tags those patches will help you. Even other iso1
 ### Block count >8 ([blockCheck.310.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/blockCheck.310.json) / [blockCheck.307.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/blockCheck.307.json))
 Usally the toniebox checks if the tag has exactly 8 blocks. The check allows the tag to have more than that. (ex. SLIX or SLIX2)
 
-### Block count <=8 ([blockCheckRemove.310.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/blockCheckRemove.310.json) / [blockCheckRemove.308.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/blockCheckRemove.308.json))
-Usally the toniebox checks if the tag has exactly 8 blocks. The check allows the tag to have less than that.
-
 ### No privacy password ([noPass3.310.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/noPass3.310.json) / [noPass3.305.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/noPass3.305.json))
 Usally doesn't allow tags without the boxine specific or the NXP specific privacy mode password. With the patch you can use tags without having privacy password support (ex. SLIX). It disables the rf field for a moment when the second privacy password failed. This patch uses the new dynamic patching engine to generate dynamic arm asm bytecode.
 
@@ -67,4 +64,9 @@ Usally doesn't allow tags without the boxine specific or the NXP specific privac
 Usally doesn't allow tags without the boxine specific or the NXP specific privacy mode password. With the patch you can use tags without having privacy password support (ex. SLIX). It disables the rf field for a moment when the second privacy password failed.
 
 ### Disable charger wakeup ([noChargWake.305.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/noChargWake.305.json))
-The toniebox won't wakeup anymore if it is put onto the charger. **noChargWake.305 Doesn't work on 3.1.0-BF2 and higher. Box won't wakeup anymore** ***Attention, this patch is only working if you disconnect the battery for a second before loading the patched ofw. If you start the unpatched ofw once, you will have to disconnect the battery again***
+The toniebox won't wakeup anymore if it is put onto the charger. **noChargWake.305 Doesn't work on 3.1.0-BF2 and higher. Box won't wakeup anymore** ***Attention, this patch is only working if you disconnect the battery for a second before loading the patched ofw. If you start the unpatched ofw once, you will have to disconnect the battery again***
+
+### Block count <=8 ([blockCheckRemove.310.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/blockCheckRemove.310.json) / [blockCheckRemove.308.json](https://github.com/toniebox-reverse-engineering/hackiebox_cfw_ng/blob/master/sd-bootloader-ng/bootmanager/sd/revvox/boot/patch/blockCheckRemove.308.json))
+Usally the toniebox checks if the tag has exactly 8 blocks. The check allows the tag to have less than that.
+
+**This patch breaks the transfer of the authentication data to the cloud, this means downloading the content of the Tonies if using teddyCloud won't work and those Tonies will be marked as no-cloud**

content/docs/rules/_index.md

@@ -0,0 +1,51 @@
+---
+title: "Community Guidelines"
+description: "Please don't forget to read our Community Guidelines!"
+weight: 14
+---
+# Rules for our Chats and Forums - Community Guidelines
+
+## Do's
+
+### §1. Be respectful
+Treat others with kindness and respect.
+
+### §2. Complex questions
+For in-depth inquiries, please use our [Forum](https://forum.revvox.de).
+
+### §3. Stay on topic
+This community is focused on Toniebox-related discussions.
+
+### §4. Use English
+To ensure everyone can participate, please stick to English. Messages in other languages are deleted without comment.
+
+## Don'ts
+
+### §5. No piracy
+Any requests or discussions related to piracy will result in an immediate ban.
+
+### §6. No team tagging
+Don't tag the team for general questions. Replying is totally ok if we are already in the discussion. 
+
+### §7. No general hacking
+This is not a community for general hacking. Questions like "Can you hack Instagram?" or "How to crack Candy Crush?" result in a ban.
+
+### §8. No self-promotion without permission
+If you're a merchant, clearly identify yourself and ask permission before sharing links to your products.
+
+### §9. Posting the same question in multiple places
+Please stick to the [Forum](https://forum.revvox.de) if you started there. Scattering the answers in [Telegram](https://t.me/toniebox_reverse_engineering) and Discource will make it hard for others to find the solution.
+
+### §10. No kidnapping of solved threads
+If you find a thread in our [Forum](https://forum.revvox.de) that seems to be solved, don't hijack it for your problem. It may look similar, but this will end up in chaos. Open your own thread!
+
+## Helpful Tips
+- Use the search function before asking a question
+- Be patient when waiting for responses
+- Share your knowledge to help others
+
+## Telegram
+Please follow the Miss Rose Bots instructions. If you don't do that, you are unable to write. Then please leave our [Telegram Group](https://t.me/toniebox_reverse_engineering) and rejoin it.
+
+## More
+Feel free to refine this document with a PR!

content/docs/tools/teddyCloud/_index.md

@@ -10,12 +10,12 @@ headless: true
 ## Features
 teddyCloud is an alternative server for your Toniebox, allowing you to host the cloud services locally.
 This gives you the control about which data is sent to the original manufacturer's cloud and allows you
-to host your own figurine audio files on e.g. your [NAS or any other server](supported-server-hardware). It provides an easy to use WebGui.
+to host your own figurine audio files on e.g. your [NAS or any other server](setup/supported-server-hardware). It provides an easy to use WebGui.
 
 ![teddyCloud Webinterface](/img/teddyCloudWebinterface.png)
 
 You can also use teddyCloud on the command line to manipulate esp32 firmware dumps or encode Tonie Audio Files (TAFs). See ```teddycloud --help```.
 
 ## Links
 * [GitHub](https://github.com/toniebox-reverse-engineering/teddycloud)
-* [Releases](https://github.com/toniebox-reverse-engineering/teddycloud/releases)
+* [Releases](https://github.com/toniebox-reverse-engineering/teddycloud/releases)

content/docs/tools/teddyCloud/setup/_index.md

@@ -15,6 +15,8 @@ An example [docker-compose.yaml can be found within the docker subdir.](https://
 Please beware that port 443 cannot be remapped and you cannot use a reverse proxy like nginx or traefik without passing through the TLS (complex, not recommended). The client certificate authentication needs to be done by teddyCloud. Also, there is no SNI. If you are using docker, you can use macvlan to give the teddyCloud container a dedicated IP address (recommended).
 
 ## Preparation
+First of all, prepare your teddyCloud installation. On first run, teddyCloud generates its certificates. During the generation you cannot access the webinterface. This can take several minutes! Be sure you check the log output!
+
 Please connect your Toniebox to your Wi-Fi and update its firmware. Many boxes are shipped with a production firmware that needs to be updated. Otherwise the box won't work as it should. It is not necessary to connect the box to the mytonies app/account. [Connect the box without the setup assistant.](https://support.tonies.com/hc/en-us/articles/4415294030482-How-do-I-set-up-a-Wi-Fi-connection-without-the-setup-assistant)
 
 ## Device specific preparation
@@ -36,4 +38,4 @@ Currently the teddyCloud webinterface is reachable through the IP of the docker
 Changes affecting the toniebox (volume, LED) which are made through this interface will only be reflected onto the toniebox after pressing the big ear for a few seconds until a beep occurs (freshnessCheck).
 
 ### Content (Legacy)
-Please put your content into the ```/data/content/default/``` in the same structure as on your toniebox. You can edit ```500304E0.json``` file beside the content files to mark them as live or you can prevent the usage of the Boxine cloud for that tag with the nocloud parameter. By setting a source teddyCloud can stream any content that ffmpeg can decode (urls and files). Please check that the file and folders in upper case. If not rename them, otherwise teddyCloud won't serve them to the box!
+Please put your content into the ```/data/content/default/``` in the same structure as on your toniebox. You can edit ```500304E0.json``` file besides the content files to mark them as live or you can prevent the usage of the Boxine cloud for that tag with the nocloud parameter. By setting a source teddyCloud can stream any content that ffmpeg can decode (urls and files). Please check that the file and folders are in upper case. If not rename them, otherwise teddyCloud won't serve them to the box!

content/docs/tools/teddyCloud/setup/dump-certs/cc3200.md

@@ -4,7 +4,7 @@ description: ""
 ---
 
 # CC3200
-You can use the [cc3200tool](https://github.com/toniebox-reverse-engineering/cc3200tool) to dump your certificates over the Tag Connect debug port of the box. If you have installed the [HackieboxNG Bootloader](/docs/custom-firmware/cc3200/hackieboxng-bl/) you should already have those files in your backup. If not, you should install [HackieboxNG](/docs/custom-firmware/cc3200/hackieboxng-bl/). This will allow to to read and write files from/to microSD and flash by booting the [Hackiebox CFW](/docs/custom-firmware/cc3200/hackiebox-cfw).
+You can use the [cc3200tool](https://github.com/toniebox-reverse-engineering/cc3200tool) to dump your certificates over the Tag Connect [debug port](/docs/wiki/cc3200/debug-port) of the box. If you have installed the [HackieboxNG Bootloader](/docs/custom-firmware/cc3200/hackieboxng-bl/) you should already have those files in your backup. If not, you should install [HackieboxNG](/docs/custom-firmware/cc3200/hackieboxng-bl/). This will allow to to read and write files from/to microSD and flash by booting the [Hackiebox CFW](/docs/custom-firmware/cc3200/hackiebox-cfw).
 Please drop the three .der files to `/certs/client/`.
 
 ## Read certificates via Hackiebox CFW

content/docs/tools/teddyCloud/setup/dump-certs/esp32.md

@@ -7,9 +7,37 @@ description: ""
 You can extract the flash memory via the debug port of the box and the esptool. Keep your backup! Please use a recent version of [esptool](https://github.com/espressif/esptool). (>v4.4)
 Please connect the jumper J100 (Boot) and reset the box to put it into the required UARTmode. Connect your 3.3V UART to J103 (TxD, RxD, GND).
 
+If you're unsure in which mode the ESP32 is starting:
+
+#### Normal startup mode
+
+LED blinking green, startup sound is played, Serial output:
+
+    ESP-ROM:esp32s3-20210327
+    Build:Mar 27 2021
+    rst:0x1 (POWERON),boot:0x8 (SPI_FAST_FLASH_BOOT)
+    SPIWP:0xee
+    mode:DIO, clock div:1
+    load:0x3fcd0108,len:0x118
+    load:0x403b6000,len:0xb90
+    load:0x403ba000,len:0x27f4
+    entry 0x403b61c4
+    + gibberish
+
+
+#### Download mode
+
+LED is off, no sound, Serial output:
+
+    ESP-ROM:esp32s3-20210327
+    Build:Mar 27 2021
+    rst:0x1 (POWERON),boot:0x0 (DOWNLOAD(USB/UART0))
+    waiting for download
+
+
 ![J103 Pinout](/img/tb-esp32-uart.jpg)
 
-If connected with the Boot jumper, the box just start in "DOWNLOAD (USB/UART0)" mode (Check with a serial monitor) and the LED will be off. Beware, if the serial monitor is open it will block esptool.py from accessing the esp. If you get a "BROWNOUT_RST" check your power supply / battery. "SPI_FAST_FLASH_BOOT" indicates a boot without the J100 jumper. 
+Beware, if the serial monitor is open it will block esptool.py from accessing the esp. If you get a "BROWNOUT_RST" check your power supply / battery. "SPI_FAST_FLASH_BOOT" indicates a boot without the J100 jumper. 
 
 ## Browser based
 You can use the build in ESP32 box flashing tool in the webinterface of teddyCloud to backup your box with "Read ESP32".

content/docs/tools/teddyCloud/setup/supported-server-hardware.md

@@ -16,6 +16,9 @@ Below is a compilation of NAS/server hardware that has been successfully utilize
 | Raspberry Pi Zero 2             | slow on initial startup (expect 20 minutes and more for initial certificate creation!), encoding also very slow, possible crashes in some situations, but in general usable                        |
 | Synology NAS DS923+ (DSM 7.2.1) | -                                                                                                                                                                                                  |
 | Raspberry Pi Zero               | Docker installation is a little bit tricky, getting it running could take some extra steps see https://forum.revvox.de/t/hardware-requirements-does-teddycloud-run-on-a-raspberry-zero-1st-gen/309 |
+| Raspberry Pi 1 Model A Rev 1.1  | Works with Raspberry Pi OS (32-Bit) and the teddycloud build for Alpine Linux (see https://github.com/toniebox-reverse-engineering/teddycloud/issues/225)                                          |
+| Qnap TS-462 (QTS 5.2.3.3006)    | Works out of the box in Container Station                                                                                                                                                          |
+| Proxmox on Dell Wyse 5070       | Works out of the box with Proxmox VE Helper Script. Needs some time till you can access the ip address.                                                                                            |
 | ...                             |                                                                                                                                                                                                    |
 
 Consider using Alpine container instead of Ubuntu / Debian container if your server has limited resources.

content/docs/tools/teddyCloud/setup/test-troubleshooting.md

@@ -5,7 +5,7 @@ bookCollapseSection: true
 ---
 # teddyCloud - Test & Troubleshooting
 ## Connection toniebox to teddyCloud
-First of all please be sure the cloud is not enabled in the webinterface. Then close all browser windows to teddyClouds webinterface and open the logs of teddyCloud. If you are using docker you can access them via: `docker logs teddyCloud`.
+First of all please be sure the cloud is not enabled in the webinterface. Then close all browser windows to teddyClouds webinterface and open the logs of teddyCloud. If you are using docker you can access them via: `docker logs teddycloud`.
 
 To be sure your toniebox can connect to teddyCloud we do a so called "freshnessCheck". This can be initiated by pressing one ear of the box until the LED is pulsing blue.
 

content/docs/tools/teddyCloud/tecdoc/edit-local.md

@@ -0,0 +1,87 @@
+---
+title: "Edit JSON files with vscode"
+description: "edit json files locally"
+bookCollapseSection: true
+---
+
+# Edit JSON files with vscode
+
+You can use a json schema which can provide you the ability for autocompletion and validation in your favorite editor. This article describes it for vscode.
+
+Schemas:
+
+* [content-json-schema.json](/teddyCloud/tecdoc/content-json-schema.json)
+* [tonies-custom-json-schema.json](/teddyCloud/tecdoc/tonies-custom-json-schema.json)
+* [tonieboxes-custom-json-schema.json](/teddyCloud/tecdoc/tonieboxes-custom-json-schema.json)
+* [plalist-tap-json-schema.json](/teddyCloud/tecdoc/plalist-tap-json-schema.json)
+
+## content.json
+
+Add the Schemaurl to the json file.
+
+Example:
+
+```json
+{
+    "$schema": "{{< siteurl >}}teddyCloud/tecdoc/content-json-schema.json",
+ "live": false,
+ "nocloud": false,
+ "source": "",
+ "skip_seconds": 0,
+ "cache": false,
+ "cloud_ruid": "",
+ "cloud_auth": "",
+ "cloud_override": false,
+ "tonie_model": "",
+ "_version": 5
+}
+
+```
+
+## tonies.custom.json / tonieboxes.custom.json
+
+To configure this for vscode you have to edit `.vscode/settings.json`.
+
+Add the following parts to the `settings.json`:
+
+```json
+{
+    "json.schemaDownload.enable": true,
+    "json.schemas": [
+        {
+            "fileMatch": ["tonies.custom.json"],
+            "url": "{{< siteurl >}}teddyCloud/tecdoc/tonies-custom-json-schema.json"            
+        },
+        {
+            "fileMatch": ["tonieboxes.custom.json"],
+            "url": "{{< siteurl >}}teddyCloud/tecdoc/tonieboxes-custom-json-schema.json"
+        }
+    ]
+}
+```
+
+## Plalist (TAP) Files
+
+```json
+{
+  "$schema": "{{< siteurl >}}teddyCloud/tecdoc/plalist-tap-json-schema.json",
+  "type": "tap",
+  "audio_id": 0,
+  "filepath": "lib://by/tapID/radio.taf",
+  "name": "Radio",
+  "files": [
+    {
+      "filepath": "lib://by/audioID/1234567890.taf",
+      "name": "Hörspiel Tonie"
+    },
+    {
+      "filepath": "lib://mp3/album/title.mp3",
+      "name": "A Song"
+    },
+    {
+      "filepath": "http://nas.intranet/musiclibrary/album/song.mp3",
+      "name": "Network Audio"
+    }
+  ]
+}
+```