Hello World for JCU(JPEG Codec Unit). JCU is JPEG codec unit of RZ/A1. When you use this program, we judge you have agreed to the following contents. https://developer.mbed.org/teams/Renesas/wiki/About-LICENSE

License

When you use this program, we judge you have agreed to the following contents.

本プログラムを使用する際は、以下の内容に合意した事になります。

https://developer.mbed.org/teams/Renesas/wiki/About-LICENSE

Information

Japanese version is available in lower part of this page.

このページの後半に日本語版が用意されています.

What is this ?

JPEG driver sample program using GR-PEACH or GR-LYCHEE.
When you decode/encode file, input file set width is 320 pixel and height is 240 pixel.

FormatJPEG file".jpg"
Color formatYCbCr422
Pixel size320x240
FormatBitmap file".bin"
Color formatYCbCr422
Pixel size320x240

Composition

GR-PEACH or GR-LYCHEE, PC and USB media.

  • Use USB0 of GR-PEACH:

/media/uploads/tyama/jpeg_conv_usb0.png

If you use the USB0 as USB Host, please close GR-PEACH's JP3.

/media/uploads/tyama/gr-peach-c_usb2.png

Please select USB0 connector by the following configuration.

mbed_app.json

{
    "config": {
        "usb-host-ch":{
            "help": "(for GR-PEACH) 0:ch0 1:ch1",
            "value": "0"
        },
        "audio-camera-shield":{
            "help": "(for GR-PEACH) 0:not use 1:use",
            "value": "0"
        }
   }
}


  • Use USB1 of GR-PEACH:

/media/uploads/tyama/jpeg_conv_usb1.png

If you use the USB1 as USB Host, please close Audio/Camera Shield's JP1.

/media/uploads/tyama/audiocamerashield_jp1.jpg

Please select Audio/Camera Shield and USB1 connector by the following configuration.

mbed_app.json

{
    "config": {
        "usb-host-ch":{
            "help": "(for GR-PEACH) 0:ch0 1:ch1",
            "value": "1"
        },
        "audio-camera-shield":{
            "help": "(for GR-PEACH) 0:not use 1:use",
            "value": "1"
        }
    }
}



The size of the changed picture is made 320x240pixel fixing by a sample program. When using a file with the picture size besides that, please change the below.

JPEG_converter\main.cpp

#define SAMPLE_WIDTH        (320)
#define SAMPLE_HEIGHT       (240)

How to use

  1. Please turn on the power to GR-PEACH or GR-LYCHEE and start terminal software.
  2. Please connect a USB media and press the reset button on the board.
  3. Input request of the file name is output on terminal.
  4. When a file of extension ".jpg" is designated, a JPEG file is decoded. A decoded file will be data of 320x240pixel and YCbCr422.
  5. When a file of extension ".bin" is designated, it's encoded to a JPEG file. An encoded file will be a JPEG file of 320x240pixel and YCbCr422.

The default setting of serial communication (baud rate etc.) in mbed is shown the following link.
Please refer to the link and change the settings of your PC terminal software.
The default value of baud rate in mbed is 9600, and this application uses baud rate 9600.
https://developer.mbed.org/teams/Renesas/wiki/GR-PEACH-Getting-Started#install-the-usb-serial-communication


概要

GR-PEACH or GR-LYCHEEを使ったJPEG driverサンプルプログラムです。
デコード/エンコードする入力ファイルは、幅を320pixel、高さを240pixelに設定してください。

FormatJPEG file".jpg"
Color formatYCbCr422
Pixel size320x240
FormatBitmap file".bin"
Color formatYCbCr422
Pixel size320x240

構成

GR-PEACH or GR-LYCHEE、PC、USBメディア

  • GR-PEACHでUSB0を使用する場合:

/media/uploads/tyama/jpeg_conv_usb0.png

USBホストとしてUSB0を使用する場合は、GR-PEACHのJP3を閉じてください。

/media/uploads/tyama/gr-peach-c_usb2.png

以下の設定でUSB0コネクタを選択して下さい。

mbed_app.json

{
    "config": {
        "usb-host-ch":{
            "help": "(for GR-PEACH) 0:ch0 1:ch1",
            "value": "0"
        },
        "audio-camera-shield":{
            "help": "(for GR-PEACH) 0:not use 1:use",
            "value": "0"
        }
}


  • GR-PEACHでUSB1を使用する場合:

/media/uploads/tyama/jpeg_conv_usb1.png

USBホストとしてUSB1を使用する場合は、Audio/Camera ShieldのJP1を閉じてください。

/media/uploads/tyama/audiocamerashield_jp1.jpg

以下の設定でAudio/Camera ShieldとUSB1コネクタを選択して下さい。

mbed_app.json

{
    "config": {
        "usb-host-ch":{
            "help": "(for GR-PEACH) 0:ch0 1:ch1",
            "value": "1"
        },
        "audio-camera-shield":{
            "help": "(for GR-PEACH) 0:not use 1:use",
            "value": "1"
        }
    }
}



サンプルプログラムでは、変換する画像のサイズを320x240pixel固定としております。 それ以外の画像サイズのファイルを使用する場合は以下を変更してください。

JPEG_converter\main.cpp

#define SAMPLE_WIDTH        (320)
#define SAMPLE_HEIGHT       (240)

使い方

  1. GR-PEACH or GR-LYCHEEに電源を入れ、Terminalソフトを立ち上げます。
  2. USBメディアを接続し、ボード上にあるリセットします。
  3. Terminal上にファイル名の入力要求が出力されます。
  4. 拡張子".jpg"のファイルを指定するとJPEGファイルのデコードを実行します。デコードしたファイルは、320x240pixel、YCbCr422のデータとなります。
  5. 拡張子".bin"のファイルを指定するとJPEGファイルへのエンコードを実行します。エンコードしたファイルは、320x240pixel、YCbCr422のJPEGファイルとなります。

mbedのシリアル通信(ボーレート等)のデフォルト設定は以下のリンクに示しています。
リンクを参考に、お使いのPCターミナルソフトの設定を変更して下さい。
mbedでのボーレートのデフォルト値は9600で、このサンプルではボーレート9600を使います。
https://developer.mbed.org/teams/Renesas/wiki/GR-PEACH-Getting-Started#install-the-usb-serial-communication

Committer:
1050186
Date:
Fri Dec 28 01:41:07 2018 +0000
Revision:
9:602d6ca79b85
Parent:
8:284c50c65346
Delete unnecessary code.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dkato 0:94bcab936677 1 #include "mbed.h"
dkato 0:94bcab936677 2 #include "JPEG_Converter.h"
Osamu Nakamura 6:30dff7910f8b 3 #include "FATFileSystem.h"
dkato 0:94bcab936677 4 #include "USBHostMSD.h"
dkato 0:94bcab936677 5
dkato 0:94bcab936677 6 #define SAMPLE_WIDTH (320)
dkato 0:94bcab936677 7 #define SAMPLE_HEIGHT (240)
dkato 0:94bcab936677 8 #define SAMPLE_BUFF_SIZE (SAMPLE_WIDTH * SAMPLE_HEIGHT * 4)
dkato 0:94bcab936677 9
dkato 0:94bcab936677 10 #define MAX_FILE_NAME_LENGTH (64)
dkato 0:94bcab936677 11 #define FOLD_COUNT (5)
dkato 0:94bcab936677 12
dkato 0:94bcab936677 13 DigitalOut led1(LED1);
dkato 0:94bcab936677 14 Serial pc(USBTX, USBRX);
dkato 0:94bcab936677 15
dkato 4:6e390b05b558 16 #if defined(__ICCARM__)
1050186 8:284c50c65346 17 #pragma data_alignment=32
1050186 8:284c50c65346 18 static uint8_t JCUBuffer_INPUT[SAMPLE_BUFF_SIZE]@ ".mirrorram"; //32 bytes aligned!;
1050186 8:284c50c65346 19 #pragma data_alignment=32
1050186 8:284c50c65346 20 static uint8_t JCUBuffer_OUTPUT[SAMPLE_BUFF_SIZE]@ ".mirrorram"; //32 bytes aligned!;
dkato 4:6e390b05b558 21 #else
1050186 8:284c50c65346 22 static uint8_t JCUBuffer_INPUT[SAMPLE_BUFF_SIZE]__attribute((section("NC_BSS"),aligned(32))); //32 bytes aligned!;
1050186 8:284c50c65346 23 static uint8_t JCUBuffer_OUTPUT[SAMPLE_BUFF_SIZE]__attribute((section("NC_BSS"),aligned(32))); //32 bytes aligned!;
dkato 4:6e390b05b558 24 #endif
dkato 0:94bcab936677 25
dkato 0:94bcab936677 26 bool get_file_name(char * p_buf, int size) {
dkato 0:94bcab936677 27 bool ret;
dkato 0:94bcab936677 28 char ch;
dkato 0:94bcab936677 29 int i = 0;
dkato 0:94bcab936677 30
dkato 0:94bcab936677 31 while (1) {
dkato 0:94bcab936677 32 ch = (char)pc.getc();
dkato 0:94bcab936677 33 if (ch == '\r'){
dkato 0:94bcab936677 34 p_buf[i] = '\0';
dkato 0:94bcab936677 35 pc.putc('\n');
dkato 0:94bcab936677 36 ret = true;
dkato 0:94bcab936677 37 break;
dkato 0:94bcab936677 38 } else if (ch == '\n') {
dkato 0:94bcab936677 39 // Do Nothing
dkato 0:94bcab936677 40 } else if (ch == '\b') {
dkato 0:94bcab936677 41 if (i > 0) {
dkato 0:94bcab936677 42 pc.puts("\b \b");
dkato 0:94bcab936677 43 i--;
dkato 0:94bcab936677 44 p_buf[i] = '\0';
dkato 0:94bcab936677 45 }
dkato 0:94bcab936677 46 } else if (i < size) {
dkato 0:94bcab936677 47 p_buf[i] = ch;
dkato 0:94bcab936677 48 i++;
dkato 0:94bcab936677 49 pc.putc(ch);
dkato 0:94bcab936677 50 } else {
dkato 0:94bcab936677 51 ret = false;
dkato 0:94bcab936677 52 break;
dkato 0:94bcab936677 53 }
dkato 0:94bcab936677 54 }
dkato 0:94bcab936677 55
dkato 0:94bcab936677 56 return ret;
dkato 0:94bcab936677 57 }
dkato 0:94bcab936677 58
dkato 0:94bcab936677 59 int main() {
dkato 0:94bcab936677 60 char file_name[MAX_FILE_NAME_LENGTH + FOLD_COUNT];
dkato 0:94bcab936677 61 JPEG_Converter decoder;
dkato 0:94bcab936677 62 JPEG_Converter::bitmap_buff_info_t aBitmapData;
dkato 0:94bcab936677 63 FILE * rd_fp = NULL;
dkato 0:94bcab936677 64 FILE * wr_fp = NULL;
dkato 0:94bcab936677 65 int filesize;
dkato 0:94bcab936677 66 size_t EncodeSize;
Osamu Nakamura 6:30dff7910f8b 67
Osamu Nakamura 6:30dff7910f8b 68 FATFileSystem fs("usb");
Osamu Nakamura 6:30dff7910f8b 69 USBHostMSD msd;
dkato 0:94bcab936677 70
dkato 0:94bcab936677 71 file_name[0] = '/';
dkato 0:94bcab936677 72 file_name[1] = 'u';
dkato 0:94bcab936677 73 file_name[2] = 's';
dkato 0:94bcab936677 74 file_name[3] = 'b';
dkato 0:94bcab936677 75 file_name[4] = '/';
dkato 0:94bcab936677 76
dkato 0:94bcab936677 77 //try to connect a MSD device
dkato 0:94bcab936677 78 while(!msd.connect()) {
1050186 8:284c50c65346 79 ThisThread::sleep_for(500);
dkato 0:94bcab936677 80 }
Osamu Nakamura 6:30dff7910f8b 81
Osamu Nakamura 6:30dff7910f8b 82 //Now that USB flash disk is detected, file system is mounted
Osamu Nakamura 6:30dff7910f8b 83 fs.mount(&msd);
dkato 0:94bcab936677 84
dkato 3:19e5a993ec7d 85 pc.printf("%dpix x %dpix\n", SAMPLE_WIDTH, SAMPLE_HEIGHT);
dkato 0:94bcab936677 86
dkato 0:94bcab936677 87 while (1) {
dkato 3:19e5a993ec7d 88 pc.printf("\nInput file name (.jpg or .bin)>");
dkato 0:94bcab936677 89 if (get_file_name(&file_name[FOLD_COUNT], MAX_FILE_NAME_LENGTH) == false) {
dkato 3:19e5a993ec7d 90 pc.printf("Error:Max file name length is %d\n", MAX_FILE_NAME_LENGTH);
dkato 0:94bcab936677 91 } else {
dkato 0:94bcab936677 92 size_t len = strlen(file_name);
dkato 0:94bcab936677 93 if ((len > 4) && (file_name[len - 4] == (char)'.')
dkato 0:94bcab936677 94 && ((file_name[len - 3] | 0x20u) == (char)'j')
dkato 0:94bcab936677 95 && ((file_name[len - 2] | 0x20u) == (char)'p')
dkato 0:94bcab936677 96 && ((file_name[len - 1] | 0x20u) == (char)'g')) {
dkato 0:94bcab936677 97 // input ".jpg"
dkato 0:94bcab936677 98 // decode JPG file to bitmap file
dkato 0:94bcab936677 99 rd_fp = fopen(file_name, "r");
dkato 0:94bcab936677 100 if (rd_fp == NULL) {
dkato 3:19e5a993ec7d 101 pc.printf("Error:File is not exist \n");
dkato 0:94bcab936677 102 } else {
dkato 0:94bcab936677 103 fseek(rd_fp, 0, SEEK_END);
dkato 0:94bcab936677 104 filesize = ftell(rd_fp);
dkato 0:94bcab936677 105 if (filesize > SAMPLE_BUFF_SIZE) {
dkato 3:19e5a993ec7d 106 pc.printf("Error:File size over \n");
dkato 0:94bcab936677 107 } else {
dkato 0:94bcab936677 108 led1 = 1;
dkato 0:94bcab936677 109 fseek(rd_fp, 0, SEEK_SET);
dkato 0:94bcab936677 110 fread(&JCUBuffer_INPUT[0], sizeof(char), filesize, rd_fp);
dkato 3:19e5a993ec7d 111 pc.printf("[Decode Mode]\n");
dkato 3:19e5a993ec7d 112 pc.printf("\nOutput file name (.bin)>");
dkato 0:94bcab936677 113 if (get_file_name(&file_name[FOLD_COUNT], MAX_FILE_NAME_LENGTH) == false) {
dkato 3:19e5a993ec7d 114 pc.printf("Error:Max file name length is %d\n", MAX_FILE_NAME_LENGTH);
dkato 0:94bcab936677 115 } else {
dkato 0:94bcab936677 116 //YCbCr setting
dkato 0:94bcab936677 117 aBitmapData.width = SAMPLE_WIDTH;
dkato 0:94bcab936677 118 aBitmapData.height = SAMPLE_HEIGHT;
dkato 0:94bcab936677 119 aBitmapData.format = JPEG_Converter::WR_RD_YCbCr422; //YCbCr[0] & ARGB8888[1] is 4byte, not RGB565[2] is 2byte
dkato 0:94bcab936677 120 aBitmapData.buffer_address = (void *)JCUBuffer_OUTPUT;
dkato 3:19e5a993ec7d 121 pc.printf("File decode start\n");
dkato 0:94bcab936677 122 // JPEG_Converter
dkato 0:94bcab936677 123 if (decoder.decode((void *)JCUBuffer_INPUT, &aBitmapData) == JPEG_Converter::JPEG_CONV_OK) {
dkato 3:19e5a993ec7d 124 pc.printf("File decode done %dbyte\n", (SAMPLE_WIDTH * SAMPLE_HEIGHT * 4));
dkato 3:19e5a993ec7d 125 pc.printf("File write start\n");
dkato 0:94bcab936677 126 wr_fp = fopen(file_name, "w");
dkato 0:94bcab936677 127 fwrite(JCUBuffer_OUTPUT, sizeof(char), (SAMPLE_WIDTH * SAMPLE_HEIGHT * 4), wr_fp);
dkato 0:94bcab936677 128
dkato 0:94bcab936677 129 fclose(wr_fp);
dkato 3:19e5a993ec7d 130 pc.printf("File write done\n");
dkato 0:94bcab936677 131 led1 = 0;
dkato 0:94bcab936677 132 } else {
dkato 3:19e5a993ec7d 133 pc.printf("Error:JCU decode error\n");
dkato 0:94bcab936677 134 led1 = 0;
dkato 0:94bcab936677 135 }
dkato 0:94bcab936677 136 }
dkato 0:94bcab936677 137 }
dkato 0:94bcab936677 138 fclose(rd_fp);
dkato 0:94bcab936677 139 }
dkato 0:94bcab936677 140 } else if ((file_name[len - 4] == (char)'.')
dkato 0:94bcab936677 141 && ((file_name[len - 3] | 0x20u) == (char)'b')
dkato 0:94bcab936677 142 && ((file_name[len - 2] | 0x20u) == (char)'i')
dkato 0:94bcab936677 143 && ((file_name[len - 1] | 0x20u) == (char)'n')) {
dkato 0:94bcab936677 144 // input ".bin"
dkato 0:94bcab936677 145 // encode bitmap file to JPEG file
dkato 0:94bcab936677 146 rd_fp = fopen(file_name, "r");
dkato 0:94bcab936677 147 if (rd_fp == NULL) {
dkato 3:19e5a993ec7d 148 pc.printf("Error:File is not exist\n");
dkato 0:94bcab936677 149 } else {
dkato 0:94bcab936677 150 fseek(rd_fp, 0, SEEK_END);
dkato 0:94bcab936677 151 filesize = ftell(rd_fp);
dkato 0:94bcab936677 152 if (filesize > SAMPLE_BUFF_SIZE) {
dkato 0:94bcab936677 153 fclose(wr_fp);
dkato 3:19e5a993ec7d 154 pc.printf("Error:File size over\n");
dkato 0:94bcab936677 155 } else {
dkato 0:94bcab936677 156 led1 = 1;
dkato 0:94bcab936677 157 fseek(rd_fp, 0, SEEK_SET);
dkato 0:94bcab936677 158 fread(&JCUBuffer_INPUT[0], sizeof(char), filesize, rd_fp);
dkato 3:19e5a993ec7d 159 pc.printf("[Encode Mode]\n");
dkato 3:19e5a993ec7d 160 pc.printf("\nOutput file name (.jpg)>");
dkato 0:94bcab936677 161 if (get_file_name(&file_name[FOLD_COUNT], MAX_FILE_NAME_LENGTH) == false) {
dkato 3:19e5a993ec7d 162 pc.printf("Error:Max file name length is %d\n", MAX_FILE_NAME_LENGTH);
dkato 0:94bcab936677 163 fclose(rd_fp);
dkato 0:94bcab936677 164 } else {
dkato 0:94bcab936677 165 //YCbCr setting
dkato 0:94bcab936677 166 aBitmapData.width = SAMPLE_WIDTH;
dkato 0:94bcab936677 167 aBitmapData.height = SAMPLE_HEIGHT;
dkato 0:94bcab936677 168 aBitmapData.format = JPEG_Converter::WR_RD_YCbCr422; //YCbCr[0] & ARGB8888[1] is 4byte, not RGB565[2] is 2byte
dkato 0:94bcab936677 169 aBitmapData.buffer_address = (void *)JCUBuffer_INPUT;
dkato 3:19e5a993ec7d 170 pc.printf("File encode start\n");
dkato 0:94bcab936677 171 // JPEG_Converter
dkato 0:94bcab936677 172 if (decoder.encode(&aBitmapData, JCUBuffer_OUTPUT, &EncodeSize) == JPEG_Converter::JPEG_CONV_OK) {
dkato 3:19e5a993ec7d 173 pc.printf("File encode done %dbyte\n", EncodeSize);
dkato 3:19e5a993ec7d 174 pc.printf("File write start\n");
dkato 0:94bcab936677 175 wr_fp = fopen(file_name, "w");
dkato 0:94bcab936677 176 fwrite(JCUBuffer_OUTPUT, sizeof(char), EncodeSize, wr_fp);
dkato 0:94bcab936677 177
dkato 0:94bcab936677 178 fclose(wr_fp);
dkato 3:19e5a993ec7d 179 pc.printf("File write done\n");
dkato 0:94bcab936677 180 led1 = 0;
dkato 0:94bcab936677 181 } else {
dkato 3:19e5a993ec7d 182 pc.printf("Error:JCU encode error\n");
dkato 0:94bcab936677 183 led1 = 0;
dkato 0:94bcab936677 184 }
dkato 0:94bcab936677 185 }
dkato 0:94bcab936677 186 }
dkato 0:94bcab936677 187 fclose(rd_fp);
dkato 0:94bcab936677 188 }
dkato 0:94bcab936677 189 } else {
dkato 3:19e5a993ec7d 190 pc.printf("Error:Not supported extension (.jpg or .bin)\n");
dkato 0:94bcab936677 191 }
dkato 0:94bcab936677 192 }
dkato 0:94bcab936677 193 }
dkato 0:94bcab936677 194 }