Финальная версия прошивки. Работа с программами на SD-карте.

Все статьи по данной игровой консоли - по тегу G-BASIC

Настала пора обновляться. Текущая версия прошивки - 1.0.511. Брать тут.

Обновление большое, важное. И обязательное. Обновление затрагивает как компилятор, так и виртуальную машину. Обновился так же компилятор и отладчик для ПК.

Ранее скомпилированные программы могут работать неправильно. Их нужно повторно скомпилировать в новой версии компилятора. 

В обновлении исправлено несколько старых ошибок, добавлена куча новых :)

Заодно проведен тест времени работы консоли от литиевого аккумулятора емкостью 450 китайских мА*ч.
В режиме TURBO 0 консоль продержалась 4 часа 33 минуты. В режиме TURBO 3 - 3 часа 38 минут. 

Ниже описаны встроенные программы. Так же описан принцип сохранения и поиска программ на SD-карточке.

Встроенные программы доступны, если в консоль не вставлена карта памяти, либо на этой карте нет ни одной программы.

Snake

Старая добрая змейка. Необходимо ползать по полю, поедая вкусности, при этом нельзя себя укусить за хвост и нельзя врезаться в стенку. При поедании вкусностей змея растет. Уровень завершается при достижении змеёй определенной длины.

Кнопки A и B - поворот змеи против и по часовой стрелке.
Стрелки - явное задание направления движения змеи.
S - включение-выключение звуковых эффектов.
P - Пауза/выход/справка.

Перемещение по меню - стрелки вверх-вниз, выбор - А или В.

На первом уровне необходимо съедать вишни, бананы и яблоки.
Как только змея вырастет до определенной длины, происходит переход на следующий уровень.
На всех уровнях, начиная со второго, на игровом поле появляются дырки-телепорты. Увеличивается количество доступных к съедению фруктов.
Но и появляются несъедобные камни. Дырки телепорта и камни иногда меняют свое местоположение случайным образом.
Так же, если жизней у змеи меньше трех, на поле иногда появляется дополнительная жизнь (+1).

Xonix

Старая (1984г) аркада. Игровое поле представляет собой прямоугольник "суши", внутри которого "море". По морю в диагональных направлениях двигаются "морские монстры", по суше - "сухопутный монстр".
Игрок может свободно передвигаться по "суше", где он уязвим для "сухопутного монстра". Выходя в "море", он оставляет за собой след, уязвимый для "морских монстров", при этом в "море" нельзя изменить направление движения игрока на противоположное, можно поворачивать только на 90 градусов в любую сторону, также в "море" нельзя останавливаться.
Игра считается проигранной, если игрока или его след собьёт "сухопутный" или "морской монстр". Так же наступает проигрыш при попытке игрока в "море" изменить направление движения на противоположное или наехать на свой собственный след.
Как только игрок снова оказывается на "суше", его след превращается в новую "сушу". Если при этом в "море" появилась замкнутая область, не содержащая "монстров", то вся эта область также превращается в "сушу".

Проще говоря, управляя игроком, необходимо отсекать куски "моря", превращая их в "сушу", а "монстры" этому процессу мешают.

Управление игроком - кнопки со стрелками.
S - включение/выключение звуковых эффектов
P - Пауза/выход.
Перемещение в меню паузы - стрелки вверх-вниз, выбор - А или В.

Tetris

Старая (1985г) аркадная игра-головоломка. Написана Алексеем Пажитновым, сотрудником ВЦ АН СССР. Игра за 39 лет портирована на огромное количество игровых приставок, консолей, компьютеров по всему миру. За право распространения игры боролись Atari, Nintendo и другие гиганты мировой игровой индустрии....
Цель игры - укладывать в "стакан" размерами 10 х 20 падающие сверху фигурки тетрамино. Полностью заполненные строки уничтожаются, принося игроку очки. 

Управление:
Стрелки влево-вправо сдвигают падающую фигурку влево или вправо. Нажатие стрелки вниз ускоряет падение фигурки, пока кнопка нажата. Ускоренное движение фигурки так же приносит дополнительные очки. 
Кнопка А и стрелка вверх вращают фигурку против часовой стрелки
Кнопка В вращает фигурку по часовой стрелке
Кнопка S - включает и выключает звуковые эффекты
Кнопка P - меню паузы или выхода из игры.
Перемещение в меню паузы - стрелки вверх-вниз, выбор - А или В.

В игре доступны два варианта цветового оформления, выбираемые при запуске - цветные фигурки на черном фоне ил имитация черно-белого ЖК-экрана. 

Вариант оформления выбирается стрелками вверх-вниз. Выбор  - кнопка А или В.

Clock

Просто стрелочные часы.
Выход из программы - по кнопке Р

______________________________________________________________________________

Так же напомню, что нажатие и удержание кнопки Р более 5 секунд завершает работу любой программы.

______________________________________________________________________________

SD-карта

Карту можно вставлять и вынимать даже при включенной консоли. При изъятии карты главное, что бы светодиод активности карты не горел. Изъятие карты при горящем светодиоде активности может привести к порче данных на карте вплоть до сбоя файловой системы.

При построении списка программ консоль обращается к карте. 

Есть 2 режима работы с картой - работа со списком программ из файла и сканирование карты и построение списка программ.

