feat: Part 1 of adapting Docs

This commit is contained in:
2026-05-05 19:25:18 -04:00
parent a164159c1c
commit d66e9e3584
22 changed files with 40 additions and 378 deletions

View File

@@ -27,6 +27,29 @@ export default defineConfig({
{ text: 'For Developers..', link: '/Developing/intro-dev' }
]
},
{
text: 'Discoveries',
items: [
{ text: 'Jibo Workshop HRI 2024', link: '/Discoveries/jibohri' }
]
},
{
text: 'Be Skill',
items: [
{ text: 'About @Be/Be', link: '/be/about' },
{ text: 'The Splash Screen', link: '/be/splash' },
{ text: 'The Assets Directory', link: '/be/Assets/assets' }
]
},
{
text: 'Dictionary',
items: [
{ text: 'ESML', link: '/Dictionary/ESML' },
{ text: 'NVIDIA Tegra K1 (T124) Soc', link: '/Dictionary/tegrasoc' },
{ text: 'Robot Operating System', link: '/Dictionary/ROS' },
{ text: 'ShofEL2 - Fusée Gelée Exploit', link: '/Dictionary/Shofel' }
]
},
{
text: 'UART',
items: [

View File

Before

Width:  |  Height:  |  Size: 189 KiB

After

Width:  |  Height:  |  Size: 189 KiB

View File

@@ -1,3 +1,4 @@
# ESML
**Embodied Speech Markup Language (ESML)** is a specialized XML-based markup language designed to control how virtual humans, avatars, or robots communicate. Unlike standard text-to-speech (TTS) which only focuses on audio, ESML "embodies" the speech by synchronizing the voice with non-verbal behaviors like gestures, facial expressions, and posture.
It acts as a bridge between the "brain" of an AI (the text it wants to say) and the "body" of the character (how it should move while saying it).
@@ -19,4 +20,4 @@ ESML allows developers to tag text with specific instructions that the animation
> [!warning]
> The Above explanations is AI Generated, Learn more at : [[ESML-SDK.pdf]]
> The Above explanations is AI Generated, Learn more [here](/Dictionary/ESML-SDK.pdf)

View File

@@ -1,3 +1,4 @@
# ROS
Robot Operating System (**ROS**) is not actually a traditional operating system like Windows or Linux. Instead, it is a flexible **middleware** framework—a collection of tools, libraries, and conventions designed to simplify the task of creating complex and robust robot behavior across a wide variety of robotic platforms.
The core philosophy of ROS is "don't reinvent the wheel." It allows roboticists to focus on their specific high-level logic while relying on community-tested packages for low-level tasks like motor control, sensor fusion, and navigation.

View File

@@ -1,3 +1,4 @@
# ShofEL2 - Fusée Gelée Exploit
**ShofEL2** (and its sister exploit **Fusée Gelée**) is an unpatchable hardware vulnerability found in the NVIDIA Tegra X1's USB Recovery Mode (RCM). Because the flaw exists in the **Read-Only Memory (Boot ROM)** of the SoC, it cannot be fixed via software or firmware updates by Nintendo or NVIDIA.
The exploit allows for **Unsigned Code Execution** at the highest privilege level (EL3) before the operating system even begins to load.

View File

@@ -1,3 +1,4 @@
# NVIDIA Tegra K1 (T124) Soc
The Tegra K1 (T124) was a landmark SoC for NVIDIA, being the first mobile processor to feature a **Unified Shader Architecture** using the same **Kepler** architecture found in desktop GeForce 700 series GPUs. It effectively bridged the gap between mobile and PC gaming, enabling support for DirectX 11 and Unreal Engine 4 on mobile devices.

View File

@@ -1,3 +1,4 @@
# Jibo Workshop HRI 2024
### Resources:
https://github.com/jibodev/ShofEL2-for-T124-Jibo/tree/t124 - Github Repo
@@ -12,7 +13,7 @@ From the jibo workshop i have discovered that they have actually included a lot
Were gonna have to analyse the stuff to go further one , and as i was looking at the files i discovered a file named `jibo_chatGPT.ipynb` which sparked some attention, and it appears that they have made a honest attempt at trying to hook it up to chat gpt
![[JiboChatGPT.png]]
![Jibo ChatGPT file stuff](/Assets/JiboChatGPT.png)
And there is a section where they clearly tried to make it act like jibo

View File

@@ -0,0 +1,2 @@
surprised nobody has written here yet.
fyi this is not one of the closed source servers mentioned in FAQ

View File

@@ -1,5 +0,0 @@
- - -
Located in `/usr/local/bin/`
Has a lot of random assets, potentially has assets useful for restoration.

View File

@@ -1,5 +0,0 @@
- - -
Located in `/opt/jibo/Jibo/Skills/@be/be/node_modules/jibo-anim-db-animations/audio/`
Lots of audio assets, the surrounding folders also contain other assets.

View File

@@ -1,2 +0,0 @@
- - -
Were working on a new sdk for jibo , im too bored to write this page now , i will fill it later

View File

@@ -1,3 +0,0 @@
- - -
I will leave this to the community for now

View File

@@ -1,274 +0,0 @@
- - -
Before starting ANY work , lets get you up to speed with the enviroment and what you will need ...
1. Some sort of linux device with at least 32Gb storage, that could be a : Spare laptop , Raspberry Pi , a PC etc...
> [!info]
> 1. for the sake of this guide we will be using my main computer running on CachyOS with the 6.19... kernel but you dont have to replicate my setup
> 2. This guide **requires** you have basic knowledge of the linux terminal
>[!Warning]
>I Throw around the word shofel , and i do mean the shofel version **SPECIFICALLY** in devsparx repo (using the improvements brach for now) i show later on how to clone it , if anything should change i will try my best to update this guide as fast as possible , but do note our build of shofel will be undergoing some updates!
> [!WARNING]
> # Please do inform yourself
> we are NOT liable for any damage caused to your device if you proceed with this guide , if you are not sure remotely on what youre doing i recommend either wait for the easier installation method , or find someone on the discord to guide you!!! (they arent liable for any damage either)
2. A micro usb cable ==**that you know is reliable**==
3. Like 4-5 Hours
4. A Jibo **(THAT IS SETUP TO YOUR NETWORK, AND YOU KNOW ITS IP)**
5. An the mindset of (everything will be fine!)
- - -
>[!DANGER]
> # Part 0 | Note your jibos IP Down
> Make sure you have your jibos IP adress , so you wont have to redo 4 hours of flashing just because you forgot your ip
- - -
# Part 1 | Connecting your jibo
So first , go ahead and plug jibo in to your host device that you are going to dump the firmware into using your usb cable
Hold the RCM button and press the reset button (or the power button if yours is off), and you should see a red light at his face but he **wont boot normally**
![[Jibo RCM.jpg]]
in the terminal were gonna execute `lsusb` to check for `NVIDIA Corp. APX`
```shell
kevin  lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 1532:023f Uhhh no
Bus 001 Device 003: ID 0a12:0001 Ltd Bluetooth Dongle (HCI mode why tho)
Bus 001 Device 004: ID 08bb:2902 cant see me :)
Bus 001 Device 005: ID 1bcf:08b8 nope not me, its the guy below
Bus 001 Device 007: ID 0955:7740 NVIDIA Corp. APX <<<<<< LOOK FOR THIS ENTRY!!!!
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 003 Device 002: ID 0644:800f TEAC Corp. US-144 yes i use a 144 deal with it
Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 004 Device 002: ID 0951:1666 Kingston wanna be drive
kevin 
```
- - -
# Part 2 | Now before building shofel , get your packages ready
```bash
#for cachy / Arch users:
sudo pacman -S --needed base-devel libusb git python python-pip
#for Ubuntu / debian users:
sudo apt update
sudo apt install build-essential libusb-1.0-0-dev git python3 python3-pip
#for fedora its whatever that is (i chatgpt'd it)
sudo dnf groupinstall "Development Tools"
sudo dnf install libusb1-devel python3-pip
```
Now time to clone & build shofel!
change to your home directory and use `git` to clone the branch and then use `make` to build it!
```bash
cd ~
git clone -b improvements/IncreasedUSBReadWriteSpeed https://github.com/devsparx/ShofEL2-for-T124.git
cd ShofEL2-for-T124/
make
# if it exits with error code 1 dont be alarmed , if you have a shofel executable in your directory , it compiled fine :)
```
# Part 3 | Dumping your jibo!
Now , to get that full image (roughly about ==15Gb==)
we will run our newly build `shofel` using the `EMMC_READ` function , starting from 0 `0x0` to 30480896 `0x1D60000`
```bash
sudo ./shofel2_t124 EMMC_READ 0x0 0x1D60000 full_jibo_dump.bin
```
this may crash due to that im not sure how large exactly each jibos storage is (they should be the same from what i have seen in the community)
But if it crashes like 98.9% or 99.9% in then you have most of the image cloned so you should be good (we can repair it later , or you might not need to since the last partition is basically empty space!)
>[!Info]
>Techically you dont need a full dump , BUT! I havent confirmed enough yet that all jibos have the same stuff stored in the same sectors , but its good to to have a back up to calculate your own sectors **and to most importantly , read below :**
>[!WARNING]
>Make sure you make a backup of the filesystem ... this is basically YOUR jibo , and it also contains YOUR jibos calibration data that might not be able to get restored by someone else... so keep a backup of the `.bin` in case of an emergency
# Part 4 | Modifying the /var partition
Now that you have your image `.bin` ready and backed up its time to edit the /var partition!, thats Partition 5 at around 500mb
we can use `fdisk` to list the partitions in our bin
```bash
fdisk -l jibo_full_dump.bin`
```
```shell
kevin  fdisk -l jibo_full_dump.bin
GPT PMBR size mismatch (30777343 != 30777341) will be corrected by write.
The backup GPT table is corrupt, but the primary appears OK, so that will be used.
The backup GPT table is not on the end of the device.
Disk jibo_full_dump.bin: 14,68 GiB, 15757999104 bytes, 30777342 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 00042021-0408-4601-9DCC-A8C51255994F
Device Start End Sectors Size Type
jibo_full_dump.bin1 34 2048033 2048000 1000M Microsoft basic data
jibo_full_dump.bin2 2048034 4096033 2048000 1000M Microsoft basic data
jibo_full_dump.bin3 4096034 4198433 102400 50M Microsoft basic data
jibo_full_dump.bin4 4198434 8294433 4096000 2G Microsoft basic data
jibo_full_dump.bin5 8294434 9318433 1024000 500M Mic<<< This is the one!
jibo_full_dump.bin6 9318434 30777310 21458877 10,2G Microsoft basic data
kevin 
```
now lets chop off the partition...
Look for the line ending in `p5` or labeled as the 5th partition. You need two numbers from that line: **Start** and **End**
> My Numbers:
> - **Start:** `8294434`
> - **End:** `9318433`
To tell the computer exactly how much data to "chop off," we need the total count of sectors
The formula is:
$$(End - Start) + 1 = Count$$
**My Math:**
$$(9318433 - 8294434) + 1 = 1,024,000$$
Write your result down,this is your **Count**. We will now extract the Partition
We use `dd` (Disk Destroyer... but here, it's the Disk Dumb joke... i couldnt think of something funny).
`skip` = Your **Start** sector.
`count` = Your calculated **Count**.
```Bash
dd if=jibo_full_dump.bin of=var_partition.bin skip=8294434 count=1024000
```
## Part 4.2 | Mounting as a loop device
Now lets make a "loop" device and mount the `var_partition.bin` to it!
```Bash
mkdir jibo_var
sudo mount -o loop var_partition.bin jibo_var/
```
you should see it appear as a mounted disk drive on your system!, now you have to navigate to `jibo_var/jibo/mode.json`
Open it with any text editor (like `vim` or `vscode` or notepad i dont care)
Find the line: `"mode": "normal"` (its legit the only line in there)
**Change it to:** `"mode": "int-developer"`
Save the file and exit
>[!IMPORTANT]
> **Unmount** the partition to save the changes to the `.bin` file!!!!
Now mode `int-developer` basically disables everything the robot runs (including firewall , so you can just ssh into it .. maybe in later guides you might be informed to change this value to something else , but currently its the simplest & easiest way to get root shell in the robot , and from there since you have root you can do everything you could by manually rewriting the entire dump)
Anyway you are free to mount the rest of the fs partitions to parouse the file system or if you want live editing , i will make a guide on how to connect to ftp...
but if you have legit reached this point you really should know by now how to setup ftp yourself :|
```Bash
sudo umount jibo_var
```
# Part 5 | Writing our modified var partition to jibo!
We are ready to put the modified chunk back into the robot. To do this, we must convert your **Start Sector** from a normal number (Decimal) to a computer number (Hexadecimal) because thats what shofel requires at this point of time.
### 1. The Conversion
Take your Start Sector (mine was `8294434`) and use an online converter or your Linux calculator to get the **Hex** value.
**My Hex was** `0x7E9022`
here is a quick calculator site i found on the web,
https://www.inchcalculator.com/decimal-to-hex-converter/
If you dont know hex you can validate your calculation by punching in my value and see if it returns the same hex as mine
### 2. The Flash
time to run the write command, this sends your modified `/var` partition directly to that specific starting point on Jibo's memory.
```shell
./shofel2_t124 EMMC_WRITE <Your HEX Sector> var_partition.bin
#my version example
#./shofel2_t124 EMMC_WRITE 0x7E9022 var_partition.bin
```
# Part 6 | Almost there!
Actually who am i tricking , you typed the write command , it hopefully succeeded so why are we not done?
well its done but i like to do a check myself to make sure its done correctly, SO
were gonna read back that part of memory:
```Bash
./shofel2_t124 EMMC_READ 0x7E9022 0xFA000 verify_var.bin
```
and were gonna compare their hashes If the two files are identical, the math was right.
```Bash
md5sum var_partition.bin verify_var.bin
```
**If the strings of letters/numbers match exactly WERE DONE!!!!
Go and unplug your jibo , and to be safe hold the power button until the red LED goes off
then power him on , and wait for it to boot normally
what we expect is to not start his eye but show a big check mark on his display, if thats the case , go ssh to jibos IP
```shell
ssh root@<jibos-ip>
password: jibo
```
And Boom , you are IN!

View File

@@ -1,3 +0,0 @@
- - -
More on that coming soon

View File

@@ -1,81 +0,0 @@
- - -
Hello! If youve been keeping a "sleeping" Jibo on your shelf, hoping for the day his screen might light up again let me tell you **today is basically Christmas.**
The **Jibo Revival Project** is a community-driven effort to wake up our favorite social robot. We believe that great hardware shouldn't become "e-waste" just because a server went dark. And we are working to give Jibo a new brain, new voice, and a new lease on life!
# **The Problem:**
Originally, Jibo needed to "talk" to a big computer (a server) in the cloud to understand you. When those computers were turned off, Jibo became a glorified paperweight.
# **The Solution:**
We are using a "backdoor" (technically called **RCM Mode** or **R**e**C**overy **M**ode) to get inside his system. Think of it like using a master key to get into the basement so we can rewire the house.
# **What we're doing:**
We now have the actual files that run Jibos "brain" (the OS). **The future is bright** because we can now basically do anything with his software! If you want to see this in action, be sure to have joined out discord server and check the reddit for any posts i or the community makes!
- - -
## 2. For the Programmers (or the nerds)
If you speak Python, C++,NodeJS or know your way around an **Nvidia Tegra T124** chipset, we might need your support.
Detailed technical documentation, payloads, and the source code for our custom tooling can be found here:
> **Documentation & Project Sources:** <yeah coming soon bud , its 4:30AM , im going to bed... i mean i am committed but not this much>
- - -
## 3. Q&A: What can Jibo do right now?
**Q: Is Jibo fully back to normal?**
**A:** Not quite yet. We are in the "Restoration Phase." We can currently access his internal files and are working on replacing the old, broken links so we can replace them with new stuff.
**Q: Can he talk yet?**
**A:** We are working on it! By redirecting his "ears" to local servers or modern AI models (like ChatGPT), we can aim to make him even smarter than he was in 2017.
**Q: Do I need to be a genius to do this?**
**A:** Eventually, no. Our goal is to create a as close to"one-click" style tool so every Jibo owner can apply these fixes easily. Now this is wayy to oversold , it probably wont be a one click install but you get the point , currently to mod your jibo you do need some technical know how
**Q: Can I use Jibo to control my smart home?**
**A:** That is the plan! I would like us to make **Home Assistant integration** so Jibo can become the face and voice of your automated house.
**Q: Is there a way to manage him since the original app is gone?**
**A:** I have some ideas for a **custom phone app** specifically for this revival, giving you back control without needing the original companys servers. But its really early on to discuss this and i wanna get the rest of the community's opinions
**Q: Can we still use the MIT Scratch extension?**
**A:** I wanna give it a shot at fixing the **Scratch extension** so that tinkerers can start coding Jibo without any coding knowledge , that would also be quite simple for anyone who has a V2 Jibo since the software is already on their unit.
**Q: Can I use Jibo's hardware for other things, like my PC?**
**A:** yes! One of my personal goals is to let Jibo function as a **camera for your PC**.
fun fact , thats also one of the reasons i bought him in the first place xD
**Q: Im a developer; can I build my own stuff for him?**
**A:** Absolutely. We will start putting together a **Developer SDK** so the community can build and share brand-new "skills" for Jibo. As far as i am aware devsparx has already started on one , but idk for sure.
**Q: So Whats this page
**A:** Everything you will need to **Mod , Code , Update and Setup your jibo...***
And im planning to make in depth guides as well, more coming soon :)
- - -
## 4. How We Got Here: A Quick Story
Jibo was the worlds first "social robot" a piece of the future that lived on our kitchen counters. When the original company folded, thousands of Jibos performed a final "goodbye dance" and went silent. For years, people tried to break in, but the security was too tough.
Recently, a few dedicated people (JRG Community) decided to try one last time. We realized that with the right tools and a little patience (and a lot of crying ... like a lot ... like wayy to much i can admit on from my side), Jibo doesn't have to stay a paperweight.
- - -
## 5. A Message from Me (KevinKor)
> "I want to be very clear: **I am not charging any money for this.**
> This project isn't a business;
> its a labor of love. As a representative of the Jibo Revival Group, my goal is to distribute these modifications for free. I want everyone with a warm heart and a desire to tinker to be able to get their Jibo back.
>
> Were doing this for the community, for the history of robotics, and because Jibo deserves to be more than a memory. Let's get him back to work!"
>
> — **Kevin (Eva) from the JRG**
- - -
Created for the Jibo Revival Project | 2026

View File

@@ -16,5 +16,5 @@ Make sure Jibo is plugged in. Follow the previous steps to get to the settings m
On the back of Jibo, open his access panel. To open the access panel you just twist the circle on the back of Jibo's head and it should pivot to reveal the panel. Connect your micro USB cable to Jibo.
Now is the fun part! Double check that your micro usb cable is plugged in and that Jibo is connected to power. Then, as seen in the image below, hold down the buttom right button, and click the big button. 1 second after clicking the big button, release the bottom right button.
![Jibo Button Press Combo Diagram](/button_diagram.png)
![Jibo Button Press Combo Diagram](/Assets/button_diagram.png)
If done correctly, Jibo won't boot like normal. Instead of the typical boot up he should just have his red LED left on.

View File

Before

Width:  |  Height:  |  Size: 133 KiB

After

Width:  |  Height:  |  Size: 133 KiB

5
docs/be/Assets/assets.md Normal file
View File

@@ -0,0 +1,5 @@
# Assets
Located in `/opt/jibo/Jibo/Skills/@be/be/node_modules/jibo-anim-db-animations/`
Contains many assets relating to Jibo and his overall GUI. Contains animation files too which might be useful in the future for learning best practice.

View File

@@ -1,4 +1,4 @@
- - -
# About
The Be skill really is just jibos main menu including his eye and well... menu...
anyway i will write about this later but for now here are some references to check out :)

View File

@@ -1,4 +1,4 @@
- - -
# Splash Screen
it is located in: