Skip to content

Commit 529d79c

Browse files
authored
Update README.md
1 parent d01ca53 commit 529d79c

File tree

1 file changed

+19
-72
lines changed

1 file changed

+19
-72
lines changed

README.md

Lines changed: 19 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,15 @@
11
# PCEmulatorPlus
22
The PCEmulator by Fabrizio Di Vittorio plus applications for a more complete system. For the TTGO VGA32 1.4 board and compatibles.
33

4+
- What is this for?
5+
This code allows you to use a microcontroller-based board (Esp32) as if it were a computer. This is accomplished by combining a 16-bit PC emulator (8086-CGA/Hercules) with more modern applications (MP3 player, JPG image viewer, microSD card file manager, etc.).
6+
7+
- What are the advantages?
8+
This allows you to have a low-power, cheap, offgrid, and highly modular computer. Suitable for extreme contexts (lack of electricity, market crisis, etc.)
9+
10+
- What are the disadvantages?
11+
The computer built using this code has a much lower processing capacity than what is normally seen. You won't be able to watch videos (properly), surf the Internet or play photorealistic action games.
12+
413
Apps:
514

615
**With Display:**
@@ -23,85 +32,23 @@ See the wiki for limitations and how to use this system.
2332

2433
The system is being designed to work even if part of the hardware is unavailable, thus avoiding the production of electronic waste in the event of a component failure.
2534
What works without...
26-
- microSD card: ChatterBox, Web Radios, Wi-fi Safe,
27-
- Sound output: Wi-fi Safe, File Browser, Jpg View,
28-
- Wi-Fi: Audio Player, File Browser, Jpg View,
29-
- Mouse: PCEmulator, File Browser, Jpg View,
35+
- microSD card: ChatterBox, Web Radios, Wi-fi Safe, Audio Maker,
36+
- Sound output: Wi-fi Safe, File Browser, Jpg View, PCEmulator,
37+
- Wi-Fi: Audio Player, File Browser, Jpg View, PCEmulator, Audio Maker,
38+
- Mouse: PCEmulator, File Browser, Jpg View, PCEmulator, Audio Player, Timer, Audio Maker,
3039
- Keyboard: File Browser, ChatterBox, Wi-fi Safe,
31-
- PSRAM: ChatterBox, Wi-fi Safe, File Browser,
32-
- VGA output: ChatterBox, Web Radios, Audio Maker
40+
- PSRAM: ChatterBox, Wi-fi Safe, File Browser, Timer,
41+
- VGA output: ChatterBox, Web Radios, Audio Maker, Audio Player, Timer,
3342

43+
If you don't use the video output you will need to use a keyboard and the audio output.
3444
Theoretically, some applications can even be used by a blind person if an accessible keyboard is connected.
3545

36-
Used libs:
37-
FabGL by Fabrizio Di Vittorio version 1.0.9 https://github.com/fdivitto/FabGL/releases/tag/v1.0.9
38-
TJpg_Decoder by Bodmer version 0.0.2 https://github.com/Bodmer/TJpg_Decoder/releases/tag/0.0.2
39-
ESP32-audioI2S por Wolle https://github.com/schreibfaul1/ESP32-audioI2S
40-
And
41-
Board arduino-esp32 by espressif version 1.0.6 https://github.com/espressif/arduino-esp32/releases/tag/1.0.6
42-
43-
44-
45-
Release 0.7 notes:
46-
47-
Now you'll also be able to listen to audio files (mp3, wav, ...) directly from the micro SD card. Adding this functionality required a lot of system resources and is therefore severely limited.
48-
Limitations:
49-
- Mono only
50-
- No controls, you will have to change the volume on the device you are using as a speaker.
51-
- Only 1 audio file at a time.
52-
53-
This functionality will probably be changed in future versions since the plan is to have applications that work without needing a display and the way 'Audio Player' is currently working still has this need.
54-
55-
56-
Release 0.6:
57-
Now with Webradios!
58-
59-
How to use WebRadio:
60-
- Keys from 1 to 0 to choose the radio.
61-
- 'Up' and 'Down' keys to change the volume.
62-
- 'Backspace' key to exit the app.
63-
- The key needs to be pressed for about 10 seconds to work.
64-
- You can add radios by changing the code. It would even be possible to place several radios on the letter keys. You can also change the code to play playlists over your local area network (LAN).
65-
66-
The idea is to make the system also work without a monitor and will be implemented in future versions with more apps.
46+
Disks for the PCEmulator:
47+
https://drive.google.com/drive/folders/1OFRNx3wDCHZ4ajmrT9v_o90OhCe7HoOJ?usp=share_link
6748

6849
Used libs:
69-
TJpg_Decoder by Bodmer version 0.0.2 https://github.com/Bodmer/TJpg_Decoder/releases/tag/0.0.2
7050
FabGL by Fabrizio Di Vittorio version 1.0.9 https://github.com/fdivitto/FabGL/releases/tag/v1.0.9
71-
And
72-
Board arduino-esp32 by espressif version 1.0.6 https://github.com/espressif/arduino-esp32/releases/tag/1.0.6
73-
ESP32-audioI2S por Wolle https://github.com/schreibfaul1/ESP32-audioI2S
74-
75-
"O sketch usa 1766738 bytes (56%) de espaço de armazenamento para programas. O máximo são 3145728 bytes.
76-
Variáveis globais usam 57456 bytes (17%) de memória dinâmica, deixando 270224 bytes para variáveis locais. O máximo são 327680 bytes."
77-
78-
79-
80-
Release 0.5:
81-
Five Apps in main menu:
82-
-- PCEmulator (The main app for use many O.S. and apps)
83-
84-
-- App ChatterBox: Horizontal chat room server (connects to a network and opens an AP to receive connections). This application can be used even if the Esp32 is not connected to a video monitor. Just repeat the keys used to activate it: Enter, wait <10 seconds press Enter again.
85-
Original code: https://github.com/fenwick67/esp32-chatterbox
86-
87-
-- App JPG View: Only .jpg files on internal memory (SPIFFS). Only files with <1Mb for now. Only 512x384 pixels visible (can be change in the code)
88-
Original code: https://github.com/fdivitto/FabGL/discussions/160#discussioncomment-1423074
89-
Recomended: Use the Hercules mode and convert the imagens to see in 'Compushow' or VUIMG.
90-
(Alternatively you can view .gif images in 4 colors and 320x200 using the 'Compushow' application available on the HD-Geral disk image, by PCEmulator: https://drive.google.com/file/d/1sEvAZ998l3wTq4KzkuHQPrPWqZv5kday/view?usp= sharing
91-
I recommend 1st converting the image using the GIMP application with scale image/canvas to fit in 320x200, sharpen filter, indexed mode: 'generate optimum pallete maximum colors 4', 'color dithering Floyd-Steinberg Reduced'.)
92-
93-
-- File Browser: by Fabrizio Di Vittorio. You can move files between internal memory and microSD card.
94-
95-
-- Update time: by Fabrizio Di Vittorio. Download the correct date and time from the internet. I intend to add functions in future.
96-
97-
Used libs:
9851
TJpg_Decoder by Bodmer version 0.0.2 https://github.com/Bodmer/TJpg_Decoder/releases/tag/0.0.2
99-
FabGL by Fabrizio Di Vittorio version 1.0.9 https://github.com/fdivitto/FabGL/releases/tag/v1.0.9
52+
ESP32-audioI2S por Wolle https://github.com/schreibfaul1/ESP32-audioI2S
10053
And
10154
Board arduino-esp32 by espressif version 1.0.6 https://github.com/espressif/arduino-esp32/releases/tag/1.0.6
102-
103-
"O sketch usa 1558458 bytes (49%) de espaço de armazenamento para programas. O máximo são 3145728 bytes.
104-
Variáveis globais usam 55616 bytes (16%) de memória dinâmica, deixando 272064 bytes para variáveis locais. O máximo são 327680 bytes."
105-
106-
Disks for the PCEmulator:
107-
https://drive.google.com/drive/folders/1OFRNx3wDCHZ4ajmrT9v_o90OhCe7HoOJ?usp=share_link

0 commit comments

Comments
 (0)