Работа со списком программ из файла.

Если карта доступна, то в первую очередь ищется файл GBasic.list

Это файл со списком программ, доступных для запуска. В файле можно программы разделить по категориям. Тогда, если категорий больше одной, консоль будет сначала отображать список категорий, а при выборе категории - список программ этой категории.

Файл GBasic.list имеет структуру, схожую с ini-файлами.
Точка с запятой указывает на начало комментария.
Пустые строки игнорируются.
В квадратных скобках указываются [ категории ] программ.
Остальные строки считаются ссылками на файлы программ. 
Ссылка должна содержать имя  файла и путь к нему.
Путь должен начинаться обратным слэшем "\" либо буквой диска, двоеточием и обратным слешем. Буква диска не имеет значения и игнорируется.
При загрузке списка файлов наличие этих файлов не проверяется. При попытке запуска несуществующего файла будет выводиться соответствующая ошибка.
После имени файла можно указать до 127 символов описания программы, отделив их от имени файла двоеточием ":". Общее ограничение длины строки с именем файла и описанием - 255 символов.
Если присутствует описание программы - становится доступным действие INFO для данного файла. Так же производится поиска файла с расширением .icon - см. ниже.

Пример такого файла:

Сканирование карты и построение списка программ.

Если файл GBasic.list отсутствует, консоль начинает сканировать карту на предмет файлов с текстом программ (*.bas) и ранее скомпилированных программ (*.bbc).

Сканируется корневой каталог карты памяти и каталоги первого уровня.

Все найденные программы заносятся в общий список, который потом будет отображен на дисплее консоли

Картинки (иконки) для программ.

Если рядом с файлом программы будет лежать файл с таким же именем, но с расширением .icon - консоль это запомнит и при наведении курсора на этот файл в списке будет доступно действие INFO и по нажатию кнопки Вправо консоль попытается показать изображение из этого файла. Изображение должно быть сохранено в формате 16-битного цвета RGB565 (программа конвертации) и иметь размеры не более 220х220 пикселей. 

Запуск программ.

Консоль умеет выполнять только файлы скомпилированных в байт-код программ. А программы на бейсике консоль сначала компилирует в байт-код, который потом выполняется.

При запуске программы консоль анализирует наличие на карте памяти как файла с текстом программы (*.bas), так и скомпилированной в байт-код программы (*.bbc). Если присутствуют оба файла - запускается файл с более поздней датой. 
Если есть только файл с текстом программы либо его дата больше, чем у скомпилированного файла, то сначала производится компиляция программы в байт-код, при этом создается (или заменяется) файл .bbc, а потом этот файл запускается на выполнение.

*Почему bbc? Да все просто, потому что Basic byte-code.

Что будет, если нет карты памяти или на ней нет программ ?

В этом случае консоль отобразит список встроенных программ (см. выше) - три игры и демо-программа стрелочных часов.

______________________________________________________________________________

К текущему моменту у меня подобрался маленький набор программ - три игрушки и несколько демонстрационно-тестовых программ.
Они собраны в один архив, который достаточно распаковать на пустую карту памяти и вставить в консоль.

В архиве присутствуют:

Три игры в категории Games - Змея, Зоникс и Тетрис

В категории Demos & Tests следующие программы:

SoundTest.bas - простой тест звука, стрелками вверх-вниз выбирается громкость, влево-вправо - ноты До-Ми-Соль от 2 до 6 октав. Выход - кнопка Р.

GraphTest.bas - отрисовка градиентов цветов, заливка экрана линиями в цикле и прямоугольниками для скоростей Turbo от 0 до 3, какие то тесты вывода линий, текста, пикселей, мелкого спрайта 16 х 16 пикселей.... Переход к следующему тесту - нажатие любой кнопки. Нажатие Р - досрочный выход из теста.

StarBlink.bas - Просто мигающие разноцветные точки. Выход - Р.

Clock.bas - простые стрелочные часы с секундной стрелкой и выводом даты. Выход - нажатие любой кнопки.

BatteryBench  - Программа теста батарейки. При запуске программа отображает результаты предыдущего теста - режим Turbo от 0 до 3 и время работы программы в часах, минутах и секундах. 
Стрелками вверх-вниз можно выбрать режим запуска теста. Кнопка А или В - запуск теста.
Кнопка Р - выход из программы.
При запуске программа включает соответствующий режим Turbo и начинает рисовать на экране простую анимацию. Параллельно считается и сохраняется время работы программы. На время своей работы программа блокирует автовыключение консоли при отсутствии нажатия кнопок.
Программа работает до нажатия кнопки Р или до завершения работы консоли по разряду батареи.
При следующем запуске программы будет отображено последнее сохраненное время работы и режим Turbo.
Сценарий работы с программой:
1. Зарядить аккумулятор консоли
2. Отключить консоль от зарядного устройства 
3. Запустить программу, выбрать режим и включить его
4. Ждать, пока консоль не отключится по низкому напряжению батареи.
5. Подключить консоль к зарядному устройству и включить ее
6. Запустить программу, посмотреть на время ее работы.
7. При необходимости - зарядить консоль и повторить тест для другого turbo-режима.

______________________________________________________________________________

UPD: Юрий уже успел собрать и даже запилить видосик - тыц!